ReportingService2005.SetSubscriptionProperties メソッド

リファレンス

定義

名前空間:: ReportService2005

アセンブリ:: ReportService2005.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

サブスクリプションのプロパティを設定します。

public:
 void SetSubscriptionProperties(System::String ^ SubscriptionID, ReportService2005::ExtensionSettings ^ ExtensionSettings, System::String ^ Description, System::String ^ EventType, System::String ^ MatchData, cli::array <ReportService2005::ParameterValue ^> ^ Parameters);

public void SetSubscriptionProperties (string SubscriptionID, ReportService2005.ExtensionSettings ExtensionSettings, string Description, string EventType, string MatchData, ReportService2005.ParameterValue[] Parameters);

member this.SetSubscriptionProperties : string * ReportService2005.ExtensionSettings * string * string * string * ReportService2005.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 ヘッダー	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
必要なアクセス許可	UpdateAnySubscription または (UpdateSubscription、およびユーザーがレポートの所有者であり、サブスクリプションが時刻指定のサブスクリプションであること)

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>

XML 文字列として渡されたときの StartDateTime 要素の値は、日付形式 ISO 8601 に対応している必要があります。この国際日時標準は拡張形式 CCYY-MM-DDThh:mm:ss+/-Z となっており、"CCYY" が年、"MM" が月、"DD" が日を表します。文字 "T" は日付と時刻の区切り記号で、"hh"、"mm"、"ss" はそれぞれ時間、分、秒を表します。協定世界時 (UTC) を表す場合には、すぐ後ろに "Z" を付けます。ローカル時刻と協定世界時の差でタイムゾーンを示すには、"Z" の前に "+"記号か "-" 記号を付け、"Z" の後ろに UTC との差を hh:mm の形式で表します。

TimedSubscription のスケジュール定義が共有スケジュールの場合は、共有スケジュールのスケジュール ID をパラメーターとしてMatchData渡す必要があります。スケジュール ID は、"4608ac1b-fc75-4149-9e15-5a8b5781b843" のように、String として渡されます。スケジュール ID は、ListSchedules メソッドを呼び出すことにより取得されます。

イベントがスナップショット更新サブスクリプションである場合は、MatchData パラメーターに null (Visual Basic では Nothing) を設定します。

適用対象

ReportingService2005.SetSubscriptionProperties メソッド

定義

パラメーター

注釈

適用対象

その他のリソース