Compartilhar via


ReportingService2010.SetSubscriptionProperties Método

Definição

Define as propriedades de uma assinatura.

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

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.

Atributos

Comentários

A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.

Uso do cabeçalho SOAP (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Permissões necessárias do modo nativo UpdateAnySubscription OR (UpdateSubscription E o usuário é o proprietário do relatório e a assinatura é uma assinatura cronometrada)
Permissões necessárias do modo do SharePoint <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> OR (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> E o usuário é o proprietário da assinatura 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 rsInvalidEventde 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 rsEventNonSubscribeablede erro .

O valor do MatchData parâmetro depende do tipo de evento. Se o evento for um TimedSubscription evento, 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 StartDateTime elemento quando ele é 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, "YY" 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 de UTC representada como hh:mm.

Se a definição de agendamento de um TimedSubscription for uma agenda compartilhada, você deverá passar a ID de agendamento do agendamento compartilhado 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).

A propriedade "Email de trabalho" de um usuário não administrativo do SharePoint em suas Informações de Usuário do SharePoint deve ser a configuração de extensão de entrega de email TO

Aplica-se a