ReportingService2010.SetSubscriptionProperties メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サブスクリプションのプロパティを設定します。
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
サブスクリプションの ID。
- ExtensionSettings
- ExtensionSettings
デリバリー拡張機能に特有の設定リストを含む ExtensionSettings オブジェクトです。
- Description
- String
ユーザーに表示される意味のある説明。
- EventType
- String
サブスクリプションをトリガーするイベントの種類。
- MatchData
- String
指定されたイベントの種類に関連付けられたデータ。 このデータはイベント処理拡張機能によって使用され、サブスクリプションと発生したイベントを照合します。
- Parameters
- ParameterValue[]
レポートのパラメータリストを含む ParameterValue オブジェクトの配列です。
- 属性
注釈
以下の表は、この操作のヘッダーおよび権限情報を示しています。
| SOAPヘッダーの使用 | (イン) TrustedUserHeaderValue (アウト) ServerInfoHeaderValue |
| ネイティブモードの必要権限 | UpdateAnySubscription または(UpdateSubscription 、ユーザーがレポートの所有者であり、サブスクリプションは期限付きサブスクリプションです) |
| SharePointモードの必要権限 | <xref:Microsoft.SharePoint.SPBasePermissions.ManageAlerts> または(<xref:Microsoft.SharePoint.SPBasePermissions.CreateAlerts> 、ユーザーがサブスクリプション所有者であり、サブスクリプションは時間制限付きサブスクリプションです) |
EventTypeパラメータの値は、レポートサーバー上で設定されたイベント処理拡張に対応しなければなりません。 イベント型がイベント処理拡張で処理されない場合、エラーコード rsInvalidEventとともにSOAP例外がスローされます。 イベントタイプは通知を生成するイベント処理拡張機能によって処理される必要があります。
EventTypeパラメータの値が受信されると、イベント処理拡張がそのイベントが通知を生成するかどうかを問い合わせます。 もしそうでなければ、エラーコード rsEventNonSubscribeableを含むSOAP例外がスローされます。
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」は世紀、「YY」は年、「MM」は月、「DD」は日を表します。 「T」は日付と時間の区切り符、「hh」「mm」「ss」はそれぞれ時、分、秒を表します。 この表現の直後に「Z」を付けて協調宇宙時(UTC)を示すことができます。 標準時を示すために、「Z」の前に「+」または「-」記号が付けられ、UTCとの差はhh:mmで表されます。
TimedSubscriptionのスケジュール定義が共有スケジュールの場合、共有スケジュールのスケジュールIDをMatchDataパラメータとして渡す必要があります。 スケジュールIDは Stringとして渡されます。例えば「4608ac1b-fc75-4149-9e15-5a8b5781b843」などです。 スケジュールIDは ListSchedules メソッドを呼び出して取得できます。
イベントがスナップショット更新サブスクリプションの場合は、MatchDataパラメータをnull(Visual BasicではNothing)に設定します。
SharePointの非管理者ユーザーの「仕事用メール」プロパティは、SharePoint User InformationのTOメール配信拡張機能設定にすべきです