Поделиться через


ReportingService2010.SetSubscriptionProperties Метод

Определение

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

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

Параметры

SubscriptionID
String

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

ExtensionSettings
ExtensionSettings

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

Description
String

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

EventType
String

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

MatchData
String

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

Parameters
ParameterValue[]

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

Атрибуты

Комментарии

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

Использование заголовка SOAP (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Необходимые разрешения в собственном режиме UpdateAnySubscription ИЛИ (UpdateSubscription И пользователь является владельцем отчета, а подписка является подпиской по времени)
Необходимые разрешения в режиме Интеграции с SharePoint <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> ИЛИ (<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> И пользователь является владельцем подписки, а подписка является подпиской по времени)

Значение 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 обновление подписки, задайте для MatchData параметра null значение (Nothing в Visual Basic).

Свойство "Рабочая электронная почта" пользователя SharePoint, не являющегося административным, в сведениях о пользователе SharePoint должно быть параметром модуля доставки по электронной почте TO

Применяется к