ReportingService2010.SetDataDrivenSubscriptionProperties Метод

Ссылка

Определение

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

Сборка:: ReportService2010.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Задает свойства управляемой данными подписки.

public:
 void SetDataDrivenSubscriptionProperties(System::String ^ DataDrivenSubscriptionID, ReportService2010::ExtensionSettings ^ ExtensionSettings, ReportService2010::DataRetrievalPlan ^ DataRetrievalPlan, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2010::ParameterValueOrFieldReference ^> ^ Parameters);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", 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("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void SetDataDrivenSubscriptionProperties (string DataDrivenSubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, ReportService2010.DataRetrievalPlan DataRetrievalPlan, string Description, string EventType, string MatchData, ReportService2010.ParameterValueOrFieldReference[] Parameters);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetDataDrivenSubscriptionProperties", 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("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.SetDataDrivenSubscriptionProperties : string * ReportService2010.ExtensionSettings * ReportService2010.DataRetrievalPlan * string * string * string * ReportService2010.ParameterValueOrFieldReference[] -> unit

Public Sub SetDataDrivenSubscriptionProperties (DataDrivenSubscriptionID As String, ExtensionSettings As ExtensionSettings, DataRetrievalPlan As DataRetrievalPlan, Description As String, EventType As String, MatchData As String, Parameters As ParameterValueOrFieldReference())

Параметры

DataDrivenSubscriptionID: String

Идентификатор подписки, возвращаемый методом CreateDataDrivenSubscription(String, ExtensionSettings, DataRetrievalPlan, String, String, String, ParameterValueOrFieldReference[]).

ExtensionSettings: ExtensionSettings

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

DataRetrievalPlan: DataRetrievalPlan

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

Description: String

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

EventType: String

Тип события, которое вызывает обработку подписки. Допустимые значения TimedSubscription и SnapshotUpdated.

MatchData: String

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

Parameters: ParameterValueOrFieldReference[]

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

Атрибуты: SoapDocumentMethodAttribute SoapHeaderAttribute


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

Для правильной работы управляемой данными подписки источник данных, на который DataRetrievalPlan ссылается объект, должен иметь свойство , для которого CredentialRetrieval задано значение Store.

Объекты Field , содержащиеся в DataSet , проверяются на соответствие полям, сопоставленным с параметрами модуля доставки и значениями параметров отчета. Все поля, на которые ссылаются параметры модуля доставки и значения параметров отчета, также должны быть перечислены в наборе данных.

Проверка не выполняется, чтобы убедиться, что поля, перечисленные в наборе данных, возвращаются запросом доставки. Если поле, перечисленное в наборе данных, не возвращается запросом доставки, сервер отчетов выдает ошибку при обработке подписки.

Значение 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 метод .

Класс XmlSerializer можно использовать для автоматического преобразования класса объекта в xml-строку. Дополнительные сведения о классе XmlSerializer см. в разделе "System.Xml. Класс XmlSerializer" в документации microsoft платформа .NET Framework.

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

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

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

ReportingService2010.SetDataDrivenSubscriptionProperties Метод

Определение

Параметры

Комментарии

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

Дополнительные ресурсы