Поделиться через

  • Статья

Метод CreateReportEditSession

Создает новый сеанс изменения отчета в базе данных сервера отчетов.

Пространство имен:  ReportService2010
Сборка:  ReportService2010 (в ReportService2010.dll)

Синтаксис

'Декларация
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function CreateReportEditSession ( _
    Report As String, _
    Parent As String, _
    Definition As Byte(), _
    <OutAttribute> ByRef Warnings As Warning() _
) As String
'Применение
Dim instance As ReportingService2010
Dim Report As String
Dim Parent As String
Dim Definition As Byte()
Dim Warnings As Warning()
Dim returnValue As String

returnValue = instance.CreateReportEditSession(Report, _
    Parent, Definition, Warnings)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public string CreateReportEditSession(
    string Report,
    string Parent,
    byte[] Definition,
    out Warning[] Warnings
)

[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
String^ CreateReportEditSession(
    String^ Report, 
    String^ Parent, 
    array<unsigned char>^ Definition, 
    [OutAttribute] array<Warning^>^% Warnings
)

[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateReportEditSession", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member CreateReportEditSession : 
        Report:string * 
        Parent:string * 
        Definition:byte[] * 
        Warnings:Warning[] byref -> string 

public function CreateReportEditSession(
    Report : String, 
    Parent : String, 
    Definition : byte[], 
    Warnings : Warning[]
) : String

Параметры

  • Report
    Тип: System. . :: . .String
    Имя отчета, с которым связывается сеанс изменения.
  • Parent
    Тип: System. . :: . .String
    Путь к элементу. Это может быть папка или библиотека SharePoint.
  • Definition
    Тип: array<System. . :: . .Byte> [] () [] []
    Массив байтов, содержащий определение отчета, связанного с сеансом изменения, на языке определения отчетов.
  • Warnings
    Тип: array<ReportService2010. . :: . .Warning> [] () [] []%
    [out] Массив объектов Warning, который описывает все предупреждения, возникшие при создании сеанса изменения отчета.

Возвращаемое значение

Тип: System. . :: . .String
Строка , определяющая сеанс изменения.

Замечания

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:

SharePoint Mode Required Permissions

Needs the system property EnableLoadReportDefinition set to true AND, depending on the situation:

  • If Parent is empty or null Nothing nullptr unit пустая ссылка (Nothing в Visual Basic) : No more permission required

  • If Parent exists, but Report does not exist: AddListItems()()()() on Parent AND 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:

    • OpenItems()()()()

    • ViewListItems()()()()

    • EidListItems()()()()

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.