ReportingService2010.CreateCatalogItem Méthode

Référence

Définition

Espace de noms:: ReportService2010

Assembly:: ReportService2010.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un nouvel élément à une base de données du serveur de rapports ou à la bibliothèque SharePoint. Cette méthode s'applique aux types d'élément Report, Model, Dataset, Component, Resource et DataSource.

public:
 ReportService2010::CatalogItem ^ CreateCatalogItem(System::String ^ ItemType, System::String ^ Name, System::String ^ Parent, bool Overwrite, cli::array <System::Byte> ^ Definition, cli::array <ReportService2010::Property ^> ^ Properties, [Runtime::InteropServices::Out] cli::array <ReportService2010::Warning ^> ^ % Warnings);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateCatalogItem", 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("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.CatalogItem CreateCatalogItem (string ItemType, string Name, string Parent, bool Overwrite, byte[] Definition, ReportService2010.Property[] Properties, out ReportService2010.Warning[] Warnings);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateCatalogItem", 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("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.CreateCatalogItem : string * string * string * bool * byte[] * ReportService2010.Property[] * Warning[] -> ReportService2010.CatalogItem

Public Function CreateCatalogItem (ItemType As String, Name As String, Parent As String, Overwrite As Boolean, Definition As Byte(), Properties As Property(), ByRef Warnings As Warning()) As CatalogItem

Paramètres

ItemType: String

Type d'élément.

Name: String

Nom du nouvel élément, y compris l'extension de fichier en mode SharePoint.

Parent: String

URL complète du dossier parent qui contiendra l'élément.

Overwrite: Boolean

Expression de type Boolean qui indique si un élément existant portant le même nom dans l'emplacement spécifié doit être remplacé.

Definition: Byte[]

Définition de rapport .rdl, définition de modèle de rapport ou contenu de ressource à publier sur le serveur de rapports.

Properties: Property[]

Tableau d'objets Property qui contient les noms et valeurs des propriétés à définir pour l'élément.

Warnings: Warning[]

[out] Tableau d'objets Warning qui décrit les avertissements qui ont été rencontrés pendant la validation de la définition de l'élément.

Retours

CatalogItem

Objet CatalogItem pour l'élément nouvellement créé.

Attributs: SoapDocumentMethodAttribute SoapHeaderAttribute

Exemples

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  

class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2010 rs = new ReportingService2010();  
        rs.Url = "http://<Server Name>" +  
            "/_vti_bin/ReportServer/ReportService2010.asmx";  
        rs.Credentials =   
            System.Net.CredentialCache.DefaultCredentials;  

        Byte[] definition = null;  
        Warning[] warnings = null;  
        string name = "MyReport.rdl";  

        try  
        {  
            FileStream stream = File.OpenRead("MyReport.rdl");  
            definition = new Byte[stream.Length];  
            stream.Read(definition, 0, (int)stream.Length);  
            stream.Close();  
        }  
        catch (IOException e)  
        {  
            Console.WriteLine(e.Message);  
        }  

        try  
        {  
            string parent = "http://<Server Name>/Docs/Documents/";  
            CatalogItem report = rs.CreateCatalogItem("Report", name, parent,  
                        false, definition, null, out warnings);  

            if (warnings != null)  
            {  
                foreach (Warning warning in warnings)  
                {  
                    Console.WriteLine(warning.Message);  
                }  
            }  

            else  
                Console.WriteLine("Report: {0} created successfully " +  
                                  " with no warnings", name);  
        }  
        catch (SoapException e)  
        {  
            Console.WriteLine(e.Detail.InnerXml.ToString());  
        }  
    }  
}

Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  

Class Sample  

    Public Shared Sub Main()  

        Dim rs As New ReportingService2010()  
        rs.Url = "http://<Server Name>" + _  
            "/_vti_bin/ReportServer/ReportService2010.asmx"  
        rs.Credentials = _  
            System.Net.CredentialCache.DefaultCredentials  

        Dim definition As [Byte]() = Nothing  
        Dim warnings As Warning() = Nothing  
        Dim name As String = "MyReport.rdl"  

        Try  
            Dim stream As FileStream = File.OpenRead("MyReport.rdl")  
            definition = New [Byte](stream.Length - 1) {}  
            stream.Read(definition, 0, CInt(stream.Length))  
            stream.Close()  

        Catch e As IOException  
            Console.WriteLine(e.Message)  
        End Try  

        Try  
            Dim parentPath As String = _  
                "http://<Server Name>/Docs/Documents/"  
            rs.CreateCatalogItem("Report", name, parentPath, False, _  
                definition, Nothing, warnings)  

            If Not (warnings Is Nothing) Then  
                Dim warning As Warning  
                For Each warning In warnings  
                    Console.WriteLine(warning.Message)  
                Next warning  

            Else  
                Console.WriteLine("Report: {0} created " + _  
                    "successfully with no warnings", name)  
            End If  

        Catch e As SoapException  
            Console.WriteLine(e.Detail.InnerXml.ToString())  
        End Try  

    End Sub  

End Class

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	Dépend du type d’élément : - `Report` Création d’un rapport : CreateReport sur `Parent` ET ReadProperties sur les sources de données du rapport ET ReadProperties sur les jeux de données du rapport Mise à jour d’un rapport existant : UpdateReportDefinition sur (si `Properties` contient des propriétés) AND UpdateProperties sur `Item` ET UpdateProperties sur les sources de données du rapport ET UpdateProperties sur les jeux `Item` de données du rapport - `DataSet` Création d’un jeu de données partagé : CreateReport sur `Parent` AND ReadProperties sur les sources de données du jeu de données Mise à jour d’un jeu de données partagé existant : sur ET sur `Item` (si `Properties` contient des propriétés) ET UpdateProperties sur les sources de données du jeu UpdateProperties de données `Item`UpdateReportDefinition - `Resource`, `Component`: Création d’un élément : CreateResource sur `Parent` Mise à jour d’un élément existant : UpdateContent sur `Item` Mise à jour des propriétés de l’élément : UpdateContent AND UpdateProperties sur `Item` - `DataSource`: Création d’une source de données : CreateDatasource sur `Parent` Mise à jour d’une source de données existante : UpdateContent Mise à jour des propriétés de source de données : UpdateContent AND UpdateProperties - `Model`: CreateModel
Mode SharePoint Autorisations requises	Dépend du type d’élément : - `Report` Création d’un rapport : <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> sur `Parent` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> sur les sources de données et les jeux de données définis dans `Definition` Mise à jour d’un rapport existant : <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> sur `Item` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> sur les sources de données et les jeux de données définis dans `Definition` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> sur `Item` (si `Properties` contient des propriétés) - `DataSet` Création d’un jeu de données partagé : <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> sur `Parent` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> sur les sources de données définies dans `Definition` Mise à jour d’un jeu de données partagé existant : <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> sur `Item` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> sur les sources de données définies dans<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>`Definition`sur `Item` (si `Properties` contient des propriétés) - `Resource`, `DataSource`, `Component`: Création d’un élément : <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> sur `Parent` Mise à jour d’un élément existant : <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> sur `Item` - `Model`: <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> on `Parent`

Cette méthode peut créer des éléments de tous les types d’éléments pris en charge. Pour voir les types d’éléments pris en charge, utilisez la ListItemTypes méthode .

Le Model type d’élément ne peut pas être remplacé. Par conséquent, le Overwrite paramètre doit être False si ItemType est Model. Sinon, une exception rsInvalidParameterCombination est levée.

Si ItemType a la valeur Report, les données XML sont définies par le langage de définition de rapport. Si ItemType a la valeur Model, les données XML sont définies par le langage de définition de modèle sémantique.

Si des erreurs se produisent, l’élément n’est pas créé.

L’ajout d’un élément à une base de données de serveur de rapports ou à une bibliothèque SharePoint modifie les ModifiedBy propriétés et ModifiedDate du dossier parent.

Si l’extension de nom de fichier applicable (par exemple, .rdl) est exclue du nom de l’élément, une rsFileExtensionRequired erreur est retournée.

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

Le Parent 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.

S’applique à

Partager via