ReportingService2005.SetDataDrivenSubscriptionProperties Methode

Definition

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Legt die Eigenschaften eines datengesteuerten Abonnements fest.

public:
 void SetDataDrivenSubscriptionProperties(System::String ^ DataDrivenSubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, ReportService2005::DataRetrievalPlan ^ DataRetrievalPlan, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValueOrFieldReference ^> ^ Parameters);

public void SetDataDrivenSubscriptionProperties (string DataDrivenSubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, ReportService2005.DataRetrievalPlan DataRetrievalPlan, string Description, string EventType, string MatchData, ReportService2005.ParameterValueOrFieldReference[] Parameters);

member this.SetDataDrivenSubscriptionProperties : string * ReportService2005.ExtensionSettings * ReportService2005.DataRetrievalPlan * string * string * string * ReportService2005.ParameterValueOrFieldReference[] -> unit

Public Sub SetDataDrivenSubscriptionProperties (DataDrivenSubscriptionID As String, ExtensionSettings As ExtensionSettings, DataRetrievalPlan As DataRetrievalPlan, Description As String, EventType As String, MatchData As String, Parameters As ParameterValueOrFieldReference())

Parameter

DataDrivenSubscriptionID

String

Die ID des Abonnements, die von der CreateDataDrivenSubscription(String, ExtensionSettings, DataRetrievalPlan, String, String, String, ParameterValueOrFieldReference[])-Methode zurückgegeben wird.

ExtensionSettings

ExtensionSettings

Ein ExtensionSettings-Objekt mit einer Liste von Einstellungen, die für die Übermittlungserweiterung spezifisch sind.

DataRetrievalPlan

DataRetrievalPlan

Ein DataRetrievalPlan-Objekt, das eine Liste von Einstellungen enthält, die zum Abrufen von Daten aus der Übermittlungsabfrage für das Abonnement erforderlich sind.

Description

String

Eine aussagekräftige Beschreibung, die Benutzern angezeigt wird.

EventType

String

Der Typ des Ereignisses, das das Abonnement auslöst. Die gültigen Werte sind TimedSubscription oder SnapshotUpdated.

MatchData

String

Die Daten, die dem angegebenen Ereignistyp zugeordnet sind. Diese Daten werden von einer Erweiterung zur Ergeignisverarbeitung verwendet, um das Abonnement mit einem ausgelösten Ereignis zu vergleichen.

Parameters

ParameterValueOrFieldReference[]

Ein Array von ParameterValue-Objekten, das eine Liste der Parameter für den Bericht enthält.

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.

SOAP-Header	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen	UpdateAnySubscription

Damit das datengesteuerte Abonnement ordnungsgemäß ausgeführt wird, muss für die Datenquelle, auf die das DataRetrievalPlan Objekt verweist, eine CredentialRetrieval -Eigenschaft auf Storefestgelegt sein.

Die Field in DataSet enthaltenen Objekte werden anhand der Felder überprüft, die den Einstellungen der Übermittlungserweiterung und berichtsparameterwerten zugeordnet sind. Alle Felder, auf die in Übermittlungserweiterungseinstellungen und Berichtsparameterwerten verwiesen wird, müssen auch im Dataset aufgelistet werden.

Es wird keine Überprüfung durchgeführt, um sicherzustellen, dass felder, die im Dataset aufgelistet sind, von der Übermittlungsabfrage zurückgegeben werden. Wenn ein Feld, das im Dataset aufgelistet ist, von der Übermittlungsabfrage nicht zurückgegeben wird, löst der Berichtsserver einen Fehler aus, wenn das Abonnement verarbeitet wird.

Der Wert des EventType Parameters muss einer Ereignisverarbeitungserweiterung entsprechen, die auf dem Berichtsserver konfiguriert ist. Wenn ein Ereignis nicht von einer Ereignisverarbeitungserweiterung behandelt wird, wird eine SOAP-Ausnahme mit dem Fehlercode rsInvalidEventausgelöst. Das Ereignis muss von einer Ereignisverarbeitungserweiterung behandelt werden, die Benachrichtigungen erstellt. Wenn ein Wert für den EventType Parameter empfangen wird, wird die Ereignisverarbeitungserweiterung abgefragt, um zu bestimmen, ob sie Benachrichtigungen erstellt. Andernfalls wird eine SOAP-Ausnahme mit dem Fehlercode rsEventNonSubscribeableausgelöst.

Der Wert des MatchData Parameters hängt vom Ereignistyp ab. Wenn es sich bei dem Ereignis um ein TimedSubscription-Ereignis handelt, ist ein ScheduleDefinition -Objekt als MatchData Parameter erforderlich. Sie müssen das ScheduleDefinition Objekt zuerst als XML serialisieren, um es als Zeichenfolgenwert zu übergeben, und ein Abonnement basierend auf dem Zeitplan erstellen. Die XML-Struktur könnte wie im folgenden Beispiel aussehen:

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

Der Wert des StartDateTime-Elements , wenn er als XML-Zeichenfolge übergeben wird, sollte dem Datumsformat ISO 8601 entsprechen. Dieser internationale Datums- und Uhrzeitstandard ist das erweiterte Format CCJJ-MM-TTThh:mm:ss+/-Z, wobei "CC" das Jahrhundert, "JJ" das Jahr, "MM" den Monat und "TT" den Tag darstellt. Der Buchstabe "T" ist das Datums- und Uhrzeittrennzeichen, und "hh", "mm", "ss" stellen Stunde, Minute und Sekunde dar. Dieser Darstellung kann unmittelbar ein "Z" folgen, um die koordinierte Weltzeit (UTC) anzugeben. Um die Zeitzone anzugeben, die als Differenz zwischen der lokalen Zeit und der koordinierten Weltzeit dargestellt wird, wird "Z" ein "+"- oder "-"-Zeichen vorangestellt, gefolgt von der Differenz von UTC, die als hh:mm dargestellt wird.

Wenn die Zeitplandefinition für eine TimedSubscription ein freigegebener Zeitplan ist, müssen Sie die Zeitplan-ID des freigegebenen Zeitplans MatchData als Parameter übergeben. Die Zeitplan-ID wird beispielsweise als String"4608ac1b-fc75-4149-9e15-5a8b5781b843" übergeben. Die Zeitplan-ID kann durch Aufrufen der ListSchedules -Methode abgerufen werden.

Sie können die XmlSerializer-Klasse verwenden, um Ihre Objektklasse automatisch in eine XML-Zeichenfolge zu konvertieren. Weitere Informationen zur XmlSerializer-Klasse finden Sie unter "System.Xml. XmlSerializer-Klasse" in der Microsoft .NET Framework-Dokumentation.

Wenn es sich bei dem Ereignis um ein Momentaufnahme Updateabonnement handelt, sollte der Wert des MatchData Parameters (Nothing in Visual Basic) sein null .