ReportingService2005.CreateSubscription Yöntemi

Bir abonelik için belirtilen bir rapor oluşturur rapor sunucusu veritabanı.

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

Sözdizimi

'Bildirim
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("BatchHeaderValue")> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/CreateSubscription", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function CreateSubscription ( _
    Report As String, _
    ExtensionSettings As ExtensionSettings, _
    Description As String, _
    EventType As String, _
    MatchData As String, _
    Parameters As ParameterValue() _
) As String
'Kullanım
Dim instance As ReportingService2005
Dim Report 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(Report, _
    ExtensionSettings, Description, _
    EventType, MatchData, Parameters)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapHeaderAttribute("BatchHeaderValue")]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/CreateSubscription", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public string CreateSubscription(
    string Report,
    ExtensionSettings ExtensionSettings,
    string Description,
    string EventType,
    string MatchData,
    ParameterValue[] Parameters
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"BatchHeaderValue")]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/CreateSubscription", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
String^ CreateSubscription(
    String^ Report, 
    ExtensionSettings^ ExtensionSettings, 
    String^ Description, 
    String^ EventType, 
    String^ MatchData, 
    array<ParameterValue^>^ Parameters
)

[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapHeaderAttribute("BatchHeaderValue")>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/CreateSubscription", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member CreateSubscription : 
        Report:string * 
        ExtensionSettings:ExtensionSettings * 
        Description:string * 
        EventType:string * 
        MatchData:string * 
        Parameters:ParameterValue[] -> string 

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

Parametreler

• Report
  Tür: System.String
  Rapor için bir abonelik oluşturmak tam yol adı.

• ExtensionSettings
  Tür: ReportService2005.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<ReportService2005.ParameterValue[]
  Bir dizi ParameterValue için rapor parametreleri listesini içeren nesneleri

Dönüş Değeri

Tür: System.String
İçinde aboneliği benzersiz şekilde tanımlayan bir abonelik kimliği rapor sunucusu veritabanı.

Açıklamalar

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

soap üstbilgileri	(De)BatchHeaderValue (Giden)ServerInfoHeaderValue
Gerekli izinler	ExecuteAndViewAND (CreateAnySubscription OR CreateSubscription)

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.xml yapısı aşağıdaki örnekte benzer görünebilir:

<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 geçirildiğ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" takip edilebilir 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.Hakkında daha fazla bilgi için XmlSerializer sınıf, "System.Xml.XmlSerializer Class" konusuna bakın. Microsoft.net Framework belgeleri.

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 kullanarak LastExecuted için abonelik özellik yok, Status için abonelik özellik Yeni Abonelikve Active için abonelik özellik doğru.ModifiedBy Ve ModifiedDate rapor özelliklerini de güncelleştirildi.

Örnekler

Bu kod örneği derlemek için Raporlama Hizmetleri wsdl başvuran ve belirli ad alanları almak gerekir.Daha fazla bilgi için, bkz. Compiling and Running Code Examples.Aşağıdaki kod örneği CreateSubscription Yeni bir abonelik eklemek için rapor sunucusu veritabanı:

Imports System
Imports System.Web.Services.Protocols

Class Sample
   Public Shared Sub Main()
      Dim rs As New ReportingService2005()
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials

      Dim report As String = "/SampleReports/Employee Sales Summary"
      Dim desc As String = "Send email to anyone@microsoft.com"
      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(7) As ParameterValue

      extensionParams(0) = New ParameterValue()
      extensionParams(0).Name = "TO"
      extensionParams(0).Value = "dank@adventure-works.com"

      extensionParams(1) = New ParameterValue()
      extensionParams(1).Name = "ReplyTo"
      extensionParams(1).Value = "reporting@adventure-works.com"

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

      extensionParams(3) = New ParameterValue()
      extensionParams(3).Name = "RenderFormat"
      extensionParams(3).Value = "MHTML"

      extensionParams(4) = New ParameterValue()
      extensionParams(4).Name = "Subject"
      extensionParams(4).Value = "@ReportName was executed at @ExecutionTime"

      extensionParams(5) = New ParameterValue()
      extensionParams(5).Name = "Comment"
      extensionParams(5).Value = "Here is your daily sales report for Michael."

      extensionParams(6) = New ParameterValue()
      extensionParams(6).Name = "IncludeLink"
      extensionParams(6).Value = "True"

      extensionParams(7) = New ParameterValue()
      extensionParams(7).Name = "Priority"
      extensionParams(7).Value = "NORMAL"

      Dim parameter As New ParameterValue()
      parameter.Name = "EmpID"
      parameter.Value = "38"

      Dim parameters(1) As ParameterValue
      parameters(0) = parameter

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

      Try
         rs.CreateSubscription(report, extSettings, desc, eventType, matchData, parameters)

      Catch e As SoapException
         Console.WriteLine(e.Detail.InnerXml.ToString())
      End Try
   End Sub 'Main
End Class 'Sample

using System;
using System.Web.Services.Protocols;

class Sample
{
   public static void Main()
   {
      ReportingService2005 rs = new ReportingService2005();
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;

      string report = "/SampleReports/Employee Sales Summary";
      string desc = "Send email to anyone@microsoft.com";
      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[8];

      extensionParams[0] = new ParameterValue();
      extensionParams[0].Name = "TO";
      extensionParams[0].Value = "dank@adventure-works.com";

      extensionParams[1] = new ParameterValue();
      extensionParams[1].Name = "ReplyTo";
      extensionParams[1].Value = "reporting@adventure-works.com";

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

      extensionParams[3] = new ParameterValue();
      extensionParams[3].Name = "RenderFormat";
      extensionParams[3].Value = "MHTML";

      extensionParams[4] = new ParameterValue();
      extensionParams[4].Name = "Subject";
      extensionParams[4].Value = "@ReportName was executed at @ExecutionTime";

      extensionParams[5] = new ParameterValue();
      extensionParams[5].Name = "Comment";
      extensionParams[5].Value = "Here is your daily sales report for Michael.";

      extensionParams[6] = new ParameterValue();
      extensionParams[6].Name = "IncludeLink";
      extensionParams[6].Value = "True";

      extensionParams[7] = new ParameterValue();
      extensionParams[7].Name = "Priority";
      extensionParams[7].Value = "NORMAL";

      ParameterValue parameter = new ParameterValue();
      parameter.Name = "EmpID";
      parameter.Value = "38";

      ParameterValue[] parameters = new ParameterValue[1];
      parameters[0] = parameter;

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

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

      catch (SoapException e)
      {
         Console.WriteLine(e.Detail.InnerXml.ToString());
      }
   }
}

Ayrıca bkz.

Başvuru

ReportingService2005 Sınıf

ReportService2005 Ad Alanı