ReportingService2010.CreateSubscription Yöntemi

Belirtilen öğe için bir abonelik oluşturur rapor sunucusu veritabanı veya SharePoint Kitaplığı.Bu yöntem uygulandığı raporu öğe türü.

Ad Alanı:  ReportService2010
Derleme:  ReportService2010 (ReportService2010 içinde.dll)

Sözdizimi

'Bildirim
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateSubscription", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
Public Function CreateSubscription ( _
    ItemPath As String, _
    ExtensionSettings As ExtensionSettings, _
    Description As String, _
    EventType As String, _
    MatchData As String, _
    Parameters As ParameterValue() _
) As String
'Kullanım
Dim instance As ReportingService2010
Dim ItemPath As String
Dim ExtensionSettings As ExtensionSettings
Dim Description As String
Dim EventType As String
Dim MatchData As String
Dim Parameters As ParameterValue()
Dim returnValue As String

returnValue = instance.CreateSubscription(ItemPath, _
    ExtensionSettings, Description, _
    EventType, MatchData, Parameters)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateSubscription", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
public string CreateSubscription(
    string ItemPath,
    ExtensionSettings ExtensionSettings,
    string Description,
    string EventType,
    string MatchData,
    ParameterValue[] Parameters
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateSubscription", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
public:
String^ CreateSubscription(
    String^ ItemPath, 
    ExtensionSettings^ ExtensionSettings, 
    String^ Description, 
    String^ EventType, 
    String^ MatchData, 
    array<ParameterValue^>^ Parameters
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateSubscription", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
member CreateSubscription : 
        ItemPath:string * 
        ExtensionSettings:ExtensionSettings * 
        Description:string * 
        EventType:string * 
        MatchData:string * 
        Parameters:ParameterValue[] -> string 

public function CreateSubscription(
    ItemPath : String, 
    ExtensionSettings : ExtensionSettings, 
    Description : String, 
    EventType : String, 
    MatchData : String, 
    Parameters : ParameterValue[]
) : String

Parametreler

• ItemPath
  Tür: System.String
  Dosya adı da dahil olmak üzere öğe ve SharePoint modunda, uzantının tam url.

• ExtensionSettings
  Tür: ReportService2010.ExtensionSettings
  Bir ExtensionSettings özgü olan ayarların bir listesini içeren bir nesne teslim uzantısı.

• Description
  Tür: System.String
  Kullanıcılara görüntülenen anlamlı bir açıklama.

• EventType
  Tür: System.String
  Abonelik tetikleyen olay türü.Geçerli değerler TimedSubscription veya SnapshotUpdated.

• MatchData
  Tür: System.String
  Belirtilen ile ilişkili verileri EventType parametresi.Bu parametre, bir olay, abonelik harekete bir olayla eşleştirmek için kullanılır.

• Parameters
  Tür: array<ReportService2010.ParameterValue[]
  Bir dizi ParameterValue için öğe parametreleri listesini içeren nesneleri

Dönüş Değeri

Tür: System.String
rapor sunucusu veritabanı veya SharePoint kitaplığı aboneliği benzersiz şekilde tanımlayan bir abonelik kimliği.

Açıklamalar

Aşağıdaki tablo üstbilgi ve izinler bu işlemi gösterir.

soap üstbilgisi kullanımı	(De)TrustedUserHeaderValue (Giden)ServerInfoHeaderValue
Yerel mod gerekli izinleri	ExecuteAndViewAND (CreateAnySubscription OR CreateSubscription)
SharePoint modu gerekli izinleri	ViewListItems()AND (ManageAlerts() OR CreateAlerts())

Kullanabileceğiniz GetExtensionSettings yöntem için gerekli ayarların bir listesini almak içinbir teslim uzantısı.Bu gerekli ayarları için değerleri geçmesi gereken ExtensionSettings parametresi.E-posta teslimi ayarları hakkında daha fazla bilgi için bkz: Raporlama Hizmetleri teslim uzantısı ayarları.

Değeri EventType parametresi gerekir için yapılandırılmış bir olaya karşılık gelen rapor sunucusu.Abonelikleri oluşturmak için kullanılan iki olayların TimedSubscription ve SnapshotUpdated.Use ListEvents yöntem için rapor sunucusu yapılandırılmış tüm olayların bir listesini döndürmek için

Değeri MatchData parametresi bağlıdır olay türü.Olay ise, bir TimedSubscription olay, bir ScheduleDefinition nesnesi olarak gerekli MatchData parametresi.Seri hale, ilk getirmek gerekir ScheduleDefinition Nesne bir dize değeri olarak geçirmek ve esas Abonelik oluşturmak için xml olarakzamanlama.Aşağıdaki örnekte, bir xml yapısı benzer:

<ScheduleDefinition>
   <WeeklyRecurrence>
      <StartDateTime>2004-06-24T09:00:00-08:00</StartDateTime>
      <WeeksInterval>1</WeeksInterval>
      <DaysOfWeek>
         <Monday>True</Monday>
         </DaysOfWeek>
   </WeeklyRecurrence>
</ScheduleDefinition>

Değeri StartDateTime bir xml olarak iletildiğinde öğesi dize ISO 8601 tarih biçimine karşılık gelmelidir.Bu uluslararası tarih ve saat genişletilmiş standart yyyy biçimi-mm-DDThh:mm:ss z +/-burada "cc" "yy" yüzyýlý simgeler, Yıl, "mm" ay ve "Gg" gün."t" harfi Tarih ve saat ayracı ve "ss", "mm", "ss" olduğunu saat, dakika ve saniye temsil sırasıyla.Bu gösterim hemen bir "z" izlenebilir Eşgüdümlü evrensel saat (utc) göstermek için.Eşgüdümlü Evrensel Saat, "z" ve yerel saat arasındaki farkı olarak gösterilen saat dilimini belirtmek için tarafından öncesinde bir "+" veya "-" ss: dd temsil edilen utc Farkı arkasından işareti.

Varsa zamanlamayı tanımı için bir TimedSubscription paylaşılan bir zamanlama. paylaşılan zamanlama zamanlama kimliği geçmesi gereken MatchData parametresi.Kimliği olarak geçirdi zamanlama bir dize, örneğin, "4608ac1b-fc75-4149-9e15-5a8b5781b843".Zamanlama kimliği elde edilebilir çağırarak ListSchedules yöntem.

Kullanabileceğiniz XmlSerializer , nesne sınıfı bir xml biçimine dönüştürmek için sınıf dize otomatik olarak.

Olay ise, bir SnapshotUpdated abonelik, değeri MatchData olması gereken nullnull başvuru (Visual Basic'te Nothing) (veya hiçbir şey Visual Basic).

Bu yöntem kullanıldığında, küme LastExecuted için raporun özellik yok, Status için abonelik özelliği Yeni Abonelikve Active için abonelik özelliği doğru.ModifiedBy Ve ModifiedDate rapor özelliklerini de güncelleştirildi.

Belirtilen herhangi bir zamanlama MatchData parametresi, aynı sitede olmalıdır ve ItemPath.

Örnekler

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;

        string report = "http://<Server Name>" +
            "/Docs/Documents/AdventureWorks Sample Reports" +
            "/Sales Order Detail.rdl";
        string desc = "Send to Document Library";
        string eventType = "TimedSubscription";
        string scheduleXml =
           @"<ScheduleDefinition>" +
            "   <StartDateTime>2003-02-24T09:00:00-08:00" +
            "   </StartDateTime>" +
            "   <WeeklyRecurrence>" +
            "      <WeeksInterval>1</WeeksInterval>" +
            "      <DaysOfWeek>" +
            "         <Monday>True</Monday>" +
            "      </DaysOfWeek>" +
            "   </WeeklyRecurrence>" +
            "</ScheduleDefinition>";

        ParameterValue[] extensionParams = new ParameterValue[6];

        extensionParams[0] = new ParameterValue();
        extensionParams[0].Name = "RENDER_FORMAT";
        extensionParams[0].Value = "EXCEL";

        extensionParams[1] = new ParameterValue();
        extensionParams[1].Name = "FILENAME";
        extensionParams[1].Value = "Sales Order Detail";

        extensionParams[2] = new ParameterValue();
        extensionParams[2].Name = "FILEEXTN";
        extensionParams[2].Value = "True";

        extensionParams[3] = new ParameterValue();
        extensionParams[3].Name = "PATH";
        extensionParams[3].Value = "http://<Server Name>" +
            "/Docs/Documents/AdventureWorks Sample Reports/";

        extensionParams[4] = new ParameterValue();
        extensionParams[4].Name = "WRITEMODE";
        extensionParams[4].Value = "Overwrite";

        extensionParams[5] = new ParameterValue();
        extensionParams[5].Name = "AUTOCOPY";
        extensionParams[5].Value = "False";

        string matchData = scheduleXml;
        ExtensionSettings extSettings = new ExtensionSettings();
        extSettings.ParameterValues = extensionParams;
        extSettings.Extension = "Report Server DocumentLibrary";

        try
        {
            rs.CreateSubscription(report, extSettings, desc, 
                eventType, matchData, null);
        }

        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 report As String = "http://<Server Name>/Docs/" + _
            "Documents/AdventureWorks Sample Reports/" + _
            "Sales Order Detail.rdl"
        Dim desc As String = "Send to Document Library"
        Dim eventType As String = "TimedSubscription"
        Dim scheduleXml As String = _
            "<ScheduleDefinition>" + _
            "   <StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>" + _
            "   <WeeklyRecurrence>" + _
            "      <WeeksInterval>1</WeeksInterval>" + _
            "      <DaysOfWeek>" + _
            "         <Monday>True</Monday>" + _
            "      </DaysOfWeek>" + _
            "   </WeeklyRecurrence>" + _
            "</ScheduleDefinition>"

        Dim extensionParams(6) As ParameterValue

        extensionParams(0) = New ParameterValue()
        extensionParams(0).Name = "RENDER_FORMAT"
        extensionParams(0).Value = "EXCEL"

        extensionParams(1) = New ParameterValue()
        extensionParams(1).Name = "FILENAME"
        extensionParams(1).Value = "Sales Order Detail"

        extensionParams(2) = New ParameterValue()
        extensionParams(2).Name = "FILEEXTN"
        extensionParams(2).Value = "True"

        extensionParams(3) = New ParameterValue()
        extensionParams(3).Name = "PATH"
        extensionParams(3).Value = "http://<Server Name>" + _
            "/Docs/Documents/AdventureWorks Sample Reports/"

        extensionParams(4) = New ParameterValue()
        extensionParams(4).Name = "WRITEMODE"
        extensionParams(4).Value = "Overwrite"

        extensionParams(5) = New ParameterValue()
        extensionParams(5).Name = "AUTOCOPY"
        extensionParams(5).Value = "False"

        Dim matchData As String = scheduleXml
        Dim extSettings As New ExtensionSettings()
        extSettings.ParameterValues = extensionParams
        extSettings.Extension = "Report Server DocumentLibrary"

        Try
            rs.CreateSubscription(report, extSettings, desc, _
                eventType, matchData, Nothing)
        Catch e As SoapException
            Console.WriteLine(e.Detail.InnerXml.ToString())
        End Try

    End Sub

End Class

Ayrıca bkz.

Başvuru

ReportingService2010 Sınıf

ReportService2010 Ad Alanı