Статья
04/01/2012

Метод CreateItemHistorySnapshot

Создает моментальный снимок журнала элементов указанного элемента каталога. Этот метод применим к элементам типа Report.

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

Синтаксис

'Декларация
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", 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)> _
Public Function CreateItemHistorySnapshot ( _
    ItemPath As String, _
    <OutAttribute> ByRef Warnings As Warning() _
) As String
'Применение
Dim instance As ReportingService2010
Dim ItemPath As String
Dim Warnings As Warning()
Dim returnValue As String

returnValue = instance.CreateItemHistorySnapshot(ItemPath, _
    Warnings)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", 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)]
public string CreateItemHistorySnapshot(
    string ItemPath,
    out Warning[] Warnings
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", 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)]
public:
String^ CreateItemHistorySnapshot(
    String^ ItemPath, 
    [OutAttribute] array<Warning^>^% Warnings
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", 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)>]
member CreateItemHistorySnapshot : 
        ItemPath:string * 
        Warnings:Warning[] byref -> string

public function CreateItemHistorySnapshot(
    ItemPath : String, 
    Warnings : Warning[]
) : String

Параметры

ItemPath
Тип: System. . :: . .String
Полный URL-адрес элемента, включая имя файла, а также (в режиме интеграции с SharePoint) расширение.

Warnings
Тип: array<ReportService2010. . :: . .Warning> [] () [] []%
[out] Массив объектов Warning, в котором перечислены предупреждения, полученные во время обработки отчета.

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

Тип: System. . :: . .String
Значение типа String, представляющее отметку даты и времени для моментального снимка. Эта строка служит уникальным идентификатором для журнального моментального снимка.

Замечания

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

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions

CreateSnapshot AND Execute

SharePoint Mode Required Permissions

EditListItems()()()() AND ViewListItems()()()()

For the snapshot to be generated successfully, item history must be enabled for the catelog item. To enable item history for a catalog item, use the SetItemHistoryOptions method.

If a report item contains subreports, query result sets from the subreports are persisted in the item history snapshot. Report parameters that are passed to the report at the time the report is executed are also persisted.

Snapshots are created by this method with default parameters only.

The length of the ItemPath parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

The ItemPath parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.

См. также

Справочник

ReportingService2010 Класс

Пространство имен ReportService2010

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