ReportingService2010.CreateReportEditSession Method

Reference

Definition

Namespace:: ReportService2010

Assembly:: ReportService2010.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Creates a new report edit session in the report server database.

public:
 System::String ^ CreateReportEditSession(System::String ^ Report, System::String ^ Parent, cli::array <System::Byte> ^ Definition, [Runtime::InteropServices::Out] cli::array <ReportService2010::Warning ^> ^ % Warnings);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public string CreateReportEditSession (string Report, string Parent, byte[] Definition, out ReportService2010.Warning[] Warnings);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.CreateReportEditSession : string * string * byte[] * Warning[] -> string

Public Function CreateReportEditSession (Report As String, Parent As String, Definition As Byte(), ByRef Warnings As Warning()) As String

Parameters

Report: String

The name of the report with which to associate the edit session.

Parent: String

The path to an item. This can be a folder or a SharePoint library.

Definition: Byte[]

A byte array that contains the report definition language (RDL) of the report associated with the edit session.

Warnings: Warning[]

[out] An array of Warning objects that describes any warnings that occurred during the creation of the report edit session.

Returns

String

A string that identifies the edit session.

Attributes: SoapDocumentMethodAttribute SoapHeaderAttribute

Remarks

The table below shows header and permissions information on this operation.


SOAP Header Usage	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Native Mode Required Permissions	ExecuteReportDefinition AND, depending on the situation: If `Parent` is empty or `null`: No more permission required If `Parent` exists, but `Report` does not exist: CreateReport on `Parent` AND ReadProperties on data sources defined in `Definition` AND ReadProperties on datasets defined in `Definition` If both `Parent` and `Report` exists: same as above AND all of the following permissions on `Report`: ReadDatasource ReadProperties UpdateProperties ReadReportDefinition UpdateReportDefinition ExecuteAndView
SharePoint Mode Required Permissions	Needs the system property `EnableLoadReportDefinition` set to `true` AND, depending on the situation: If `Parent` is empty or `null`: No more permission required If `Parent` exists, but `Report` does not exist: <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> on `Parent` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> on data sources and datasets defined in `Definition` If both `Parent` and `Report` exists: same as above AND all of the following permissions on `Report`: <xref:Microsoft.SharePoint.SPBasePermissions.OpenItems> <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems>

An error occurs if the specified folder or document library does not exist.

If the report specified in the Report parameter does not exist at the specified location, the value of Report sets the Globals!ReportName in the RDL for the edit session.

Call the DeleteItem method to delete the report edit session, passing the EditSessionID as a parameter to the DeleteItem method.

Definition cannot include an expression-based connection string. When it does, the rsInvalidParameterValue is returned by this method.

By default, report edit sessions are set to 7200 seconds (2 hours) from last use, making it possible for users to keep a large amount of data in the cache for a prolonged period of time. In some usage patterns, this could lead to a larger load on the RSTempDB database and the report server. In these cases you should consider using LoadReport.

Applies to

Share via