ReportingService2010.SetSubscriptionProperties Método

Referencia

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

Objeto ExtensionSettings que contiene una lista de opciones de configuración que es específica de la extensión de entrega.

Description: String

Descripción significativa que se muestra a los usuarios.

EventType: String

Tipo de evento que desencadena la suscripción.

MatchData: String

Datos asociados al tipo especificado de evento. Esta extensión de procesamiento de eventos usa estos datos para que coincidan con la suscripción con un evento que se ha desencadenado.

Parameters: ParameterValue[]

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

Atributos: SoapDocumentMethodAttribute SoapHeaderAttribute

Comentarios

En la siguiente tabla se muestra la información de encabezado y de permisos de esta operación.


Uso del encabezado SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios en modo nativo	UpdateAnySubscription OR (UpdateSubscription AND el usuario es el propietario del informe y la suscripción es una suscripción con tiempo)
Permisos necesarios en modo de SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OR (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> AND el usuario es el propietario de la suscripción y la suscripción es una suscripción con tiempo)

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 se controla mediante una extensión de procesamiento de eventos, se produce una excepción SOAP con el código rsInvalidEventde error . El tipo de evento debe controlarse mediante 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 crea notificaciones. Si no es así, se produce 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 debe serializar el ScheduleDefinition objeto como XML para pasarlo como un valor de cadena y crear una suscripción basada en la programación. La estructura XML podría ser similar a la del ejemplo siguiente:

<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 una 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, "AAA" 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 hora, minuto y segundo respectivamente. Esta representación puede ir seguida inmediatamente de una "Z" para indicar la hora universal coordinada (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 de UTC representada como hh:mm.

Si la definición de programación de es TimedSubscription una programación compartida, debe pasar el identificador de programación de la programación compartida como MatchData parámetro . El identificador de programación se pasa como String, por ejemplo, "4608ac1b-fc75-4149-9e15-5a8b5781b843". El identificador de programación se puede obtener llamando al ListSchedules método .

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

La propiedad "Correo electrónico de trabajo" de un usuario no administrativo de SharePoint en su información de usuario de SharePoint debe ser la configuración de la extensión de entrega de correo electrónico to

Se aplica a

Compartir a través de

ReportingService2010.SetSubscriptionProperties Método

Definición

Parámetros

Comentarios

Se aplica a

Recursos adicionales