ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Gera um instantâneo de histórico de item de um item de catálogo especificado. Esse método se aplica ao tipo de item 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
Parâmetros
- ItemPath
- String
A URL totalmente qualificada do item, incluindo o nome do arquivo e a extensão no modo do SharePoint.
- Warnings
- Warning[]
[out] Uma matriz de objetos Warning que lista os avisos ocorridos durante o processamento do relatório.
Retornos
Um valor String
que representa o carimbo de data e hora do instantâneo. Essa cadeia de caracteres é usada como um identificador exclusivo do instantâneo histórico.
- Atributos
Comentários
A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.
Uso do cabeçalho SOAP | (In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue |
Permissões necessárias do modo nativo | CreateSnapshot E Execute |
Permissões necessárias do modo do SharePoint | <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> E <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> |
Para que o instantâneo seja gerado com êxito, o histórico de itens deve ser habilitado para o item de catelog. Para habilitar o histórico de itens para um item de catálogo, use o SetItemHistoryOptions método .
Se um item de relatório contiver sub-relatórios, os conjuntos de resultados de consulta dos sub-relatórios serão persistidos no histórico de itens instantâneo. Os parâmetros de relatório que são passados para o relatório no momento em que o relatório é executado também são persistidos.
Instantâneos são criados por esse método apenas com parâmetros padrão.
O comprimento do ItemPath
parâmetro não pode exceder 260 caracteres; caso contrário, uma exceção SOAP é gerada com o código de erro rsItemLengthExceeded.
O ItemPath
parâmetro não pode ser nulo ou vazio ou conter os seguintes caracteres reservados: : ? ; @ & = + $ , \ * > < | . "
. Você pode usar o caractere de barra (/) para separar itens no nome do caminho completo da pasta, mas não pode usá-lo no final do nome da pasta.