BizTalk Serverを使用して SAP で BAPI トランザクションを実行する

[アーティクル]
05/04/2023

SAP アダプターを使用すると、アダプタークライアントは、BizTalk Serverを使用して SAP システムでトランザクションを実行できます。トランザクションのオーケストレーションを作成する前に、まずトランザクションが実行される基本的なシナリオを理解しておく必要があります。一般的なトランザクションシナリオでは、複数の操作 (BAPI の呼び出しなど) を含む要求メッセージが SAP システムに送信されます。これは"操作メッセージ" と呼ばれます。オーケストレーションでは、要求メッセージから各操作メッセージを抽出し、個々の操作メッセージを SAP システムに送信する必要があります。オーケストレーションは、同じ接続を使用して 1 つずつ送信します。オーケストレーションは、BizTalk マップを介した XML 変換を使用して、"操作メッセージ" から個々のメッセージを抽出します。

操作が実行された後、オーケストレーションは、それぞれBAPI_TRANSACTION_COMMITまたはBAPI_TRANSACTION_ROLLBACKのメッセージを送信して、トランザクションをコミットまたは中止する必要があります。これらは"トランザクションメッセージ" と呼ばれます。

アダプターは、BizTalk Serverを介してトランザクションを有効にする方法

BizTalk Serverを使用して SAP システムでトランザクションを有効にするには、SAP アダプターを使用します。

メッセージコンテキストプロパティ OPEN、REUSE、CLOSE、ABORT を提供します。
BAPI_TRANSACTION_COMMITとBAPI_TRANSACTION_ROLLBACKを使用して、操作をコミットまたは中止します。これらは SAP システムによって公開されます。

次の表に、BAPI_TRANSACTION_COMMITまたはBAPI_TRANSACTION_ROLLBACKでプロパティを使用する場合のガイドラインをいくつか示します。

Message	OPEN	再利用	CLOSE	ABORT
最初のメッセージ (操作メッセージ)	はい	いいえ	いいえ	いいえ
後続のメッセージ (操作メッセージ)	いいえ	はい	いいえ	いいえ
BAPI_TRANSACTION_COMMIT (トランザクションメッセージ)	いいえ	いいえ	はい	いいえ
BAPI_TRANSACTION_ROLLBACK (トランザクションメッセージ)	いいえ	いいえ	はい	はい

テーブルの "Yes" は、メッセージに使用されるメッセージコンテキストプロパティを示します。同様に、"いいえ" は、メッセージと共に使用されないメッセージコンテキストプロパティを示します。

テーブルを要約するには:

最初のメッセージは常に操作メッセージである必要があり、OPEN プロパティのみを使用する必要があります。
後続の操作メッセージでは、REUSE プロパティを使用する必要があります。
トランザクションをコミットするためのBAPI_TRANSACTION_COMMITに対応するトランザクションメッセージでは、CLOSE プロパティを使用する必要があります。
トランザクションを中止するBAPI_TRANSACTION_ROLLBACKに対応するトランザクションメッセージでは、CLOSE プロパティまたは ABORT プロパティを使用できます。 ABORT を使用する場合は、メッセージがオーケストレーション例外ブロックに含まれている必要があるのが理想的です。

オーケストレーションに複数の送信ポートがある場合、アダプターは各ポートから受信したメッセージのトランザクションを自動的に分離します。つまり、トランザクションは複数のポートにまたがることはできません。
メッセージ再試行は、SAP トランザクション内のメッセージではサポートされていません。したがって、ユーザーはメッセージ再試行をゼロに設定する必要があります。
アダプターでは、前の表で "いいえ" とマークされた組み合わせに対して望ましくない結果が生成される場合があります。 "はい" としてマークされた組み合わせを使用する必要があります。
メッセージコンテキストプロパティを持たないアダプターに送信されたメッセージは、現在のトランザクションコンテキストにバインドされずに正常に実行されます。
BAPI_TRANSACTION_COMMITまたはBAPI_TRANSACTION_ROLLBACKは、オーケストレーション内の現在のトランザクションコンテキストの最後のメッセージであることが理想的です。

次のセクションでは、SAP アダプターを使用して SAP でトランザクションを実行する方法について説明します。

SAP システムでトランザクションを実行する方法

BizTalk Serverを使用して SAP アダプターを使用して SAP システムで操作を実行するには、「SAP アプリケーションを作成するための構成要素」で説明されている手続き型タスクが含まれます。 SAP システムでトランザクションを実行するには、次のタスクを実行します。

BizTalk プロジェクトを作成し、トランザクションを実行する RFC のスキーマを生成します。さらに、BAPI_TRANSACTION_COMMITおよびBAPI_TRANSACTION_ROLLBACK RFC のスキーマを生成する必要があります。
SAP システムからメッセージを送受信するためのメッセージを BizTalk プロジェクトに作成します。
要求メッセージから個々の "操作メッセージ" を抽出して SAP システムに送信するオーケストレーションを作成します。要求メッセージに基づいて、オーケストレーションはトランザクションをコミットするかロールバックするかを決定します。
BizTalk プロジェクトをビルドして展開します。
物理送受信ポートを作成して BizTalk アプリケーションを構成します。
BizTalk アプリケーションを起動します。

このトピックでは、これらのタスクを実行する手順について説明します。

このトピックに基づくサンプル

このトピックに基づくサンプル SAPTransaction は、BizTalk アダプターパックで提供されています。詳細については、「 SAP アダプターのサンプル」を参照してください。

スキーマの生成

SAP システムでトランザクションを実行する方法を示すには、次のスキーマが必要です。

"操作メッセージ" が SAP システムで操作を実行する場合。アダプターに送信される要求メッセージは、このスキーマに準拠している必要があります。これには、任意の数の操作ノードを含む任意のユーザー固有のスキーマを指定できます。このトピックでは、MultipleOrders.xsd スキーマを使用します。スキーマは、BizTalk アダプターパックサンプルに付属しているトランザクションサンプルの一部としても提供されます。詳細については、「スキーマサンプル」を参照してください。
RFC の呼び出しなど、SAP システムで操作を実行する場合。操作を実行するための要求メッセージは、このスキーマに準拠している必要があります。このスキーマは、アダプターサービス BizTalk プロジェクトアドインを使用して生成する必要があります。このトピックでは、BAPI_SALESORDER_CREATEFROMDAT2 RFC が呼び出されます。 RFC のスキーマの生成の詳細については、「 SAP での RFC 操作のメタデータの参照、検索、取得」を参照してください。
トランザクションを中止またはコミットする場合。トランザクションをコミットまたは中止する要求は、このスキーマに準拠している必要があります。 SAP アダプターは、BAPI_TRANSACTION_COMMITとBAPI_TRANSACTION_ROLLBACK RFC を使用して、それぞれ操作をコミットおよびロールバックします。アダプターサービスアドインを使用して、これらの RFC のスキーマを生成する必要があります。

Note

必要なすべてのスキーマが BizTalk プロジェクトに追加されていることを確認する必要があります。

重要

SAP アダプターの BizTalk プロパティスキーマへの参照を BizTalk プロジェクトに追加する必要があります。スキーマファイル Microsoft.Adapters.SAP.BiztalkPropertySchema.dllは、BizTalk アダプターパックのセットアップによってインストールされます。通常 <はインストールドライブ>:\Program Files\Microsoft BizTalk Adapter Pack\bin にあります。

メッセージとメッセージの種類の定義

前に生成したスキーマでは、オーケストレーション内のメッセージに必要な "型" について説明します。通常、メッセージは変数であり、対応するスキーマによって定義される型です。最初の手順で生成したスキーマを、BizTalk プロジェクトの [オーケストレーションビュー] ウィンドウからメッセージにリンクする必要があります。

メッセージを作成する前に、要求メッセージ (MultipleOrders.xsd 型の) に含まれる "操作" ノードの数を決定する必要があります。この例では、要求メッセージに、BAPI_SALESORDER_CREATEFROMDAT2 RFC を呼び出す 2 つの操作メッセージがあるとします。したがって、この RFC 用に生成されたスキーマにマップする要求/応答メッセージセットを 1 つ作成する必要があります。

BizTalk プロジェクトで次のメッセージを作成する必要があります。

オーケストレーションに送信される要求メッセージのメッセージ SendtoAdapter。このメッセージは、入力メッセージ MultipleOrders.xsd のスキーマにマップする必要があります。
SAP システムに送信される最初の操作のメッセージ BAPIMessage。また、最初の操作の応答に対する応答メッセージ BAPIResponse も作成する必要があります。要求メッセージと応答メッセージは、BAPI_SALESORDER_CREATEFROMDAT2 RFC 用に生成されたスキーマにマップする必要があります。
コミット操作のメッセージ BAPICommitMessage。対応する応答メッセージの応答メッセージ BAPICommitResponse も作成する必要があります。要求メッセージと応答メッセージは、RFC のスキーマBAPI_TRANSACTION_COMMITマップする必要があります。
ロールバック操作のメッセージ BAPIRollbackMessage。対応する応答メッセージの応答メッセージ BAPIRollbackResponse も作成する必要があります。要求メッセージと応答メッセージは、RFC のスキーマBAPI_TRANSACTION_ROLLBACKマップする必要があります。

メッセージを作成し、スキーマにリンクするには、次の手順を実行します。

メッセージを作成し、スキーマにリンクするには

BizTalk プロジェクトがまだ開いていない場合は、オーケストレーションビューを開きます。 [ 表示] をクリックし、[ その他のウィンドウ] をポイントして、[ オーケストレーションビュー] をクリックします。
オーケストレーションビューで、[メッセージ] を右クリックし、[新しいメッセージ] をクリックします。
新しく作成したメッセージを右クリックし、[ プロパティウィンドウ] を選択します。

Message_1の [プロパティ] ウィンドウで、次の操作を行います。

プロパティ	目的
識別子	「 SendToAdapter」と入力します。
メッセージ型	ドロップダウンリストから [ スキーマ] を展開し、[ SAPTransaction.MultipleOrders] を選択します。ここで、 SAPTransaction は BizTalk プロジェクトの名前です。 MultipleOrders は、要求メッセージのスキーマです。

前の手順を繰り返して、さらに 6 つのメッセージを作成します。新しいメッセージの [プロパティ ] ウィンドウで、次の操作を行います。

識別子をに設定する	メッセージの種類をに設定する
BAPIMessage	SAPTransaction.SAPBindingSchema.BAPI_SALESORDER_CREATEFROMDAT2
BAPIResponse	SAPTransaction.SAPBindingSchema.BAPI_SALESORDER_CREATEFROMDAT2Response
BAPICommitMessage	SAPTransaction.SAPBindingSchema.BAPI_TRANSACTION_COMMIT
BAPICommitResponse	SAPTransaction.SAPBindingSchema.BAPI_TRANSACTION_COMMITResponse
BAPIRollbackMessage	SAPTransaction.SAPBindingSchema.BAPI_TRANSACTION_ROLLBACK
BAPIRollbackResponse	SAPTransaction.SAPBindingSchema.BAPI_TRANSACTION_ROLLBACKResponse

オーケストレーションの設定

SAP システムでトランザクションを実行するためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。このオーケストレーションでは、定義された受信場所に要求メッセージをドロップします。 SAP アダプターはメッセージを使用し、それを SAP システムに渡します。 SAP システムからの応答は、別の場所に保存されます。

オーケストレーションの作成時に考慮すべきもう 1 つの考慮事項は、次のとおりです。

要求メッセージのスキーマを、BAPI_SALESORDER_CREATEFROMDAT2 RFC のスキーマにマップします。
要求メッセージのスキーマをBAPI_TRANSACTION_COMMITのスキーマにマップし、RFC BAPI_TRANSACTION_ROLLBACKします。

スキーマをマップするには、BizTalk マップを介して XML 変換を使用します。これを実現するには、オーケストレーションに Transform 図形を含めます。

最後に、要求メッセージにトランザクションをコミットまたは中止するための情報があるかどうかに基づいて、オーケストレーションは SAP システムに送信する適切なメッセージを決定する必要があります。これを実現するには、オーケストレーションに [決定] 図形を含めます。

オーケストレーションに含まれるさまざまな図形の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスのオーケストレーション Designer UI に関するページを参照してください。

SAP トランザクションのサンプルオーケストレーションは、次のようになります。

SAP

メッセージ図形の追加

メッセージ図形ごとに次のプロパティを指定してください。 [図形] 列に表示される名前は、前のオーケストレーションに表示されるメッセージ図形の名前です。

図形	図形の種類	プロパティ
ReceiveInputXML	受信	- 名前を ReceiveInputXML に設定する - アクティブ化を True に設定する
SendToLOB	Send	- [名前] を SendToLOB に設定する
ReceiveResponse	受信	- 名前を ReceiveResponse に設定する - アクティブ化を False に設定する
SendResponse	Send	- 名前を SendResponse に設定する

要求メッセージには 2 つの挿入メッセージがあるため、SAP にメッセージを送信し、応答を受信するには、別の送受信図形のセットを作成する必要があります。ただし、挿入メッセージはコミットまたはロールバックされる可能性があるため、2 番目の図形セットはデシジョンブロック内に作成する必要があります。コミット用に 1 つの図形セットを作成し、ロールバック用に別の図形セットを作成する必要があります。

Note

BizTalk オーケストレーションツールボックスから [決定] 図形をドラッグアンドドロップすることで、決定ブロックを追加できます。

コミット用のメッセージ図形

次の表に、オーケストレーションの "コミットパス" の図形を示します。ここでは、要求メッセージの受信メッセージを作成する必要はありません。要求メッセージは、前のメッセージ図形から渡されます。

図形	図形の種類	プロパティ
SendBAPICommit	Send	- 名前を SendBAPICommit に設定する
ReceiveCommitResponse	受信	- 名前を ReceiveCommitResponse に設定する - アクティブ化を False に設定する
SendResponse2	Send	- 名前を SendResponse2 に設定する

中止のメッセージ図形

次の表に、オーケストレーションの "ロールバックパス" の図形を示します。

図形	図形の種類	プロパティ
SendBAPIRollback	Send	- 名前を SendBAPIRollback に設定する
ReceiveRollbackResponse	受信	- 名前を ReceiveRollbackResponse に設定する - Activate をFalse に設定する
SendResponse3	Send	- 名前を SendResponse3 に設定する

ルール式の設定

決定図形を追加して、デシジョンブロック内にコミット操作と中止操作のメッセージ図形を含めます。オーケストレーションが決定する条件を指定するには、トランザクションをコミットまたはロールバックする条件に基づいて、Rule 図形に式を指定する必要があります。たとえば、Rule 図形に次の式を指定する必要があります。

SendToAdapter.isCommit == true

ここで、SendToAdapter は要求メッセージのスキーマ用に作成したメッセージです。そのため、要求メッセージでタグが isCommitTrue に設定されている場合、オーケストレーションは "コミット" ルートを受け取ります。それ以外の場合、オーケストレーションは "ロールバック" ルートを受け取ります。

式エディターでこの条件を指定できるようにするには、アダプターに送信される要求メッセージのメッセージスキーマのプロパティを昇格している isCommit 必要があります。このトピックでは、使用する入力スキーマは MultipleOrders.xsd です。このスキーマのプロパティを isCommit 昇格させる必要があります。プロパティの昇格の詳細については、「プロパティの昇格」を参照してください。

メッセージ図形の構築を追加する

前述のように、アダプターに送信される要求メッセージには、2 つの挿入メッセージとコミットまたは中止メッセージが含まれます。メッセージ構築図形を追加し、その中で変換図形を追加して、SAP システムに送信される個々の操作メッセージを抽出する必要があります。また、メッセージ割り当て図形を追加して、トランザクションを有効にするためのメッセージコンテキストプロパティを設定する必要があります。

最初のコンストラクトメッセージ図形

最初のメッセージ構築図形が "ReceiveXML" と呼ばれるとします。この図形には、Messages Constructed プロパティを "BAPIMessage" として指定します。 [変換] 図形をダブルクリックして、[ 変換の構成 ] ダイアログボックスを開きます。ダイアログボックスで、次のようにします。

新しいマップを作成することを選択します。
左側のウィンドウで [ ソース ] を選択し、[ 変数名 ] ドロップダウンから [ SendToAdapter] を選択します。
左側のウィンドウで [ 変換先 ] を選択し、[ 変数名 ] ドロップダウンから [BAPIMessage] を選択します。
[ OK] を クリックしてマッパーを起動します。要求メッセージのスキーマをBAPI_SALESORDER_CREATEFROMDAT2のスキーマにマップします。 [インデックス] Functoid を使用して、ソーススキーマと変換先スキーマの間にマップを作成できます。 インデックス Functoid を使用すると、一連のレコード内の特定のレコードの情報を選択できます。

次の図は、 Index Functoid を使用してマップされたスキーマを示しています。

インデックス functoid を

[構成の変換] ダイアログボックスの使用の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「構成の変換」ダイアログボックスを参照してください。

Index Functoid の使用の詳細については、「 Index Functoid」を参照してください。

スキーマをマップしたら、マップファイルのプロパティページを使用してマッピングをテストできます。詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの<「[マップファイル>のプロパティページ] ダイアログボックスの [マップマップ] タブ」を参照してください。

[メッセージの割り当て] 図形で、トランザクションを開始するメッセージコンテキストプロパティを指定します。たとえば、最初のメッセージのメッセージコンテキストプロパティは次のようになります。

BAPIMessage(Microsoft.Adapters.SAP.BiztalkPropertySchema.ConnectionState) = "OPEN";

コミットコンストラクトメッセージ図形

コミット操作の [メッセージの構築] 図形が "CommitMessage" と呼ばれるとします。この図形には、Messages Constructed プロパティを "BAPICommitMessage" として指定します。 [変換] 図形をダブルクリックして、[ 変換の構成 ] ダイアログボックスを開きます。ダイアログボックスで、次のようにします。

新しいマップを作成することを選択します。
左側のウィンドウで [ ソース ] を選択し、[ 変数名 ] ドロップダウンから [ SendToAdapter] を選択します。
左側のウィンドウで [ 変換先 ] を選択し、[ 変数名 ] ドロップダウンから [ BAPICommitMessage] を選択します。
[OK] をクリックしてマッパーを起動します。要求メッセージのスキーマを BAPI_TRANSACTION_COMMIT のスキーマにマップします。 BAPI_TRANSACTION_COMMIT ノードにはレコード階層が含まれていないため、このマッピングにインデックス Functoid を含める必要はありません。

[メッセージの割り当て] 図形で、トランザクションをコミットするメッセージコンテキストプロパティを指定します。たとえば、最初のメッセージのメッセージコンテキストプロパティは次のようになります。

BAPICommitMessage(Microsoft.Adapters.SAP.BiztalkPropertySchema.ConnectionState) = "CLOSE";

Rollback コンストラクトメッセージ図形

ロールバック操作のメッセージ構築図形が "RollbackMessage" と呼ばれるとします。この図形には、Messages Constructed プロパティを "BAPIRollbackMessage" として指定します。 [変換] 図形をダブルクリックして、[ 変換の構成 ] ダイアログボックスを開きます。ダイアログボックスで、次のようにします。

新しいマップを作成することを選択します。
左側のウィンドウで [ ソース ] を選択し、[ 変数名 ] ドロップダウンから [ SendToAdapter] を選択します。
左側のウィンドウで [ 変換先 ] を選択し、[ 変数名 ] ドロップダウンから [ BAPIRollbackMessage] を選択します。
[OK] をクリックしてマッパーを起動します。要求メッセージのスキーマを BAPI_TRANSACTION_ROLLBACK のスキーマにマップします。 BAPI_TRANSACTION_ROLLBACK ノードにはレコード階層が含まれていないため、このマッピングにインデックス Functoid を含める必要はありません。

[メッセージの割り当て] 図形で、トランザクションをロールバックするメッセージコンテキストプロパティを指定します。たとえば、最初のメッセージのメッセージコンテキストプロパティは次のようになります。

BAPIRollbackMessage(Microsoft.Adapters.SAP.BiztalkPropertySchema.ConnectionState) = "ABORT";

重要

一般的なシナリオでは、ABORT コンテキストプロパティを持つBAPI_TRANSACTION_ROLLBACKに対応するメッセージを例外ブロックで使用する必要があります。

ポートの追加

論理ポートごとに次のプロパティを指定してください。 [ ポート ] 列に表示される名前は、オーケストレーションに表示されるポートの名前です。

このオーケストレーションでは、3 つのポートが作成されます。最初のポートは、指定したフォルダーから要求メッセージを選択します。 2 番目のポートは、SAP システムにメッセージを送信し、応答を受信します。 3 番目のポートは、応答を別のフォルダーに保存します。そのため、次のようになります。

最初のポートは、単一のスキーマ (MultipleOrders.xsd) のメッセージのみを受信します。
2 番目のポートは、RFC のスキーマのメッセージBAPI_SALESORDER_CREATEFROMDAT2送受信します。また、同じポートを使用して、トランザクションをコミットまたはロールバックします。そのため、このポートは、BAPI_TRANSACTION_COMMITおよびBAPI_TRANSACTION_ROLLBACK RFC のスキーマのメッセージも受信します。これを有効にするには、このポートに 3 つの異なる操作が作成され、それぞれが特定のメッセージスキーマに対応します。
2 番目のポートと同様に、このポートも 3 つの異なるスキーマを持つメッセージを受信します。そのため、このポートで 3 つの異なる操作を作成する必要があります。

Port	プロパティ
FileIn	- 識別子を FileIn に設定する - Typeを FileInType に設定する - 通信パターンを一方向に設定する - 受信する通信方向を設定する
LOBPort	- 識別子を LOBPort に設定する - 型を LOBPortType に設定する - 通信パターンを Request-Response に設定する - [通信の方向] を [送受信] に設定する - 操作 BAPIMessage を作成します。 - CommitMessage 操作を作成します。この操作は、コミットメッセージを送信するために使用されます。 - RollbackMessage 操作を作成します。この操作は、ロールバックメッセージの送信に使用されます。
SaveResponse	- 識別子を SaveResponse に設定する - Type を SaveResponseType に設定する - 通信パターンを一方向に設定する - [通信の方向] を [送信] に設定します。 - 操作 BAPIMessage を作成します。 - CommitMessage 操作を作成します。この操作は、コミットメッセージの応答を保存するために使用されます。 - RollbackMessage 操作を作成します。この操作は、ロールバックメッセージの応答を保存するために使用されます。

アクション図形のメッセージを指定し、ポートに接続する

次の表では、アクション図形のメッセージを指定し、ポートにリンクするために設定するプロパティとその値を指定します。 [図形] 列に表示される名前は、前のオーケストレーションに表示されるメッセージ図形の名前です。

図形	プロパティ
ReceiveInputXML	- Message を SendToAdapter に設定する - 操作を FileIn.Transaction.Request に設定する
SendToLOB	- メッセージを BAPIMessage に設定する - 操作を LOBPort.BAPIMessage.Request に設定する
ReceiveResponse	- メッセージを BAPIResponse に設定する - 操作を LOBPort.BAPIMessage.Response に設定する
SendResponse	- メッセージを BAPIResponse に設定する - 操作を SaveResponse.BAPIMessage.Request に設定する
SendBAPICommit	- メッセージを BAPICommitMessage に設定する - 操作を LOBPort.CommitMessage.Request に設定する
ReceiveCommitResponse	- メッセージを BAPICommitResponse に設定する - 操作を LOBPort.CommitMessage.Response に設定する
SendResponse2	- メッセージを BAPICommitResponse に設定する - 操作を SaveResponse.CommitMessage.Request に設定する
SendBAPIRollback	- メッセージを BAPIRollbackMessage に設定する - 操作を LOBPort.RollbackMessage.Request に設定する
ReceiveRollbackResponse	- メッセージを BAPIRollbackResponse に設定する - 操作を LOBPort.RollbackMessage.Response に設定する
SendResponse3	- メッセージを BAPIRollbackResponse に設定する - 操作を SaveResponse.RollbackMessage.Request に設定する

これらのプロパティを指定すると、メッセージの図形とポートが接続され、オーケストレーションが完了します。

例外処理

BAPI トランザクションを実行するための複雑なオーケストレーションでは、発生した問題を解決できるように、オーケストレーションの状態を追跡し、発生したエラーを報告することが重要です。 BizTalk オーケストレーションには、エラーを処理し、オーケストレーションの状態を維持し、トランザクション、補正、例外処理によって発生した問題を修正するためのツールが用意されています。

トランザクションと例外処理のフレームワークとして、オーケストレーション Designerはスコープ図形を提供します。スコープには、トランザクションの種類、補正、および任意の数の例外ハンドラーを設定できます。 1 つのスコープには、1 つ以上のブロックが含まれます。本文があり、必要に応じて任意の数の例外処理ブロックを追加できます。 BAPI トランザクションの場合、オーケストレーション全体 (前の図を参照) をスコープに含めることができます。

例外をキャッチするには、 Catch Exception ブロックをオーケストレーションに追加する必要があります。 Catch Exception ブロックは、オーケストレーション Designerの [スコープ] 図形の末尾にアタッチされます。 BAPI トランザクションの場合は、 Catch Exception ブロックに "ABORT" ルーチンを追加する必要があります。つまり、"ABORT" ルーチンに次を追加する必要があります。

Transform (入力メッセージから要求メッセージを抽出する) 図形とメッセージ割り当て図形 (コンテキストプロパティを設定する場合) で構成されるメッセージの構築図形
図形の送受信。

BizTalk アダプターパックに付属しているBizTalk Server (SAPTransaction) の SAP トランザクションサンプルでは、例外処理も示しています。サンプルの詳細については、「 SAP アダプターのサンプル」を参照してください。

例外を処理する方法の詳細については、一般に、BizTalk Serverの使用に関するページと例外の処理に関するページを参照してください。

BizTalk プロパティスキーマを BizTalk に追加する

BizTalk プロジェクトで、SAP アダプターの BizTalk プロパティスキーマにアセンブリ参照を追加しました。 BizTalk アプリケーション(BizTalk プロジェクトを展開するアプリケーション)で、同じアセンブリをリソースとして追加する必要があります。スキーマファイル Microsoft.Adapters.SAP.BiztalkPropertySchema.dllは、BizTalk アダプターパックのセットアップによって通常、インストールドライブ>:\Program Files\Microsoft BizTalk Adapter Pack\bin の下<にインストールされます。このリソースがないと、プロジェクトをデプロイできなくなります。

BizTalk でアセンブリをリソースとして追加するには

BizTalk Server管理コンソールを起動します。
コンソールツリーで、[ BizTalk グループ]、[ アプリケーション] の順に展開し、BizTalk アセンブリを追加するアプリケーションを展開します。
[ リソース] を右クリックし、[ 追加] をポイントして、[ BizTalk アセンブリ] をクリックします。
[ リソースの追加 ] ダイアログボックスで、[ 追加] をクリックし、BizTalk アセンブリファイルを含むフォルダーに移動し、BizTalk アセンブリファイルを選択して、[ 開く] をクリックします。
[ オプション] で、BizTalk アセンブリを GAC にインストールするためのオプションを指定し、[OK] をクリック します。

BizTalk ソリューションをビルドし、BizTalk Serverに展開する必要があります。詳細については、「オーケストレーションのビルドと実行」を参照してください。

BizTalk アプリケーションの構成

BizTalk プロジェクトを展開すると、先ほど作成したオーケストレーションが、BizTalk Server管理コンソールの [オーケストレーション] ウィンドウの下に一覧表示されます。アプリケーションを構成するには、BizTalk Server管理コンソールを使用する必要があります。アプリケーションの構成の詳細については、「アプリケーションを構成する方法」を参照してください。

アプリケーションの構成には、次の作業が含まれます。

アプリケーションのホストの選択。

オーケストレーションで作成したポートを、BizTalk Server管理コンソールの物理ポートにマッピングします。このオーケストレーションでは、次の操作を行う必要があります。

ハードディスク上の場所と、要求メッセージをドロップする対応するファイルポートを定義します。 BizTalk オーケストレーションは、要求メッセージを使用して SAP システムに送信します。
ハードディスク上の場所と、BizTalk オーケストレーションが SAP システムからの応答を含む応答メッセージを削除する対応するファイルポートを定義します。

SAP システムにメッセージを送信する物理 WCF-Custom または WCF-SAP 送信ポートを定義します。ポートを作成する方法については、「 SAP アダプターへの物理ポートバインドを手動で構成する」を参照してください。送信ポートは、複数のスキーマに準拠したメッセージを送受信し、2 つの操作を実行するため、両方の操作に動的アクションを設定する必要があります。アクションの詳細については、「 SAP システムの SOAP アクションを構成する」を参照してください。トランザクションを実行する WCF-Custom または WCF-SAP 送信ポートを作成するときは、次の重要な考慮事項に従ってください。

次のように設定します	この値に
アクション	送信ポートは、複数の操作のメッセージを送受信します。そのため、送信ポートのアクションは、操作ごとに設定する必要があります。 `<BtsActionMapping> <Operation Name="BAPIMessage" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/BAPI_SALESORDER_CREATEFROMDAT2" /> <Operation Name="CommitMessage" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/BAPI_TRANSACTION_COMMIT" /> <Operation Name="RollbackMessage" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/BAPI_TRANSACTION_ROLLBACK" /> </BtsActionMapping>`
EnableBizTalkCompatibilityMode	このバインドプロパティを True に設定します。
EnableConnectionPooling	トランザクションを実行する前に、このバインドプロパティを False に設定します。アダプターと BizTalk の間に設定されたチャネルが予期せず終了するシナリオでは、対応する接続が接続プールに追加されます。別のチャネルが開き、新しいチャネルが同じ接続オブジェクトを選択すると、トランザクションが新しいチャネル経由でコミットされるときに、古い接続オブジェクトのコミットされていないトランザクションもコミットされます。これを回避するには、トランザクションの実行中に接続プールを無効にする必要があります。

Note

アダプターサービス BizTalk プロジェクトアドインを使用してスキーマを生成すると、ポートに関する情報と、それらのポートに対して設定するアクションを含むバインドファイルも作成されます。 BizTalk Server管理コンソールからこのバインドファイルをインポートして、送信ポート (送信呼び出しの場合) または受信ポート (受信呼び出し用) を作成できます。詳細については、「 SAP へのポートバインドファイルを使用して物理ポートバインドを構成する」を参照してください。

重要

プライマリトランスポートが機能しない場合に別の SAP システムにメッセージを送信できるようにする、WCF-Custom または WCF-SAP 送信ポートでバックアップトランスポートを構成できます。ただし、SAP システムでトランザクションを実行する場合、WCF ベースの SAP アダプターでは、別の SAP サーバーを指すバックアップトランスポートの指定はサポートされていません。

アプリケーションの起動

SAP システムでトランザクションを実行する BizTalk アプリケーションを起動する必要があります。 BizTalk アプリケーションを起動する手順については、「オーケストレーションを開始する方法」、「アプリケーションを起動する方法」を参照してください。

この段階で、次のことを確認します。

オーケストレーションの要求メッセージを受信する FILE 受信ポートが実行されています。
オーケストレーションからの応答メッセージを受信する FILE 送信ポートが実行されています。
SAP システムにメッセージを送信する WCF-Custom または WCF-SAP 送信ポートが実行されています。
操作の BizTalk オーケストレーションが実行されています。

操作の実行

アプリケーションを実行した後、オーケストレーションの要求メッセージを定義済みの場所にドロップする必要があります。要求メッセージは、特定のスキーマ (たとえば、MultipleOrders.xsd スキーマ) に準拠している必要があります。たとえば、SAP システムで販売注文を作成し、その操作をコミットするための要求メッセージは次のとおりです。

<ns0:Orders xmlns:ns0="http://BAPISend.MultipleOrders">  
  <Order>  
      <ORDER_HEADER_IN>  
        <DOC_TYPE>TA</DOC_TYPE>  
        <SALES_ORG>1000</SALES_ORG>  
        <DISTR_CHAN>10</DISTR_CHAN>  
        <DIVISION>00</DIVISION>  
        <SALES_OFF>1000</SALES_OFF>  
        <REQ_DATE_H>20060901</REQ_DATE_H>  
        <PURCH_DATE>20060901</PURCH_DATE>  
        <PURCH_NO_C>Cust A</PURCH_NO_C>  
        <CURRENCY>EUR</CURRENCY>  
      </ORDER_HEADER_IN>  
      <ORDER_ITEMS_IN>  
          <MATERIAL>P-109</MATERIAL>  
          <PLANT>1000</PLANT>  
          <TARGET_QU>ST</TARGET_QU>  
      </ORDER_ITEMS_IN>  
      <ORDER_PARTNERS>  
          <PARTN_ROLE>AG</PARTN_ROLE>  
          <PARTN_NUMB>0000000257</PARTN_NUMB>  
      </ORDER_PARTNERS>  
    <RETURN></RETURN>  
  </Order>  
  <isCommit>true</isCommit>  
  <BAPI_TRANSACTION_COMMIT>  
  </BAPI_TRANSACTION_COMMIT>  
</ns0:Orders>

オーケストレーションによってメッセージが使用され、SAP システムに送信されます。 SAP システムからの応答は、オーケストレーションの一部として定義されている他のファイルの場所に保存されます。上記の要求メッセージでは、2 つの応答メッセージが表示されます。1 つはBAPI_SALESORDER_CREATEFROMDAT2 RFC を呼び出すためのメッセージで、もう 1 つは BAPI_TRANSACTION_COMMITを使用したコミット操作用です。

BAPI_SALESORDER_CREATEFROMDAT2の応答は次のとおりです。

<?xml version="1.0" encoding="utf-8" ?>   
<BAPI_SALESORDER_CREATEFROMDAT2Response xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">  
  <SALESDOCUMENT />   
  <ORDER_ITEMS_IN>  
    <BAPISDITM xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">  
      <ITM_NUMBER>0</ITM_NUMBER>   
      <HG_LV_ITEM>0</HG_LV_ITEM>   
      <PO_ITM_NO />   
      ......  
    </BAPISDITM>  
  </ORDER_ITEMS_IN>  
  <ORDER_PARTNERS>  
    <BAPIPARNR xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">  
      <PARTN_ROLE>AG</PARTN_ROLE>   
      <PARTN_NUMB>0000000257</PARTN_NUMB>   
      <ITM_NUMBER>0</ITM_NUMBER>   
      ......   
    </BAPIPARNR>  
  </ORDER_PARTNERS>  
</BAPI_SALESORDER_CREATEFROMDAT2Response>

BAPI_TRANSACTION_COMMITの応答は次のとおりです。

<?xml version="1.0" encoding="utf-8" ?>   
<BAPI_TRANSACTION_COMMITResponse xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">  
  <RETURN>  
    <TYPE xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <ID xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <NUMBER xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">0</NUMBER>   
    <MESSAGE xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <LOG_NO xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <LOG_MSG_NO xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">0</LOG_MSG_NO>   
    <MESSAGE_V1 xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <MESSAGE_V2 xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <MESSAGE_V3 xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <MESSAGE_V4 xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <PARAMETER xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <ROW xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">0</ROW>   
    <FIELD xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
    <SYSTEM xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/" />   
  </RETURN>  
</BAPI_TRANSACTION_COMMITResponse>

Note

要求メッセージが RFC BAPI_TRANSACTION_ROLLBACKを呼び出した場合、2 番目の応答は BAPI_TRANSACTION_ROLLBACK 用になります。

考えられる例外

BizTalk Serverを使用して SAP システムでトランザクションを実行しているときに発生する可能性がある例外の詳細については、「SAP アダプターでの例外とエラー処理」を参照してください。

ベストプラクティス

BizTalk プロジェクトを展開して構成したら、バインドファイルと呼ばれる XML ファイルに構成設定をエクスポートできます。バインドファイルを生成したら、同じオーケストレーションに対して送信ポートと受信ポートを作成する必要がないように、ファイルから構成設定をインポートできます。バインドファイルの詳細については、「 SAP アダプターバインドの再利用」を参照してください。

参照

BizTalk アプリケーションの開発

次の方法で共有

BizTalk Serverを使用して SAP で BAPI トランザクションを実行する

アダプターは、BizTalk Serverを介してトランザクションを有効にする方法

SAP システムでトランザクションを実行する方法

このトピックに基づくサンプル

スキーマの生成

メッセージとメッセージの種類の定義

メッセージを作成し、スキーマにリンクするには

オーケストレーションの設定

メッセージ図形の追加

コミット用のメッセージ図形

中止のメッセージ図形

ルール式の設定

メッセージ図形の構築を追加する

最初のコンストラクトメッセージ図形

コミットコンストラクトメッセージ図形

Rollback コンストラクトメッセージ図形

ポートの追加

アクション図形のメッセージを指定し、ポートに接続する

例外処理

BizTalk プロパティスキーマを BizTalk に追加する

BizTalk でアセンブリをリソースとして追加するには

BizTalk アプリケーションの構成

アプリケーションの起動

操作の実行

考えられる例外

ベストプラクティス

参照

フィードバック

その他のリソース

次の方法で共有

BizTalk Serverを使用して SAP で BAPI トランザクションを実行する

アダプターは、BizTalk Serverを介してトランザクションを有効にする方法

BizTalk Serverを使用したトランザクションに関連する主な考慮事項

SAP システムでトランザクションを実行する方法

このトピックに基づくサンプル

スキーマの生成

メッセージとメッセージの種類の定義

メッセージを作成し、スキーマにリンクするには

オーケストレーションの設定

メッセージ図形の追加

コミット用のメッセージ図形

中止のメッセージ図形

ルール式の設定

メッセージ図形の構築を追加する

最初のコンストラクト メッセージ図形

コミットコンストラクト メッセージ図形

Rollback コンストラクト メッセージ図形

ポートの追加

アクション 図形のメッセージを指定し、ポートに接続する

例外処理

BizTalk プロパティ スキーマを BizTalk に追加する

BizTalk でアセンブリをリソースとして追加するには

BizTalk アプリケーションの構成

アプリケーションの起動

操作の実行

考えられる例外

ベスト プラクティス

参照

フィードバック

その他のリソース

最初のコンストラクトメッセージ図形

コミットコンストラクトメッセージ図形

Rollback コンストラクトメッセージ図形

アクション図形のメッセージを指定し、ポートに接続する

BizTalk プロパティスキーマを BizTalk に追加する

ベストプラクティス