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