ReportingService2005.CreateReportHistorySnapshot(String, Warning[]) Method

Definition

生成指定报表的报表历史记录快照。Generates a report history snapshot of a specified report.

public:
 System::String ^ CreateReportHistorySnapshot(System::String ^ Report, [Runtime::InteropServices::Out] cli::array <ReportService2005::Warning ^> ^ % Warnings);
public string CreateReportHistorySnapshot (string Report, out ReportService2005.Warning[] Warnings);
member this.CreateReportHistorySnapshot : string * Warning[] -> string
Public Function CreateReportHistorySnapshot (Report As String, ByRef Warnings As Warning()) As String

Parameters

Report
String

报表的完全限定 URL。The fully qualified URL of the report.

Warnings
Warning[]

[out] Warning 对象的数组,它列出在报表处理过程中出现的警告。[out] An array of Warning objects that lists warnings that occurred during report processing.

Returns

String

一个表示快照的日期和时间戳的StringA String that represents the date and time stamp of the snapshot. 此字符串用作历史快照的唯一标识符。This string is used as a unique identifier for the historical snapshot.

Remarks

下表显示了有关此操作的标头和权限信息。The table below shows header and permissions information on this operation.

SOAP 标头SOAP Headers (In) BatchHeaderValue(In) BatchHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
所需的权限Required Permissions CreateSnapshotExecuteCreateSnapshot AND Execute

若要成功生成快照,必须为报表启用报表历史记录。For the snapshot to be generated successfully, report history must be enabled for the report. 若要为报表启用报表历史记录,请使用 SetReportHistoryOptions 方法。To enable report history for a report, use the SetReportHistoryOptions method. 有关报表历史记录的详细信息,请参阅 管理报表历史记录For more information about report history, see Managing Report History.

如果报表包含子报表,则子报表中的查询结果集将保留在报表历史记录快照中。If the report contains subreports, query result sets from the subreports are persisted in the report history snapshot. 还将保留在执行报表时传递给报表的报表参数。Report parameters that are passed to the report at the time the report is executed are also persisted.

CreateReportHistorySnapshot仅使用默认报表参数创建快照。Snapshots are created by the CreateReportHistorySnapshot method with default report parameters only. 如果需要使用不同的参数配置文件来创建报表历史记录快照,请将链接报表用于 CreateReportHistorySnapshotIf you need to create report history snapshots with different parameter profiles, then use linked reports with CreateReportHistorySnapshot.

参数的长度 Report 不能超过260个字符; 否则,将引发带有错误代码 RSITEMLENGTHEXCEEDED 的 SOAP 异常。The length of the Report parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.

Report参数不能为 null 或为空,也不能包含以下保留字符: : ? ; @ & = + $ , \ * > < | . "The Report 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.

Applies to