ReportingService2005.SetSubscriptionProperties Methode

Definition

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Legt die Eigenschaften eines Abonnements fest.

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValue ^> ^ Parameters);

public void SetSubscriptionProperties (string SubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2005.ParameterValue[] Parameters);

member this.SetSubscriptionProperties : string * ReportService2005.ExtensionSettings * string * string * string * ReportService2005.ParameterValue[] -> unit

Public Sub SetSubscriptionProperties (SubscriptionID As String, ExtensionSettings As ExtensionSettings, Description As String, EventType As String, MatchData As String, Parameters As ParameterValue())

Parameter

SubscriptionID

String

Die ID des Abonnements.

ExtensionSettings

ExtensionSettings

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

Description

String

Eine aussagekräftige Beschreibung, die Benutzern angezeigt wird.

EventType

String

Der Typ des Ereignisses, das das Abonnement auslöst.

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

ParameterValue[]

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 OR ( AND the user is the report owner and the subscription is a timed subscription) (UpdateSubscription AND the user is the report owner and the subscription is a timed subscription)

Der Wert des EventType Parameters muss einer Ereignisverarbeitungserweiterung entsprechen, die auf dem Berichtsserver konfiguriert ist. Wenn der Ereignistyp nicht von einer Ereignisverarbeitungserweiterung behandelt wird, wird eine SOAP-Ausnahme mit dem Fehlercode rsInvalidEventausgelöst. Der Ereignistyp 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 das Ereignis Benachrichtigungen erstellt. Wenn dies nicht der Fall ist, 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 zunächst als XML serialisieren, um es als Zeichenfolgenwert zu übergeben und ein Abonnement basierend auf dem Zeitplan zu erstellen. Die XML-Struktur kann 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 es als XML-Zeichenfolge übergeben wird, sollte dem Datumsformat ISO 8601 entsprechen. Dieser internationale Datums- und Uhrzeitstandard ist das erweiterte Format CCYY-MM-DDThh: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" steht für Stunde, Minute und Sekunde. Dieser Darstellung kann unmittelbar ein "Z" folgen, um die koordinierte Weltzeit (UTC) anzugeben. Um die Zeitzone anzugeben, die als Unterschied zwischen der Ortszeit 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 als übergeben, z. B String. "4608ac1b-fc75-4149-9e15-5a8b5781b843". Die Zeitplan-ID kann durch Aufrufen der ListSchedules -Methode abgerufen werden.

Wenn es sich bei dem Ereignis um ein Momentaufnahme Updateabonnement handelt, legen Sie den Parameter auf null (Nothing in Visual Basic) festMatchData.