ReportingService2010.CreateItemHistorySnapshot(String, Warning[]) Méthode

Définition

Espace de noms:

ReportService2010

Assembly:

ReportService2010.dll

Génère un instantané d'historique d'élément d'un élément de catalogue spécifié. Cette méthode s'applique au type d'élément de 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

Paramètres

ItemPath

String

URL complète de l'élément, y compris le nom du fichier et, en mode SharePoint, l'extension.

Warnings

Warning[]

[out] Tableau d'objets Warning qui répertorie les avertissements qui ont été rencontrés pendant le traitement du rapport.

Retours

String

String qui représente la date et l'heure de l'instantané. Cette chaîne est utilisée en tant d'identificateur unique pour l'instantané d'historique.

Attributs

SoapDocumentMethodAttribute SoapHeaderAttribute

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.

Utilisation de l’en-tête SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorisations requises en mode natif	CreateSnapshot AND Execute
Mode SharePoint Autorisations requises	<xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Pour que la instantané soit générée correctement, l’historique des éléments doit être activé pour l’élément de catélog. Pour activer l’historique des éléments pour un élément de catalogue, utilisez la SetItemHistoryOptions méthode .

Si un élément de rapport contient des sous-rapports, les jeux de résultats de requête des sous-rapports sont conservés dans l’historique des éléments instantané. Les paramètres de rapport qui sont passés au rapport au moment de l’exécution du rapport sont également conservés.

Les instantanés sont créés par cette méthode avec les paramètres par défaut uniquement.

La longueur du ItemPath paramètre ne peut pas dépasser 260 caractères ; sinon, une exception SOAP est levée avec le code d’erreur rsItemLengthExceeded.

Le ItemPath paramètre ne peut pas être null ou vide ou contenir les caractères réservés suivants : : ? ; @ & = + $ , \ * > < | . ". Vous pouvez utiliser la barre oblique (/) pour séparer les éléments dans le nom complet du chemin d’accès du dossier, mais vous ne pouvez pas l’utiliser à la fin du nom du dossier.