ReportingService2005.SetSubscriptionProperties Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define as propriedades de uma assinatura.
public:
void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValue ^> ^ Parameters);
public void SetSubscriptionProperties (string SubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2005.ParameterValue[] Parameters);
member this.SetSubscriptionProperties : string * ReportService2005.ExtensionSettings * string * string * string * ReportService2005.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
A ID da assinatura.
- ExtensionSettings
- ExtensionSettings
Um objeto ExtensionSettings que contém uma lista de configurações específicas à extensão de entrega.
- Description
- String
Uma descrição significativa exibida aos usuários.
- EventType
- String
O tipo de evento que dispara a assinatura.
- MatchData
- String
Os dados associados ao tipo de evento especificado. Esses dados são usados por um evento que está processando a extensão para corresponder a assinatura com um evento acionado.
- Parameters
- ParameterValue[]
Uma matriz de objetos ParameterValue que contém uma lista de parâmetros para o relatório.
Comentários
A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.
Cabeçalhos SOAP | (In) BatchHeaderValue (Out) ServerInfoHeaderValue |
Permissões necessárias | UpdateAnySubscription OR (UpdateSubscription E o usuário é o proprietário do relatório e a assinatura é uma assinatura cronometrada) |
O valor do EventType
parâmetro deve corresponder a uma extensão de processamento de eventos configurada no servidor de relatório. Se o tipo de evento não for tratado por uma extensão de processamento de eventos, uma exceção SOAP será gerada com o código rsInvalidEvent
de erro . O tipo de evento deve ser tratado 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 o evento cria notificações. Se isso não acontecer, uma exceção SOAP será gerada com o código rsEventNonSubscribeable
de erro .
O valor do MatchData
parâmetro depende do tipo de evento. Se o evento for um evento TimedSubscription , um ScheduleDefinition objeto será necessário como o MatchData
parâmetro . Primeiro, você deve serializar o ScheduleDefinition objeto como XML para passá-lo como um valor de cadeia de caracteres e criar uma assinatura com base no agendamento. A estrutura XML pode ser semelhante à 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 cadeia de caracteres 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 em que "CC" representa o século, "AAAA" o ano, "MM" o mês e "DD" do 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 seguida imediatamente por um "Z" para indicar UTC (Tempo Universal Coordenado). Para indicar o fuso horário, representado como a diferença entre a hora local e o Tempo Universal Coordenado, "Z" é precedido por um sinal "+" ou "-", seguido pela diferença do UTC representado como hh:mm.
Se a definição de agenda para uma TimedSubscription for uma agenda compartilhada, você deverá passar a ID de agendamento da agenda compartilhada como o MatchData
parâmetro . A ID do agendamento é passada como um String
, por exemplo, "4608ac1b-fc75-4149-9e15-5a8b5781b843". A ID de agendamento pode ser obtida chamando o ListSchedules método .
Se o evento for uma assinatura de atualização instantâneo, defina MatchData
o parâmetro como null
(Nothing
no Visual Basic).