次の方法で共有


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
    ファイル名と拡張子 (SharePoint モードの場合) を含む、アイテムの完全修飾 URL です。

戻り値

型: System. . :: . .String
スナップショットの日付とタイム スタンプを表す String です。この文字列は、履歴スナップショットの一意の識別子として使用されます。

説明

次の表に、この操作に関連するヘッダーおよび権限の情報を示します。

SOAP ヘッダーの使用方法

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

ネイティブ モードで必要な権限

CreateSnapshot およびExecute

SharePoint モードで必要な権限

EditListItems()()()() およびViewListItems()()()()

スナップショットを正常に生成するためには、そのカタログ アイテムのアイテム履歴を有効にする必要があります。カタログ アイテムのアイテム履歴を有効にするには、SetItemHistoryOptions メソッドを使用します。

レポート アイテムにサブレポートが含まれている場合は、サブレポートからのクエリ結果セットがアイテム履歴スナップショットに保存されます。レポートの実行時にレポートに渡されたレポート パラメーターも保存されます。

このメソッドで作成したスナップショットは、必ず既定のパラメーターを使用したものになります。

ItemPath パラメーターの長さは、260 文字以下でなければなりません。これを超えると、エラー コード rsItemLengthExceeded の SOAP 例外がスローされます。

ItemPath パラメーターを NULL または空の文字列にすることはできません。また、予約文字 : ?; @ & = + $ , \ * > < | ." を含めることもできません。スラッシュ (/) は、フォルダーの完全なパス名内の各項目を区切るために使用することはできますが、フォルダー名の末尾には使用できません。