ReportingService2010.SetSubscriptionProperties Metodo

Riferimento

Definizione

Spazio dei nomi:: ReportService2010

Assembly:: ReportService2010.dll

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, ReportService2010::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValue ^> ^ Parameters);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetSubscriptionProperties", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public void SetSubscriptionProperties (string SubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2010.ParameterValue[] Parameters);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetSubscriptionProperties", 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("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.SetSubscriptionProperties : string * ReportService2010.ExtensionSettings * string * string * string * ReportService2010.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.

Attributi: SoapDocumentMethodAttribute SoapHeaderAttribute

Commenti

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


Utilizzo intestazione SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorizzazioni necessarie in modalità nativa	UpdateAnySubscription OR (UpdateSubscription E l'utente è il proprietario del report e la sottoscrizione è una sottoscrizione timed)
Autorizzazioni necessarie per la modalità SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OR (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> E l'utente è il proprietario della sottoscrizione e la sottoscrizione è una sottoscrizione timed)

Il valore del parametro deve corrispondere a un'estensione di EventType elaborazione eventi configurata nel server di report. Se il tipo di evento non viene gestito da un'estensione di elaborazione eventi, viene generata un'eccezione SOAP con il codice rsInvalidEventdi errore . Il tipo di evento deve essere gestito da un'estensione di elaborazione eventi che crea notifiche. Quando viene ricevuto un valore per il parametro, l'estensione di elaborazione eventi viene eseguita una query per determinare se l'evento EventType 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, è necessario un TimedSubscriptionScheduleDefinition 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 viene passato come stringa XML deve corrispondere al formato 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 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 MatchData il parametro su null (Nothing in Visual Basic).

La proprietà "Posta elettronica aziendale" di Un utente non amministrativo di SharePoint nella relativa proprietà di sharePoint User Information deve essere l'impostazione dell'estensione per il recapito tramite posta elettronica TO

Si applica a

Condividi tramite

ReportingService2010.SetSubscriptionProperties Metodo

Definizione

Parametri

Commenti

Si applica a

Risorse aggiuntive