ReportingService2010.SetSubscriptionProperties Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit les propriétés d’un abonnement.
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())
Paramètres
- SubscriptionID
- String
ID de l’abonnement.
- ExtensionSettings
- ExtensionSettings
Un ExtensionSettings objet contenant une liste de paramètres spécifiques à l’extension de livraison.
- Description
- String
Une description significative qui est affichée aux utilisateurs.
- EventType
- String
Le type d’événement qui déclenche l’abonnement.
- MatchData
- String
Les données associées au type d’événement spécifié. Ces données sont utilisées par une extension de traitement d’événements pour faire correspondre l’abonnement à un événement qui a été déclenché.
- Parameters
- ParameterValue[]
Un tableau d’objets ParameterValue contenant une liste de paramètres pour le rapport.
- Attributs
Remarques
Le tableau ci-dessous présente les informations sur l’en-tête et les autorisations concernant cette opération.
| Utilisation de l’en-tête SOAP | (En) TrustedUserHeaderValue (Dehors) ServerInfoHeaderValue |
| Mode natif : autorisations requises | UpdateAnySubscription OU (UpdateSubscription ET l’utilisateur est le propriétaire du rapport et l’abonnement est un abonnement à durée limitée) |
| Permissions requises en mode SharePoint | <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OU (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> ET l’utilisateur est le propriétaire de l’abonnement et l’abonnement est un abonnement à durée limitée) |
La valeur du EventType paramètre doit correspondre à une extension de traitement d’événements configurée sur le serveur de rapport. Si le type d’événement n’est pas géré par une extension de traitement d’événement, une exception SOAP est lancée avec le code rsInvalidEventd’erreur . Le type d’événement doit être géré par une extension de traitement d’événements qui crée des notifications. Lorsqu’une valeur pour le EventType paramètre est reçue, l’extension de traitement de l’événement est interrogée pour déterminer si l’événement crée des notifications. Si ce n’est pas le cas, une exception SOAP est lancée avec le code rsEventNonSubscribeabled’erreur .
La valeur du MatchData paramètre dépend du type d’événement. Si l’événement est un TimedSubscription événement, un ScheduleDefinition objet est requis comme MatchData paramètre. Vous devez d’abord sérialiser l’objet ScheduleDefinition en XML afin de le passer en tant que valeur de chaîne et de créer un abonnement basé sur le planning. La structure XML pourrait ressembler à celle de l’exemple suivant :
<ScheduleDefinition>
<WeeklyRecurrence>
<StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>
<WeeksInterval>1</WeeksInterval>
<DaysOfWeek>
<Monday>True</Monday>
</DaysOfWeek>
</WeeklyRecurrence>
</ScheduleDefinition>
La valeur de l’élément StartDateTime lorsqu’il est transmis en chaîne XML doit correspondre au format de date ISO 8601. Cette norme internationale de date et d’heure est le format étendu CCYY-MM-DDThh :mm :ss+/-Z où « CC » représente le siècle, « YY » l’année, « MM » le mois et « DD » le jour. La lettre « T » est le séparateur de date et d’heure, et « hh », « mm », « ss » représentent respectivement l’heure, la minute et la seconde. Cette représentation peut être immédiatement suivie d’un « Z » pour indiquer le Temps Universel Coordonné (UTC). Pour indiquer le fuseau horaire, représenté par la différence entre l’heure locale et l’heure universelle coordonnée, « Z » est précédé d’un signe « + » ou « - », suivi de la différence avec UTC représentée par hh :mm.
Si la définition de l’horaire pour a TimedSubscription est un horaire partagé, vous devez passer l’identifiant de l’horaire partagé comme MatchData paramètre. L’identifiant du calendrier est transmis comme String, par exemple, « 4608ac1b-fc75-4149-9e15-5a8b5781b843 ». L’ID de l’ordonnance peut être obtenu en appelant la ListSchedules méthode.
Si l’événement est un abonnement de mise à jour instantanée, définissez MatchData le paramètre à null (Nothing dans Visual Basic).
La propriété « E-mail de travail » d’un utilisateur non administratif SharePoint dans ses informations utilisateur SharePoint devrait correspondre à l’extension de livraison d’e-mail TO