ReportingService2005.SetDataDrivenSubscriptionProperties Metodo

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

Parametri

Commenti

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

Per consentire l'esecuzione corretta della sottoscrizione basata sui dati, l'origine dati a cui fa DataRetrievalPlan riferimento l'oggetto deve avere una CredentialRetrieval proprietà impostata su Store.

Gli Field oggetti contenuti nell'oggetto DataSet vengono controllati nei campi mappati alle impostazioni di estensione di recapito e ai valori dei parametri del report. Tutti i campi a cui si fa riferimento nelle impostazioni di estensione per il recapito e i valori dei parametri del report devono essere enumerati anche nel set di dati.

Nessuna convalida viene eseguita per assicurarsi che i campi enumerati nel set di dati vengano restituiti dalla query di recapito. Se un campo enumerato nel set di dati non viene restituito dalla query di recapito, il server di report genera un errore quando viene elaborata la sottoscrizione.

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

Il valore del parametro dipende dal tipo di MatchData evento. Se l'evento è un evento TimedSubscription , è necessario un ScheduleDefinition oggetto come MatchData parametro. È prima necessario 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 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, "Y" 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" è preceduta da un segno "+" o "-", seguito dalla differenza dall'ora UTC rappresentata come hh:mm.

Se la definizione di pianificazione per un timedSubscription è una pianificazione condivisa, è necessario passare l'ID di 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 .

È possibile usare la classe XmlSerializer per convertire automaticamente la classe oggetto in una stringa XML. Per altre informazioni sulla classe XmlSerializer , vedere "System.Xml. Classe XmlSerializer" nella documentazione di Microsoft .NET Framework.

Se l'evento è una sottoscrizione di aggiornamento snapshot, il valore del MatchData parametro deve essere null (Nothing in Visual Basic).

Si applica a