ReportingService2010.SetSubscriptionProperties Método

Definición

Espacio de nombres:: ReportService2010

Ensamblado:: ReportService2010.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece las propiedades de una suscripción.

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())

Parámetros

SubscriptionID: String

Identificador de la suscripción.

ExtensionSettings: ExtensionSettings

Un ExtensionSettings objeto que contiene una lista de ajustes específicos de la extensión de entrega.

Description: String

Una descripción significativa que se muestra a los usuarios.

EventType: String

El tipo de evento que activa la suscripción.

MatchData: String

Los datos asociados al tipo de evento especificado. Estos datos los utiliza una extensión de procesamiento de eventos para emparejar la suscripción con un evento que se ha activado.

Parameters: ParameterValue[]

Un array de ParameterValue objetos que contiene una lista de parámetros para el informe.

Atributos: SoapDocumentMethodAttribute SoapHeaderAttribute

Comentarios

La siguiente tabla muestra la información sobre cabeceras y permisos sobre esta operación.


Uso de la cabecera SOAP	(En) TrustedUserHeaderValue (Fuera) ServerInfoHeaderValue
Permisos requeridos en modo nativo	UpdateAnySubscription O (UpdateSubscription Y el usuario es el propietario del informe y la suscripción es una suscripción con tiempo limitado)
Permisos requeridos en el modo SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> O (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> Y el usuario es el propietario de la suscripción y la suscripción es una suscripción con tiempo limitado)

El valor del EventType parámetro debe corresponder a una extensión de procesamiento de eventos configurada en el servidor de informes. Si el tipo de evento no es gestionado por una extensión de procesamiento de eventos, se lanza una excepción SOAP junto con el código rsInvalidEventde error . El tipo de evento debe ser gestionado por una extensión de procesamiento de eventos que crea notificaciones. Cuando se recibe un valor para el EventType parámetro, se consulta la extensión de procesamiento de eventos para determinar si el evento genera notificaciones. Si no lo hace, se lanza una excepción SOAP con el código rsEventNonSubscribeablede error .

El valor del MatchData parámetro depende del tipo de evento. Si el evento es un TimedSubscription evento, se requiere un ScheduleDefinition objeto como MatchData parámetro. Primero debes serializar el ScheduleDefinition objeto como XML para poder pasarlo como valor de cadena y crear una suscripción basada en el calendario. La estructura XML podría parecerse a la del siguiente ejemplo:

<ScheduleDefinition>  
   <WeeklyRecurrence>  
      <StartDateTime>2003-02-24T09:00:00-08:00</StartDateTime>  
      <WeeksInterval>1</WeeksInterval>  
      <DaysOfWeek>  
        <Monday>True</Monday>  
         </DaysOfWeek>  
   </WeeklyRecurrence>  
</ScheduleDefinition>

El valor del StartDateTime elemento cuando se pasa como cadena XML debe corresponder al formato de fecha ISO 8601. Este estándar internacional de fecha y hora es el formato extendido CCYY-MM-DDThh:mm:ss+/-Z, donde "CC" representa el siglo, "YY" el año, "MM" el mes y "DD" el día. La letra "T" es el separador de fecha y hora y "hh", "mm", "ss" representan la hora, el minuto y el segundo respectivamente. Esta representación puede ir seguida inmediatamente de una "Z" para indicar el Tiempo Universal Coordinado (UTC). Para indicar la zona horaria, representada como la diferencia entre la hora local y la Hora Universal Coordinada, "Z" va precedida de un signo "+" o "-", seguido de la diferencia respecto a UTC representada como hh:mm.

Si la definición de horario para a TimedSubscription es un horario compartido, debes pasar el ID de horario compartido como MatchData parámetro. El ID del horario se transmite como un String, por ejemplo, "4608ac1b-fc75-4149-9e15-5a8b5781b843". El ID del calendario se puede obtener llamando al ListSchedules método.

Si el evento es una suscripción de actualización instantánea, establece MatchData el parámetro a null (Nothing en Visual Basic).

La propiedad 'Correo de trabajo' de un usuario no administrativo de SharePoint en su Información de Usuario de SharePoint debería ser la configuración de extensión de entrega de correo electrónico TO

Se aplica a