ReportingService2006.SetSubscriptionProperties Methode

Definition

Namespace:: ReportService2006

Assembly:: ReportService2006.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt die Eigenschaften eines Abonnements fest.

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

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

member this.SetSubscriptionProperties : string * ReportService2006.ExtensionSettings * string * string * string * ReportService2006.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 Objekt, das eine Liste von Einstellungen enthält, die spezifisch für die Liefererweiterung ExtensionSettings sind.

Description: String

Eine aussagekräftige Beschreibung, die den Nutzern angezeigt wird.

EventType: String

Die Art von Ereignis, die das Abonnement auslöst.

MatchData: String

Die Daten, die mit dem angegebenen Ereignistyp verbunden sind. Diese Daten werden von einer Event-Processing-Erweiterung verwendet, um das Abonnement mit einem ausgelösten Ereignis abzugleichen.

Parameters: ParameterValue[]

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

Hinweise

Die untenstehende Tabelle zeigt Header- und Berechtigungsinformationen zu dieser Operation.


SOAP-Überschriften	(In) TrustedUserHeaderValue (Aus) ServerInfoHeaderValue
Erforderliche Berechtigungen	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> ODER (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> UND der Nutzer ist der Abonnementinhaber und das Abonnement ist zeitlich begrenzt)

Der Wert des Parameters EventType 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 rsInvalidEventgeworfen. Der Ereignistyp muss von einer Ereignisverarbeitungserweiterung behandelt werden, die Benachrichtigungen erstellt. Wenn ein Wert für den Parameter EventType empfangen wird, wird die Ereignisverarbeitungserweiterung abgerufen, um zu bestimmen, ob das Ereignis Benachrichtigungen erzeugt. Wenn nicht, wird eine SOAP-Ausnahme mit dem Fehlercode rsEventNonSubscribeablegeworfen.

Der Wert des Parameters MatchData hängt vom Ereignistyp ab. Wenn das Ereignis ein Ereignis TimedSubscription ist, wird ein ScheduleDefinition Objekt als Parameter MatchData benötigt. Sie müssen das ScheduleDefinition Objekt zunächst als XML serialisieren, um es als String-Wert zu übergeben und ein Abonnement basierend auf dem Zeitplan zu erstellen. Die XML-Struktur könnte der im folgenden Beispiel ähneln:

<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-String ü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, "YY" das Jahr, "MM" den Monat und "DD" den Tag darstellt. Der Buchstabe "T" ist der Datums- und Zeittrenner, und "hh", "mm", "ss" stehen jeweils für Stunde, Minute und Sekunde. Diese Darstellung kann unmittelbar von einem "Z" gefolgt werden, um die koordinierte Universalzeit (UTC) anzuzeigen. Um die Zeitzone anzuzeigen, dargestellt als Differenz zwischen der Ortszeit und der koordinierten Universalzeit, wird "Z" von einem "+" oder "-" Zeichen vorangestellt, gefolgt von der Differenz von UTC, die als hh:mm dargestellt wird.

Wenn die Zeitplandefinition für einen TimedSubscription geteilten Zeitplan ist, müssen Sie die Planungs-ID des gemeinsamen Zeitplans als Parameter MatchData übergeben. Die Schedule-ID wird beispielsweise als String"4608ac1b-fc75-4149-9e15-5a8b5781b843" weitergegeben. Die Zeitplan-ID kann durch Aufruf der Methode ListSchedules erhalten werden.

Wenn das Ereignis ein Snapshot-Update-Abonnement ist, setze MatchData den Parameter auf null (Nothing in Visual Basic).

Die 'Arbeits-E-Mail'-Eigenschaft eines SharePoint-Nicht-Administrators in seinen SharePoint-Benutzerinformationen sollte die Einstellung für die TO-E-Mail-Zustellung sein.

Gilt für: