ReportingService2010.SetDataDrivenSubscriptionProperties Metodo

public:
 void SetDataDrivenSubscriptionProperties(System::String ^ DataDrivenSubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, ReportService2010::DataRetrievalPlan ^ DataRetrievalPlan, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValueOrFieldReference ^> ^ Parameters);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void SetDataDrivenSubscriptionProperties(string DataDrivenSubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, ReportService2010.DataRetrievalPlan DataRetrievalPlan, string Description, string EventType, string MatchData, ReportService2010.ParameterValueOrFieldReference[] Parameters);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.SetDataDrivenSubscriptionProperties : string * ReportService2010.ExtensionSettings * ReportService2010.DataRetrievalPlan * string * string * string * ReportService2010.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

Attributi

SoapDocumentMethodAttribute SoapHeaderAttribute

Commenti

La tabella sottostante mostra informazioni sull'intestazione e sui permessi di questa operazione.

Affinché l'abbonamento guidato dai dati funzioni correttamente, la sorgente dati a cui l'oggetto DataRetrievalPlan fa riferimento deve avere una CredentialRetrieval proprietà impostata su Store.

Gli Field oggetti contenuti in questo DataSet sono confrontati con i campi che sono mappati alle impostazioni di estensione di consegna e ai valori dei parametri di riferimento. Tutti i campi che sono citati nelle impostazioni di estensione di consegna e i valori dei parametri di report devono essere anch'essi elencati nel dataset.

Non viene effettuata alcuna validazione per garantire che i campi enumerati nel dataset vengano restituiti dalla query di consegna. Se un campo elencato nel dataset non viene restituito dalla query di consegna, il server di report genera un errore quando l'abbonamento viene elaborato.

Il valore del EventType parametro deve corrispondere a un'estensione di elaborazione eventi configurata sul server di report. Se un evento non viene gestito da un'estensione di elaborazione evento, viene lanciata un'eccezione SOAP con il codice rsInvalidEventdi errore . L'evento deve essere gestito da un'estensione per l'elaborazione degli eventi che crea notifiche. Quando viene ricevuto un valore per il EventType parametro, viene interrogata l'estensione per l'elaborazione eventi per determinare se crea notifiche. Se non lo fa, viene lanciata un'eccezione SOAP con il codice rsEventNonSubscribeabledi errore .

Il valore del MatchData parametro dipende dal tipo di evento. Se l'evento è un evento TimedSubscription , è richiesto un ScheduleDefinition oggetto come MatchData parametro. Devi prima serializzare l'oggetto ScheduleDefinition come XML per poterlo passare come valore di stringa e creare un abbonamento basato sul programma. La struttura XML potrebbe assomigliare a quella nel seguente esempio:

<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, dovrebbe corrispondere al formato di data ISO 8601. Questo standard internazionale di data e ora è il formato esteso CCYY-MM-DDThh:mm:ss+/-Z, dove "CC" rappresenta il secolo, "YY" l'anno, "MM" il mese e "DD" il giorno. La lettera "T" indica il separatore data e ora e "hh", "mm", "ss" rappresentano rispettivamente ora, minuto e secondo. Questa rappresentazione può essere immediatamente seguita da una "Z" per indicare il Tempo Universale Coordinato (UTC). Per indicare il fuso orario, rappresentato come la differenza tra l'ora locale e il Tempo Universale Coordinato, "Z" è preceduta da un segno "+" o "-", seguito dalla differenza rispetto all'UTC rappresentata come hh:mm.

Se la definizione di schedule per un TimedSubscription è un schedule condiviso, allora devi passare l'ID schedule del programma condiviso come MatchData parametro. L'ID dell'elenco viene trasmesso come String, ad esempio, "4608ac1b-fc75-4149-9e15-5a8b5781b843". L'ID dell'schedule può essere ottenuto chiamando il ListSchedules metodo.

Puoi usare la classe XmlSerializer per convertire automaticamente la tua classe oggetto in una stringa XML. Per maggiori informazioni sulla classe XmlSerializer, consulta "System.Xml.XmlSerializer Class" nella documentazione Microsoft .NET Framework.

Se l'evento è un abbonamento a un aggiornamento snapshot, il valore del MatchData parametro dovrebbe essere null (Nothing in Visual Basic).