ReportingService2010.SetDataDrivenSubscriptionProperties Método

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

Atributos

SoapDocumentMethodAttribute SoapHeaderAttribute

Comentários

A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.

Para que a assinatura orientada a dados funcione corretamente, a fonte de dados que o DataRetrievalPlan objeto referencia deve ter uma CredentialRetrieval propriedade definida como Store.

Os Field objetos contidos em são DataSet verificados em relação aos campos que são mapeados para as configurações de extensão de entrega e os valores dos parâmetros de reportagem. Todos os campos referenciados nas configurações de extensão de entrega e valores de parâmetros de relatório também devem ser enumerados no conjunto de dados.

Nenhuma validação é realizada para garantir que os campos enumerados no conjunto de dados sejam retornados pela consulta de entrega. Se um campo enumerado no conjunto de dados não for retornado pela consulta de entrega, o servidor de relatórios gera um erro quando a assinatura é processada.

O valor do EventType parâmetro deve corresponder a uma extensão de processamento de eventos configurada no servidor de relatórios. Se um evento não for tratado por uma extensão de processamento de eventos, uma exceção SOAP é lançada com o código rsInvalidEventde erro . O evento deve ser gerenciado por uma extensão de processamento de eventos que cria notificações. Quando um valor para o EventType parâmetro é recebido, a extensão de processamento de eventos é consultada para determinar se ela gera notificações. Se não acontecer, uma exceção SOAP é lançada com o código rsEventNonSubscribeablede erro .

O valor do MatchData parâmetro depende do tipo de evento. Se o evento for um evento TimedSubscription , um ScheduleDefinition objeto é necessário como MatchData parâmetro. Você deve primeiro serializar o ScheduleDefinition objeto como XML para passá-lo como um valor de string e criar uma assinatura baseada no cronograma. A estrutura XML pode se parecer com a do exemplo a seguir:

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

O valor do elemento StartDateTime , quando passado como uma string XML, deve corresponder ao formato de data ISO 8601. Esse padrão internacional de data e hora é o formato estendido CCYY-MM-DDThh:mm:ss+/-Z, onde "CC" representa o século, "YY" o ano, "MM" o mês e "DD" o dia. A letra "T" é o separador de data e hora e "hh", "mm", "ss" representam hora, minuto e segundo, respectivamente. Essa representação pode ser imediatamente seguida por um "Z" para indicar o Tempo Universal Coordenado (UTC). Para indicar o fuso horário, representado como a diferença entre o horário local e o Horário Universal Coordenado, "Z" é precedido por um sinal de "+" ou "-", seguido pela diferença em relação ao UTC representada como hh:mm.

Se a definição de cronograma para um TimedSubscription for um cronograma compartilhado, então você deve passar o ID do cronograma compartilhado como parâmetro MatchData . O ID do cronograma é passado como um String, por exemplo, "4608ac1b-fc75-4149-9e15-5a8b5781b843". O ID do agendamento pode ser obtido chamando o ListSchedules método.

Você pode usar a classe XmlSerializer para converter automaticamente sua classe objeto em uma string XML. Para mais informações sobre a classe XmlSerializer, veja "System.Xml.XmlSerializer Class" na documentação do Microsoft .NET Framework.

Se o evento for uma assinatura de atualização snapshot, o valor do MatchData parâmetro deve ser null (Nothing no Visual Basic).