ReportingService2006.SetSubscriptionProperties(String, ExtensionSettings, String, String, String, ParameterValue[]) ReportingService2006.SetSubscriptionProperties(String, ExtensionSettings, String, String, String, ParameterValue[]) Method


设置订阅的属性。 Sets the properties of a subscription.

 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2006::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2006::ParameterValue ^> ^ Parameters);
public void SetSubscriptionProperties (string SubscriptionID, ReportService2006.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2006.ParameterValue[] Parameters);


String String

订阅的 ID。 The ID of the subscription.

ExtensionSettings ExtensionSettings
ExtensionSettings对象,其中包含特定于传递扩展插件的设置的列表。 An ExtensionSettings object that contains a list of settings that are specific to the delivery extension.
String String

向用户显示的贴切描述。 A meaningful description that is displayed to users.

String String

触发订阅的事件的类型。 The type of event that triggers the subscription.

String String

与指定类型的事件关联的数据。 The data that is associated with the specified type of event. 此数据由事件处理扩展插件使用,用来将订阅与已经激发的事件进行匹配。 This data is used by an event processing extension to match the subscription with an event that has fired.


一个数组ParameterValue包含的报表的参数列表的对象。 An array of ParameterValue objects that contains a list of parameters for the report.


下表显示了有关此操作的标头和权限信息。The table below shows header and permissions information on this operation.

SOAP 标头SOAP Headers (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
所需的权限Required Permissions ManageAlerts 或者 (CreateAlerts且用户是订阅所有者、 订阅为定时的订阅)ManageAlerts OR (CreateAlerts AND the user is the subscription owner and the subscription is a timed subscription)

EventType参数必须对应于一种事件处理在报表服务器配置的扩展。The value of the EventType parameter must correspond to an event processing extension that is configured on the report server. 如果事件类型不由一个事件处理扩展插件处理的并提供错误代码引发 SOAP 异常rsInvalidEventIf the event type is not handled by an event processing extension, a SOAP exception is thrown with the error code rsInvalidEvent. 必须由一种事件处理扩展插件创建通知处理的事件类型。The event type must be handled by an event processing extension that creates notifications. 值时EventType收到参数时,事件处理扩展插件进行查询,以确定事件是否创建通知。When a value for the EventType parameter is received, the event processing extension is queried to determine whether the event creates notifications. 如果未显示,并提供错误代码引发 SOAP 异常rsEventNonSubscribeableIf it does not, a SOAP exception is thrown with the error code rsEventNonSubscribeable.

MatchData参数取决于事件类型。The value of the MatchData parameter depends on the event type. 如果该事件TimedSubscription事件,ScheduleDefinition对象是必需的因为MatchData参数。If the event is a TimedSubscription event, a ScheduleDefinition object is required as the MatchData parameter. 您必须首先进行序列化ScheduleDefinition对象作为 XML 以便将其作为一个字符串值传递并创建订阅基于计划。You must first serialize the ScheduleDefinition object as XML in order to pass it as a string value and create a subscription based on the schedule. XML 结构可能类似于下面的示例所示:The XML structure might resemble the one in the following example:


StartDateTime元素作为 XML 字符串传递时应该对应于 ISO 8601 的日期格式。The value of the StartDateTime element when it is passed as an XML string should correspond to the date format ISO 8601. 此国际日期和时间标准是扩展的格式 CCYY-MM-DDThh:mm:ss + /-其中"CC"表示世纪,"YY"年份"MM"每月的 Z 和"DD"一天。This international date and time standard is the extended format CCYY-MM-DDThh:mm:ss+/-Z where "CC" represents the century, "YY" the year, "MM" the month and "DD" the day. 字母"T"的日期和时间分隔符,"hh"、"mm"、"ss"表示小时、 分钟和分别的第二个。The letter "T" is the date and time separator and "hh", "mm", "ss" represent hour, minute and second respectively. 这种表示形式可以被其后紧接"Z"指示协调世界时 (UTC)。This representation can be immediately followed by a "Z" to indicate Coordinated Universal Time (UTC). 若要指示时区,表示为本地时间和协调世界时之间的区别"Z"的前面有"+"或"-"号后, 跟表示为 hh: mm 的与 UTC 的差异。To indicate the time zone, represented as the difference between the local time and Coordinated Universal Time, "Z" is preceded by a "+" or "-" sign, followed by the difference from UTC represented as hh:mm.

如果计划定义TimedSubscription是共享的计划,必须通过为该共享计划的计划 IDMatchData参数。If the schedule definition for a TimedSubscription is a shared schedule, you must pass the schedule ID of the shared schedule as the MatchData parameter. 作为传递 ID 的计划String,例如,"4608ac1b-fc75-4149-9e15-5a8b5781b843"。The schedule ID is passed as a String, for example, "4608ac1b-fc75-4149-9e15-5a8b5781b843". 可以通过调用获取 ID 的计划ListSchedules方法。The schedule ID can be obtained by calling the ListSchedules method.

如果快照更新订阅事件,则设置MatchData参数null(Nothing在 Visual Basic 中)。If the event is a snapshot update subscription, set MatchData parameter to null (Nothing in Visual Basic).

SharePoint 非管理用户在其 SharePoint 用户信息中的工作电子邮件属性应为收件人电子邮件传递扩展插件设置A SharePoint non-administrative user’s ‘Work e-mail’ property in their SharePoint User Information should be the TO e-mail delivery extension setting