ReportingService2005.SetSubscriptionProperties(String, ExtensionSettings, String, String, String, ParameterValue[]) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta le proprietà di una sottoscrizione.
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())
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) BatchHeaderValue (Out) ServerInfoHeaderValue |
| Autorizzazioni necessarie | UpdateAnySubscription OPPURE ( UpdateSubscription e l'utente è il proprietario del report e la sottoscrizione è una sottoscrizione temporizzata) |
Il valore del EventType parametro deve corrispondere a un'estensione per l'elaborazione di eventi configurata nel server di report. Se il tipo di evento non è gestito da un'estensione per l'elaborazione di eventi, viene generata un'eccezione SOAP con il codice di errore rsInvalidEvent . 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 le notifiche. In caso contrario, viene generata un'eccezione SOAP con il codice di errore rsEventNonSubscribeable .
Il valore del MatchData parametro dipende dal tipo di evento. Se l'evento è un evento TimedSubscription , ScheduleDefinition è necessario un oggetto come MatchData parametro. È innanzitutto necessario serializzare l' ScheduleDefinition oggetto come XML per passarlo come valore stringa e creare una sottoscrizione in base alla pianificazione. La struttura XML potrebbe essere simile a quella dell'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 formato AAAA-MM-GGThh: mm: SS +/-Z dove "CC" rappresenta il secolo, "YY", "MM", il mese e il giorno "gg". La lettera "T" è il separatore di data e ora e "HH", "mm", "SS" rappresentano rispettivamente l'ora, il minuto e il 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 UTC (Coordinated Universal Time), "Z" è preceduto da un segno "+" o "-", seguito dalla differenza rispetto all'ora UTC rappresentata come HH: mm.
Se la definizione della pianificazione per un TimedSubscription è una pianificazione condivisa, è necessario passare l'ID pianificazione della pianificazione condivisa come MatchData parametro. L'ID della pianificazione viene passato come String , ad esempio, "4608ac1b-fc75-4149-9e15-5a8b5781b843". È possibile ottenere l'ID pianificazione chiamando il ListSchedules metodo.
Se l'evento è una sottoscrizione di aggiornamento dello snapshot, impostare il MatchData parametro su null ( Nothing in Visual Basic).