ReportingService2005.SetSubscriptionProperties Метод

Определение

Пространство имен:

ReportService2005

Сборка:

ReportService2005.dll

Задает свойства подписки.

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())

Параметры

SubscriptionID

String

Идентификатор подписки.

ExtensionSettings

ExtensionSettings

Объект ExtensionSettings, содержащий список параметров, относящихся к модулю доставки.

Description

String

Понятное описание, выводимое для пользователей.

EventType

String

Тип события, которое вызывает обработку подписки.

MatchData

String

Данные, связанные с указанным типом события. Эти данные используются модулем обработки событий для сопоставления подписки со случившимся событием.

Parameters

ParameterValue[]

Массив объектов ParameterValue, содержащий список параметров для отчета.

Комментарии

В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.

Заголовки SOAP	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Необходимые разрешения	UpdateAnySubscription ИЛИ (UpdateSubscription И пользователь является владельцем отчета, а подписка — подписка по времени)

Значение EventType параметра должно соответствовать модулем обработки событий, настроенному на сервере отчетов. Если тип события не обрабатывается модулем обработки событий, создается исключение SOAP с кодом rsInvalidEventошибки . Тип события должен обрабатываться модулем обработки событий, создающим уведомления. При получении значения параметра EventType запрашивается модуль обработки событий, чтобы определить, создает ли событие уведомления. В противном случае возникает исключение SOAP с кодом rsEventNonSubscribeableошибки .

Значение MatchData параметра зависит от типа события. Если событие является событием TimedSubscription , ScheduleDefinition в качестве MatchData параметра требуется объект . Сначала необходимо сериализовать ScheduleDefinition объект в виде XML, чтобы передать его в виде строкового значения и создать подписку на основе расписания. Структура XML может выглядеть так, как в следующем примере:

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

Значение элемента StartDateTime при передаче в виде СТРОКИ XML должно соответствовать формату даты ISO 8601. Этот международный стандарт даты и времени является расширенным форматом CCYY-MM-DDThh:mm:ss+/-Z, где "CC" представляет столетие, "ГГ" год, "ММ" месяц и "ДД" день. Буква "T" — это разделитель даты и времени, а "чч", "мм", "сс" — часы, минуты и секунды соответственно. За этим представлением может следовать буква "Z", обозначающее время UTC. Чтобы указать часовой пояс, представленный как разница между местным временем и универсальным координированным временем, "Z" предшествует знак "+" или "-", за которым следует различие от UTC, представленное чч:мм.

Если определение расписания для TimedSubscription является общим расписанием, необходимо передать идентификатор общего расписания в MatchData качестве параметра. Идентификатор расписания передается в виде String, например 4608ac1b-fc75-4149-9e15-5a8b5781b843. Идентификатор расписания можно получить, вызвав ListSchedules метод .

Если событие является подпиской snapshot обновления, задайте для параметра MatchDatanull значение (Nothing в Visual Basic).