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


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

 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("", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="", ResponseNamespace="", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void SetSubscriptionProperties (string SubscriptionID, ReportService2010.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2010.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 Header Usage (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
纯模式所需的权限Native Mode Required Permissions UpdateAnySubscription 或者 (UpdateSubscription和该用户是此报表的所有者,并且订阅是定时的订阅)UpdateAnySubscription OR (UpdateSubscription AND the user is the report owner and the subscription is a timed subscription)
SharePoint 模式所需的权限SharePoint Mode 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"前面有"+"或"-"符号后, 跟与 UTC 表示为 hh: mm 的差值。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