ReportingService2006.SetSubscriptionProperties Metodo

Definizione

Spazio dei nomi:

ReportService2006

Assembly:

ReportService2006.dll

Imposta le proprietà di una sottoscrizione.

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())

Parametri

SubscriptionID

String

ID della sottoscrizione.

ExtensionSettings

ExtensionSettings

Oggetto ExtensionSettings contenente un elenco di impostazioni specifiche dell'estensione per il recapito.

Description

String

Descrizione significativa visualizzata agli utenti.

EventType

String

Tipo di evento che attiva la sottoscrizione.

MatchData

String

Dati associati al tipo di evento specificato. Tali dati vengono utilizzati in un'estensione per l'elaborazione degli eventi per individuare una corrispondenza tra la sottoscrizione e un evento generato.

Parameters

ParameterValue[]

Matrice di oggetti ParameterValue contenente un elenco di parametri per il report.

Commenti

Nella tabella seguente vengono mostrate le informazioni sull'intestazione e sulle autorizzazioni relative a questa operazione.

Intestazioni SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OR (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> E l'utente è il proprietario della sottoscrizione e la sottoscrizione è una sottoscrizione a tempo)

Il valore del EventType parametro deve corrispondere a un'estensione per l'elaborazione eventi configurata nel server di report. Se il tipo di evento non viene gestito da un'estensione per l'elaborazione di eventi, viene generata un'eccezione SOAP con il codice rsInvalidEventdi errore . Il tipo di evento deve essere gestito da un'estensione per l'elaborazione di eventi che crea notifiche. Quando viene ricevuto un valore per il EventType parametro, viene eseguita una query sull'estensione per l'elaborazione degli eventi per determinare se l'evento crea notifiche. In caso contrario, viene generata un'eccezione SOAP con il codice rsEventNonSubscribeabledi errore .

Il valore del MatchData parametro dipende dal tipo di evento. Se l'evento è un TimedSubscription evento, è necessario un ScheduleDefinition oggetto come MatchData parametro . È necessario prima serializzare l'oggetto ScheduleDefinition come XML per passarlo come valore stringa e creare una sottoscrizione in base alla pianificazione. La struttura XML potrebbe essere simile a quella nell'esempio seguente:

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

Il valore dell'elemento StartDateTime quando viene passato come stringa XML deve corrispondere al formato di data ISO 8601. Questo standard di data e ora internazionale è il formato esteso CCYY-MM-DDThh:mm:ss+/-Z dove "CC" rappresenta il secolo, "AA" l'anno, "MM" il mese e "DD" il giorno. La lettera "T" è il separatore di data e ora e "hh", "mm", "ss" rappresentano rispettivamente ora, minuto e secondo. Questa rappresentazione può essere immediatamente seguita da una "Z" per indicare l'ora UTC (Coordinated Universal Time). Per indicare il fuso orario, rappresentato come differenza tra l'ora locale e l'ora universale coordinata, "Z" è preceduto da un segno "+" o "-", seguito dalla differenza rispetto all'ora UTC rappresentata come hh:mm.

Se la definizione di pianificazione per un TimedSubscription oggetto è una pianificazione condivisa, è necessario passare l'ID pianificazione della pianificazione condivisa come MatchData parametro . L'ID pianificazione viene passato come String, ad esempio , "4608ac1b-fc75-4149-9e15-5a8b5781b843". L'ID pianificazione può essere ottenuto chiamando il ListSchedules metodo .

Se l'evento è una sottoscrizione di aggiornamento snapshot, impostare il MatchData parametro su null (Nothing in Visual Basic).

La proprietà "Posta elettronica di lavoro" di un utente non amministrativo di SharePoint nelle informazioni utente di SharePoint deve essere l'impostazione dell'estensione per il recapito tramite posta elettronica TO