Partager via


ReportingService2010.CreateCatalogItem Méthode

Définition

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

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

Attributs

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 ItemUpdateReportDefinition
- 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>Definitionsur 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 à