次の方法で共有

ReportingService2005.SetDataDrivenSubscriptionProperties Method

  • [アーティクル]

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

名前空間: Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005
アセンブリ: ReportService2005 (reportingservice2005.dll 内)

構文

'宣言
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction:=SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("BatchHeaderValue")> _
Public Sub SetDataDrivenSubscriptionProperties ( _
    DataDrivenSubscriptionID As String, _
    ExtensionSettings As ExtensionSettings, _
    DataRetrievalPlan As DataRetrievalPlan, _
    Description As String, _
    EventType As String, _
    MatchData As String, _
    Parameters As ParameterValueOrFieldReference() _
)

[SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out)] 
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
[SoapHeaderAttribute("BatchHeaderValue")] 
public void SetDataDrivenSubscriptionProperties (
    string DataDrivenSubscriptionID,
    ExtensionSettings ExtensionSettings,
    DataRetrievalPlan DataRetrievalPlan,
    string Description,
    string EventType,
    string MatchData,
    ParameterValueOrFieldReference[] Parameters
)

[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction=SoapHeaderDirection::Out)] 
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse::Literal, ParameterStyle=SoapParameterStyle::Wrapped)] 
[SoapHeaderAttribute(L"BatchHeaderValue")] 
public:
void SetDataDrivenSubscriptionProperties (
    String^ DataDrivenSubscriptionID, 
    ExtensionSettings^ ExtensionSettings, 
    DataRetrievalPlan^ DataRetrievalPlan, 
    String^ Description, 
    String^ EventType, 
    String^ MatchData, 
    array<ParameterValueOrFieldReference^>^ Parameters
)

/** @attribute SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) */ 
/** @attribute SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) */ 
/** @attribute SoapHeaderAttribute("BatchHeaderValue") */ 
public void SetDataDrivenSubscriptionProperties (
    String DataDrivenSubscriptionID, 
    ExtensionSettings ExtensionSettings, 
    DataRetrievalPlan DataRetrievalPlan, 
    String Description, 
    String EventType, 
    String MatchData, 
    ParameterValueOrFieldReference[] Parameters
)

SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) 
SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/SetDataDrivenSubscriptionProperties", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) 
SoapHeaderAttribute("BatchHeaderValue") 
public function SetDataDrivenSubscriptionProperties (
    DataDrivenSubscriptionID : String, 
    ExtensionSettings : ExtensionSettings, 
    DataRetrievalPlan : DataRetrievalPlan, 
    Description : String, 
    EventType : String, 
    MatchData : String, 
    Parameters : ParameterValueOrFieldReference[]
)

パラメータ

  • DataDrivenSubscriptionID
    サブスクリプションの ID です。
  • ExtensionSettings
    配信拡張機能固有の設定の一覧を格納した ExtensionSettings オブジェクトです。
  • DataRetrievalPlan
    サブスクリプションの配信クエリからデータを取得するために必要な設定の一覧を格納した DataRetrievalPlan オブジェクトです。
  • Description
    ユーザーに対して表示される説明文です。
  • EventType
    [out] サブスクリプションを開始するイベントの種類です。
  • MatchData
    [out] 指定した種類のイベントに関連付けられているデータです。このデータは、サブスクリプションと発生したイベントの照合のために、イベント処理拡張機能で使用されます。
  • Parameters
    レポートのパラメータの一覧を表す ParameterValue オブジェクトの配列です。

解説

データ ドリブン サブスクリプションを正しく実行するためには、DataRetrievalPlan オブジェクトが参照するデータ ソースの CredentialRetrieval プロパティに Store を設定する必要があります。

DataSet に格納された Field オブジェクトは、配信拡張機能の設定とレポート パラメータ値にマップされるフィールドに対して確認されます。配信拡張機能の設定やレポート パラメータ値で参照されるすべてのフィールドは、データセットでも列挙される必要があります。

データセットで列挙されるフィールドが配信クエリによって返されるかどうかを確認するための検証は行われません。データセットで列挙されるフィールドが配信クエリによって返されない場合は、サブスクリプションの処理時にレポート サーバーでエラーが発生します。

EventType パラメータの値は、レポート サーバーで構成されたイベント処理拡張機能に対応する必要があります。イベントがイベント処理拡張機能で処理されない場合、SOAP 例外がエラー コード rsInvalidEvent でスローされます。イベントは、通知を作成するイベント処理拡張機能で処理される必要があります。EventType パラメータの値を受信すると、イベント処理拡張機能のクエリが実行され、通知を作成するかどうかが決まります。通知を作成しない場合、SOAP 例外がエラー コード rsEventNonSubscribeable でスローされます。

MatchData パラメータの値は、イベントの種類によって異なります。イベントが TimedSubscription イベントである場合は、MatchData パラメータとして ScheduleDefinition オブジェクトが必要です。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 となっており、"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 メソッドを呼び出すことにより取得されます。

XmlSerializer クラスを使用して、オブジェクト クラスを XML 文字列に自動的に変換できます。XmlSerializer クラスの詳細については、Microsoft .NET Framework のドキュメントの「System.Xml.XmlSerializer クラス」を参照してください。

イベントがスナップショット更新サブスクリプションである場合、MatchData パラメータの値は NULL (Visual Basic では Nothing) である必要があります。

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

ReportingService2005 Class
ReportingService2005 Members
Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005 Namespace