ReportingService2010.SetSubscriptionProperties Metodo

Definizione

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

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