ReportingService2010.SetSubscriptionProperties Metodo

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 un abbonamento.

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

Un oggetto che contiene una lista di impostazioni specifiche per l'estensione ExtensionSettings di consegna.

Description: String

Una descrizione significativa che viene mostrata agli utenti.

EventType: String

Il tipo di evento che attiva l'abbonamento.

MatchData: String

I dati associati al tipo specificato di evento. Questi dati vengono utilizzati da un'estensione per l'elaborazione eventi per abbinare l'abbonamento a un evento che è stato attivato.

Parameters: ParameterValue[]

Un array di ParameterValue oggetti che contiene un elenco di parametri per il report.

Attributi: SoapDocumentMethodAttribute SoapHeaderAttribute

Commenti

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


Utilizzo dell'intestazione SOAP	(Dentro) TrustedUserHeaderValue (Fuori) ServerInfoHeaderValue
Permessi richiesti per la modalità nativa	UpdateAnySubscription OPPURE (UpdateSubscription E l'utente è il proprietario del report e l'abbonamento è un abbonamento a tempo)
Permessi richiesti in modalità SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OPPURE (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> E l'utente è il proprietario dell'abbonamento e l'abbonamento è a tempo limitato)

Il valore del EventType parametro deve corrispondere a un'estensione di elaborazione eventi configurata sul server di report. Se il tipo di evento non viene gestito da un'estensione di elaborazione evento, viene lanciata un'eccezione SOAP con il codice rsInvalidEventdi errore . Il tipo di evento deve essere gestito da un'estensione per l'elaborazione eventi che crea notifiche. Quando viene ricevuto un valore per il EventType parametro, viene interrogata l'estensione di elaborazione eventi per determinare se l'evento genera 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 TimedSubscription evento, è 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 del 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 viene 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 a TimedSubscription è un schedule condiviso, 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.

Se l'evento è un sottoscrizione a un aggiornamento snapshot, imposta MatchData il parametro a null (Nothing in Visual Basic).

La proprietà 'E-mail di lavoro' di un utente non amministrativo di SharePoint nelle Informazioni utente di SharePoint dovrebbe essere l'impostazione dell'estensione di consegna e-mail TO

Si applica a