BizTalk Serverと Siebel アダプターを使用して、候補リスト フィールドを使用してビジネス コンポーネントに対する操作を実行する
Siebel picklist フィールド型は、クライアントが Siebel システムに渡される特定の値を指定できる使用可能な値のコレクションを構成します。 つまり、選択リスト フィールドには、フィールドに対して受け入れられる値のリストが含まれます。 picklist とその型の詳細については、Siebel のドキュメントを参照してください。 Siebel アダプターが選択リスト フィールドを持つビジネス コンポーネントに対する操作をサポートする方法の詳細については、「 Siebel のビジネス コンポーネントに対する操作」を参照してください。
静的な境界付き選択リスト フィールド (選択リストの一種) を含むビジネス コンポーネントのメタデータを生成すると、選択リストに対して受け入れられる値もメタデータの一部として公開されます。 選択リスト フィールドに値を挿入する場合は、メタデータにパブリッシュされる値を指定する必要があります。
選択リスト 項目を使用してビジネス コンポーネントに対して操作を実行する方法
BizTalk Serverを使用して Siebel アダプターを使用して Siebel システムで操作を実行するには、「Siebel アダプターを使用して BizTalk アプリケーションを作成するための構成要素」で説明されている手続き型タスクが含まれます。
選択リスト フィールドを使用してビジネス コンポーネントに対する操作を完了するには、次のタスクを実行します。
BizTalk プロジェクトを作成し、選択リスト フィールドを含むビジネス コンポーネントに対して操作を実行するスキーマを生成します。
Siebel システムからメッセージを送受信するためのメッセージを BizTalk プロジェクトに作成します。
Siebel システムで操作を呼び出すオーケストレーションを作成します。
BizTalk プロジェクトをビルドして展開します。
物理送受信ポートを作成して BizTalk アプリケーションを構成します。
BizTalk アプリケーションを起動します。
このトピックでは、これらのタスクを実行する手順について説明します。
このトピックに基づくサンプル
このトピックに基づくサンプル SiebelPicklist は、BizTalk アダプター パックでも提供されています。 詳細については、「 Siebel アダプターのサンプル」を参照してください。
スキーマの生成
このトピックでは、選択リスト フィールドを使用してビジネス コンポーネントに対する操作を呼び出す方法を示すために、Account ビジネス コンポーネントの挿入操作のスキーマを生成します。 Account ビジネス コンポーネントには、静的な選択リスト (アンケートの種類) があります。
スキーマの生成方法の詳細については、「 Visual Studio での Siebel 操作のメタデータの取得 」を参照してください。
Account ビジネス コンポーネントの挿入操作のメタデータを生成すると、選択リスト フィールドとその可能な値を含む個別の .xsd ファイルが取得されます。 .xsd には、 Survey Type を含む静的ピックリストの値のみが含まれていることに注意してください。
メッセージとメッセージの種類の定義
前に生成したスキーマでは、オーケストレーション内のメッセージに必要な "型" について説明します。 通常、メッセージは変数であり、対応するスキーマによって定義される型です。 最初の手順で生成したスキーマを、BizTalk プロジェクトのオーケストレーション ビューからメッセージにリンクする必要があります。
このトピックでは、2 つのメッセージ (1 つは Siebel システムに要求を送信し、もう 1 つは応答を受信するメッセージ) を作成する必要があります。
メッセージを作成し、スキーマにリンクするには、次の手順を実行します。
メッセージを作成し、スキーマにリンクするには
まだ開いていない場合は、BizTalk プロジェクトをオーケストレーション ビューで開きます。 [ 表示] をクリックし、[ その他のウィンドウ] をポイントして、[ オーケストレーション ビュー] をクリックします。
オーケストレーション ビューで、[メッセージ] を右クリックし、[新しいメッセージ] をクリックします。
新しく作成したメッセージを右クリックし、[ プロパティ ウィンドウ] を選択します。
Message_1の [プロパティ] ウィンドウで、次の操作を行います。
プロパティ 目的 識別子 「 Request」と入力します。 メッセージ型 ドロップダウン リストから [ スキーマ] を展開し、 SiebelPicklist.SiebelBindingSchema.Insert を選択します。 ここで、SiebelPicklist は BizTalk プロジェクトの名前です。 SiebelBindingSchema は、アカウント ビジネス コンポーネントに対する挿入操作を呼び出すためのスキーマです。 前の手順を繰り返して、新しいメッセージを作成します。 新しいメッセージの [プロパティ ] ウィンドウで、次の操作を行います。
プロパティ 目的 識別子 「 Response」と入力します。 メッセージ型 ドロップダウン リストから [ スキーマ] を展開し、[ SiebelPicklist.SiebelBindingSchema.InsertResponse] を選択します。
オーケストレーションの設定
選択リスト フィールドを持つ Siebel ビジネス コンポーネントに対して挿入操作を実行するためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。 このオーケストレーションでは、定義された受信場所に要求メッセージをドロップします。 Siebel アダプターはこのメッセージを使用し、それを Siebel システムに渡します。 Siebel システムからの応答は、別の場所に保存されます。 Siebel ビジネス コンポーネントに対して操作を実行するための一般的なオーケストレーションには、次のものが含まれます。
図形を送受信して、Siebel にメッセージを送信し、応答を受信します。
Siebel に送信する要求メッセージを受信する一方向の受信ポート。
要求メッセージを Siebel に送信し、応答を受信する双方向送信ポート。
Siebel からフォルダーに応答を送信する一方向送信ポート。
アカウント ビジネス コンポーネントに対する挿入操作のサンプル オーケストレーションは、次のようになります。
Siebel の
メッセージ図形の追加
メッセージ図形ごとに次のプロパティを指定してください。 [図形] 列に表示される名前は、上記のオーケストレーションに表示されるメッセージ図形の名前です。
| 図形 | 図形の種類 | プロパティ |
|---|---|---|
| ReceiveXML | 受信 | - 名前を ReceiveXML に設定する - アクティブ化を True に設定する |
| SendToLOB | Send | - [名前] を SendToLOB に設定する |
| ReceiveResponse | 受信 | - 名前を ReceiveResponse に設定する - アクティブ化を False に設定する |
| SendResponse | Send | - 名前を SendResponse に設定する |
ポートの追加
論理ポートごとに次のプロパティを指定してください。 [ ポート ] 列に表示される名前は、オーケストレーションに表示されるポートの名前です。
| Port | プロパティ |
|---|---|
| FileIn | - 識別子を FileIn に設定する - Type を FileInType に設定する - 通信パターンを一方向に設定する - 通信方向を受信に設定する |
| LOBPort | - 識別子を LOBPort に設定する - 型を LOBPortType に設定する - 通信パターンを Request-Response に設定する - [通信の方向] を [送受信] に設定する |
| SaveResponse | - 識別子を SaveResponse に設定する - Type を SaveResponseType に設定する - 通信パターンを一方向に設定する - [通信の方向] を [送信] に設定する |
アクション図形のメッセージを指定し、ポートに接続する
次の表では、アクション図形のメッセージを指定し、ポートにリンクするために設定するプロパティとその値を指定します。 [図形] 列に表示される名前は、上記のオーケストレーションに表示されるメッセージ図形の名前です。
| 図形 | プロパティ |
|---|---|
| ReceiveXml | - メッセージを要求に設定する - 操作を FileIn.Picklist.Request に設定する |
| SendToLOB | - メッセージを要求に設定する - 操作を LOBPort.Picklist.Request に設定する |
| ReceiveResponse | - [メッセージ] を [応答] に設定する - 操作を LOBPort.Picklist.Response に設定する |
| SendResponse | - [メッセージ] を [応答] に設定する - 操作を SaveResponse.Picklist.Request に設定する |
これらのプロパティを指定すると、メッセージの図形とポートが接続され、オーケストレーションが完了します。
BizTalk ソリューションをビルドし、BizTalk Serverに展開する必要があります。 詳細については、「 オーケストレーションをビルドする方法 」および「 Visual Studio から BizTalk アプリケーションに BizTalk アセンブリを展開する」を参照してください。
BizTalk アプリケーションの構成
BizTalk プロジェクトを展開すると、前に作成したオーケストレーションが、BizTalk Server管理コンソールの [オーケストレーション] ウィンドウの下に一覧表示されます。 アプリケーションを構成するには、BizTalk Server管理コンソールを使用する必要があります。 アプリケーションの構成の詳細については、「アプリケーション を作成する方法」を参照してください。
アプリケーションの構成には、次の作業が含まれます。
アプリケーションのホストの選択。
オーケストレーションで作成したポートを、BizTalk Server管理コンソールの物理ポートにマッピングします。 このオーケストレーションでは、次の操作を行う必要があります。
ハード ディスク上の場所と、要求メッセージを削除する対応するファイル ポートを定義します。 BizTalk オーケストレーションは要求メッセージを使用し、Siebel システムに送信します。
ハード ディスク上の場所と、BizTalk オーケストレーションが Siebel システムからの応答を含む応答メッセージを削除する対応するファイル ポートを定義します。
物理 WCF-Custom を定義するか、Siebel システムにメッセージを送信するポートを送信 WCF-Siebel。 また、送信ポートでアクションを指定する必要があります。 ポートを作成する方法については、「 Siebel アダプターへの物理ポート バインドを手動で構成する」を参照してください。
Note
アダプター サービス BizTalk プロジェクト アドインを使用してスキーマを生成すると、ポートとそれらのポートに設定するアクションに関する情報を含むバインド ファイルも作成されます。 BizTalk 管理コンソールからこのバインド ファイルをインポートして、送信ポートを作成できます (送信呼び出し用)。 詳細については、「 siebel へのポート バインド ファイルを使用して物理ポート バインドを構成する」を参照してください。
アプリケーションの起動
Siebel のアカウント ビジネス コンポーネントに対して挿入操作を実行するには、BizTalk アプリケーションを起動する必要があります。 BizTalk アプリケーションを起動する手順については、「BizTalk アプリケーション を起動 する」または「 オーケストレーションを開始する」を参照してください。
この段階で、次のことを確認します。
オーケストレーションの要求メッセージを受信する FILE 受信ポートが実行されています。
オーケストレーションから応答メッセージを受信する FILE 送信ポートが実行されています。
Siebel システムにメッセージを送信するための WCF-Custom または WCF-Siebel 送信ポートが実行されている
操作の BizTalk オーケストレーションが実行されている
操作の実行
要求メッセージを FILE 受信場所にドロップする必要があります。 要求メッセージのスキーマは、このトピックで前に生成したスキーマに準拠している必要があります。 要求 メッセージのスキーマの詳細については、「ビジネス コンポーネント操作 のメッセージ スキーマ」を参照してください。
選択リスト フィールドに値を挿入するには、生成されたスキーマを調べて、選択リストで許容される値の一覧を確認します。 要求メッセージに、選択リスト フィールドに値を挿入する要素があることを確認します。 たとえば、アンケート の種類 の選択リストに値を挿入するには、要求メッセージに次の要素が含まれている必要があります。
<Survey_x0020_Type>1</Survey_x0020_Type>
ここで、"1" は[アンケートの種類] 選択リストに許容される値です。
候補リスト パラメーターを含む要求メッセージの例を次に示します。
<Insert xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Operation">
<ArrayOfAccountInsertRecord>
<AccountInsertRecord xmlns="http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects">
<Currency_x0020_Code>usd</Currency_x0020_Code>
<Current_x0020_Volume>9</Current_x0020_Volume>
<Customer_x0020_Account_x0020_Group>Sold-To Party</Customer_x0020_Account_x0020_Group>
<Location>Location_1</Location>
<Main_x0020_Phone_x0020_Number>4256543212</Main_x0020_Phone_x0020_Number>
<Name>Name_Surname</Name>
<Party_x0020_Name>test_party</Party_x0020_Name>
<Primary_x0020_Address_x0020_Id>1212 street</Primary_x0020_Address_x0020_Id>
<Survey_x0020_Type>1</Survey_x0020_Type>
</AccountInsertRecord>
</ArrayOfAccountInsertRecord>
</Insert>
オーケストレーションは要求メッセージを使用し、それを Siebel システムに渡します。 Siebel システムからの応答は、オーケストレーションの一部として定義されている他の FILE の場所に保存されます。
Note
選択リストに無効な値を挿入することもできます。 その場合は、 を取得する TargetSystemException必要があります。
考えられる例外
BizTalk Serverを使用して選択リスト フィールドを含むビジネス コンポーネントに対して操作を実行するときに発生する可能性がある例外については、「Siebel アダプターでの例外とエラー処理」を参照してください。
ベスト プラクティス
BizTalk プロジェクトを展開して構成したら、バインド ファイルと呼ばれる XML ファイルに構成設定をエクスポートできます。 バインド ファイルを生成したら、同じオーケストレーションに対して送信ポートや受信ポートなどを作成する必要がないように、ファイルから構成設定をインポートできます。 バインド ファイルの詳細については、「 Siebel アダプターでのアダプター バインドの再利用」を参照してください。