ReportingService2010.CreateCatalogItem Metode

Referensi

Definisi

Ruang nama:: ReportService2010

Rakitan:: ReportService2010.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan item baru ke database server laporan atau pustaka SharePoint. Metode ini berlaku untuk Reportjenis item , , DatasetModel, Component, Resourcedan 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

Parameter

ItemType: String

Jenis item.

Name: String

Nama item baru, termasuk ekstensi file dalam mode SharePoint.

Parent: String

URL yang sepenuhnya memenuhi syarat untuk folder induk yang akan berisi item.

Overwrite: Boolean

Boolean Ekspresi yang menunjukkan apakah item yang sudah ada yang memiliki nama yang sama di lokasi yang ditentukan harus ditimpa.

Definition: Byte[]

Definisi laporan .rdl, definisi model laporan, atau konten sumber daya untuk diterbitkan ke server laporan.

Properties: Property[]

Array Property objek yang berisi nama dan nilai properti yang akan diatur untuk item.

Warnings: Warning[]

[keluar] Array Warning objek yang menjelaskan peringatan apa pun yang terjadi saat item divalidasi.

Mengembalikan

CatalogItem

Objek CatalogItem untuk item yang baru dibuat.

Atribut: SoapDocumentMethodAttribute SoapHeaderAttribute

Contoh

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

Keterangan

Tabel di bawah ini memperlihatkan informasi header dan izin pada operasi ini.


Penggunaan Header SOAP	(Dalam) TrustedUserHeaderValue (Keluar) ServerInfoHeaderValue
Izin Yang Diperlukan Mode Asli	Bergantung pada jenis item: - `Report` Membuat laporan baru: CreateReport pada `Parent` AND ReadProperties pada sumber data laporan DAN ReadProperties pada himpunan data laporan Memperbarui laporan yang sudah ada: UpdateReportDefinition pada (jika `Properties` berisi properti) DAN UpdateProperties di `Item` AND UpdateProperties pada sumber data laporan DAN UpdateProperties pada himpunan `Item` data laporan - `DataSet` Membuat himpunan data bersama baru: CreateReport di `Parent` AND ReadProperties pada sumber data himpunan data Memperbarui himpunan data bersama yang sudah ada: UpdateReportDefinition di AND UpdateProperties pada `ItemItem` (jika `Properties` berisi properti) AND UpdateProperties pada sumber data himpunan data - `Resource`, `Component`: Membuat item baru: CreateResource pada `Parent` Memperbarui item yang sudah ada: UpdateContent pada `Item` Memperbarui properti item: UpdateContent DAN UpdateProperties aktif `Item` - `DataSource`: Membuat sumber data baru: CreateDatasource pada `Parent` Memperbarui sumber data yang sudah ada: UpdateContent Memperbarui properti sumber data: UpdateContent AND UpdateProperties - `Model`: CreateModel
Izin yang Diperlukan Mode SharePoint	Bergantung pada jenis item: - `Report` Membuat laporan baru: <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> pada `Parent` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> pada sumber data dan himpunan data yang ditentukan dalam `Definition` Memperbarui laporan yang ada: <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> pada `Item` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> pada sumber data dan himpunan data yang ditentukan dalam `Definition` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> aktif `Item` (jika `Properties` berisi properti) - `DataSet` Membuat himpunan data bersama baru: <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> pada `Parent` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> pada sumber data yang ditentukan dalam `Definition` Memperbarui himpunan data bersama yang ada: <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> pada `Item` AND <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems> pada sumber data yang ditentukan di<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>`Definition`(`Item`jika `Properties` berisi properti) - `Resource`, `DataSource`, `Component`: Membuat item baru: <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> pada `Parent` Memperbarui item yang sudah ada: <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> pada `Item` - `Model`: <xref:Microsoft.SharePoint.SPBasePermissions.AddListItems> pada `Parent`

Metode ini dapat membuat item dari semua jenis item yang didukung. Untuk melihat jenis item apa yang didukung, gunakan ListItemTypes metode .

Tipe Model item tidak dapat ditimpa. Oleh karena itu, Overwrite parameter harus False jika ItemType adalah Model. Jika tidak, pengecualian rsInvalidParameterCombination dilemparkan.

Jika ItemType adalah Report, maka data XML ditentukan oleh Bahasa Definisi Laporan. Jika ItemType adalah Model, maka data XML ditentukan oleh Bahasa Definisi Model Semantik.

Jika terjadi kesalahan, item tidak dibuat.

Menambahkan item ke database server laporan atau pustaka SharePoint memodifikasi ModifiedBy properti dan ModifiedDate folder induk.

Jika ekstensi nama file yang berlaku (misalnya, .rdl) dikecualikan dari nama item, kesalahan rsFileExtensionRequired akan dikembalikan.

Panjang Parent parameter tidak boleh melebihi 260 karakter; jika tidak, pengecualian SOAP dilemparkan dengan kode kesalahan rsItemLengthExceeded.

Parameter Parent tidak boleh null atau kosong atau berisi karakter khusus berikut: : ? ; @ & = + $ , \ * > < | . ". Anda dapat menggunakan karakter garis miring (/) untuk memisahkan item dalam nama jalur lengkap folder, tetapi Anda tidak dapat menggunakannya di akhir nama folder.

Berlaku untuk

Bagikan melalui