ReportingService2010.SetDataDrivenSubscriptionProperties Método

Definición

Espacio de nombres:

ReportService2010

Ensamblado:

ReportService2010.dll

Establece las propiedades de una suscripción controlada por datos.

public:
 void SetDataDrivenSubscriptionProperties(System::String ^ DataDrivenSubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, ReportService2010::DataRetrievalPlan ^ DataRetrievalPlan, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValueOrFieldReference ^> ^ Parameters);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", 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("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void SetDataDrivenSubscriptionProperties (string DataDrivenSubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, ReportService2010.DataRetrievalPlan DataRetrievalPlan, string Description, string EventType, string MatchData, ReportService2010.ParameterValueOrFieldReference[] Parameters);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", 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("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.SetDataDrivenSubscriptionProperties : string * ReportService2010.ExtensionSettings * ReportService2010.DataRetrievalPlan * string * string * string * ReportService2010.ParameterValueOrFieldReference[] -> unit

Public Sub SetDataDrivenSubscriptionProperties (DataDrivenSubscriptionID As String, ExtensionSettings As ExtensionSettings, DataRetrievalPlan As DataRetrievalPlan, Description As String, EventType As String, MatchData As String, Parameters As ParameterValueOrFieldReference())

Parámetros

DataDrivenSubscriptionID

String

Identificador de la suscripción, que devuelve el método CreateDataDrivenSubscription(String, ExtensionSettings, DataRetrievalPlan, String, String, String, ParameterValueOrFieldReference[]).

ExtensionSettings

ExtensionSettings

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

DataRetrievalPlan

DataRetrievalPlan

Objeto DataRetrievalPlan que contiene una lista de opciones de configuración necesarias para recuperar los datos de la consulta de entrega para la suscripción.

Description

String

Descripción significativa que se muestra a los usuarios.

EventType

String

Tipo de evento que desencadena la suscripción. Los valores válidos son TimedSubscription o SnapshotUpdated.

MatchData

String

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

Parameters

ParameterValueOrFieldReference[]

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 de encabezados SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Permisos necesarios en modo nativo	UpdateAnySubscription
Permisos necesarios en modo de SharePoint	<xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts>

Para que la suscripción controlada por datos se ejecute correctamente, el origen de datos al que hace referencia el DataRetrievalPlan objeto debe tener una CredentialRetrieval propiedad establecida en Store.

Los Field objetos contenidos en DataSet se comprueban en los campos que se asignan a la configuración de la extensión de entrega y a los valores de los parámetros del informe. Todos los campos a los que se hace referencia en la configuración de la extensión de entrega y los valores de los parámetros de informe también deben enumerarse en el conjunto de datos.

No se realiza ninguna validación para asegurarse de que la consulta de entrega devuelve los campos enumerados en el conjunto de datos. Si la consulta de entrega no devuelve un campo enumerado en el conjunto de datos, el servidor de informes genera un error cuando se procesa la suscripción.

El valor del EventType parámetro debe corresponder a una extensión de procesamiento de eventos configurada en el servidor de informes. Si una extensión de procesamiento de eventos no controla un evento, se produce una excepción SOAP con el código rsInvalidEventde error . El 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 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 evento TimedSubscription , 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 elemento StartDateTime cuando se pasa como una cadena XML debe corresponder al formato de fecha ISO 8601. Este estándar de fecha y hora internacional es el formato extendido CCYY-MM-DDThh:mm:ss+/-Z donde "CC" representa el siglo, "AAAa" 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" está precedida por un signo "+" o "-", seguido de la diferencia de UTC representada como hh:mm.

Si la definición de programación de una timedSubscription es una programación compartida, debe pasar el identificador de programación de la programación compartida como parámetro MatchData . 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 .

Puede usar la clase XmlSerializer para convertir automáticamente la clase de objeto en una cadena XML. Para obtener más información sobre la clase XmlSerializer , vea "System.Xml. Clase XmlSerializer" en la documentación de Microsoft .NET Framework.

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