ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает моментальный снимок журнала элементов указанного элемента каталога. Этот метод применим к элементам типа Report
.
public:
System::String ^ CreateItemHistorySnapshot(System::String ^ ItemPath, [Runtime::InteropServices::Out] cli::array <ReportService2010::Warning ^> ^ % Warnings);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", 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 CreateItemHistorySnapshot (string ItemPath, out ReportService2010.Warning[] Warnings);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateItemHistorySnapshot", 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.CreateItemHistorySnapshot : string * Warning[] -> string
Public Function CreateItemHistorySnapshot (ItemPath As String, ByRef Warnings As Warning()) As String
Параметры
- ItemPath
- String
Полный URL-адрес элемента, включая имя файла, а также (в режиме интеграции с SharePoint) расширение.
- Warnings
- Warning[]
[out] Массив объектов Warning, в котором перечислены предупреждения, полученные во время обработки отчета.
Возвращаемое значение
Значение типа String
, представляющее отметку даты и времени для моментального снимка. Эта строка служит уникальным идентификатором для журнального моментального снимка.
- Атрибуты
Комментарии
В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.
Использование заголовка SOAP | (In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue |
Необходимые разрешения в собственном режиме | CreateSnapshot И Execute |
Необходимые разрешения в режиме Интеграции с SharePoint | <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> И <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Для успешного создания snapshot необходимо включить журнал элементов для элемента категории. Чтобы включить журнал элементов для элемента каталога, используйте SetItemHistoryOptions метод .
Если элемент отчета содержит вложенные отчеты, результирующие наборы запросов из вложенных отчетов сохраняются в журнале элементов snapshot. Параметры отчета, которые передаются в отчет во время выполнения отчета, также сохраняются.
Моментальные снимки создаются этим методом только с параметрами по умолчанию.
Длина ItemPath
параметра не может превышать 260 символов. В противном случае создается исключение SOAP с кодом ошибки rsItemLengthExceeded.
Параметр ItemPath
не может быть пустым или пустым или содержать следующие зарезервированные символы: : ? ; @ & = + $ , \ * > < | . "
. Символ косой черты (/) можно использовать для разделения элементов в полном пути к папке, но его нельзя использовать в конце имени папки.