SAPRequest ノード

SAPRequest ノードを使用して、SAP アプリケーションに要求を送信します。

このトピックには、以下のセクションが含まれています。

目的

SAPRequest ノードを使用して、SAP アプリケーションに要求を送信します。例えば、SAPRequest ノードは SAP エンタープライズ情報システム (EIS) からの情報を要求することがあります。 顧客ビジネス・オブジェクトが SAP に送信されると、SAP は住所や口座の詳細などの顧客に関する情報を取り出します。 SAPRequest ノードによって取り出された応答情報は、メッセージ・フローの残りの部分で使用できるようになります。 SAPRequest ノードではビジネス・データの送受信も可能です。

SAPRequest ノードはメッセージ・フローのノード・パレットの WebSphere Adapters ドロワーに含まれ、WebSphere® Message Broker Toolkit では、次のアイコンで表されます。

SAPRequest ノード・アイコン

メッセージ・フロー内での SAPRequest ノードの使用

SAPRequest ノードが正しく機能するためにはアダプター・コンポーネントが必要です。 コンポーネントを設定するには、「アダプター・コンポーネント」ノード・プロパティーとビジネス・オブジェクト定義を使用します。これらは、ノードから参照するメッセージ・セットに格納されています。このような理由から、メッセージ・セットを提供する必要があります。 デフォルトでは、SAPRequest ノードから伝搬されているメッセージは DataObject ドメインに存在するため、「メッセージ・ドメイン」プロパティーは DataObject に設定されます。別のドメインを指定することはできません。ノードはメッセージ・タイプを自動的に検出します。

パフォーマンスを最大限に高め、また不要なデータ変換を避けるには、SAPRequest ノードに渡されるメッセージに適切なデータ・タイプを含めるようにします。 DataObject ドメインは、SAPRequest ノードによって生成されたメッセージを構文解析するときのデフォルト・ドメインです。 ただし、SAPRequest ノードにデータを渡すときは (例えば MQInput ノードを使用)、異なるドメインを使用することによってパフォーマンスが向上する可能性があります。例えば、MQInput ノードと共に XMLNSC パーサーを使用して XML メッセージを構文解析します。

SAPRequest ノードは、ブローカーの「ローカル・トランザクション・マネージャー」を使用してローカル・トランザクションをサポートします。

実行グループに対して同じアダプター・コンポーネントを使用する複数の WebSphere Adapter 要求ノードをデプロイできます。

SAPRequest ノードでは、そのノードで定義されているセキュリティー・プロファイルの「伝搬」プロパティーを使用することによって、入力メッセージに含まれている ID を利用して、その ID を SAP に伝搬できます。詳しくは、セキュリティー資格情報を SAP 要求に伝搬する操作を参照してください。

SAP への接続のプールを効率的に管理するために、構成可能サービスで接続タイムアウト値を設定できます。デフォルトでは、connectionIdleTimeout プロパティーはゼロに設定されます。その場合、タイムアウトは発生しません。ただし、SAP に対する新しい接続は、別のユーザー ID で開かれるので、ID 伝搬を使用する場合は、このプロパティーをゼロに設定しないでください。詳しくは、指定の時間後に EIS 接続の有効期限が切れるように構成する操作を参照してください。

以下のフォーマットの mqsisetdbparms コマンドを使用して、Adapter for SAP Software 用のユーザー名とパスワードを持ったアカウント名を構成することができます。 mqsisetdbparms コマンドは、大/小文字を区別してパスワードを格納します。しかし、SAP GUI がパスワードを設定する際、そのパスワードは自動的に大文字に変換されます。そのため、SAP システムに接続するためにはパスワードを大文字で指定してください。
mqsisetdbparms broker name -n adapter name -u user name -p PASSWORD
以下に例を示します。
mqsisetdbparms BRK1 -n eis::SAPCustomerOutbound.outadapter -u sapuid -p ********
このノードが使用される方法に関しては、次のサンプルを参照してください。

サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。

SAP ノードの構成可能サービスの使用

SAP ノードは、アダプター・コンポーネントまたは構成可能サービスのいずれかより SAP 接続の詳細を取得できます。構成可能サービスを使用することによって、アダプターを再デプロイせずに、アダプターの接続の詳細を変更できます。SAP の構成可能サービスを作成、変更、報告および削除する方法の詳細については、SAP アダプターの接続詳細の変更を参照してください。

ターミナルおよびプロパティー

SAPRequest ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。SAPRequest ノードをダブルクリックすると、「アダプター接続」ウィザードが開きます。値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。

SAPRequest ノードのターミナルについては、次の表に説明されています。

ターミナル 説明
In 要求ビジネス・オブジェクトを受け入れる入力ターミナル
Out 要求が正常に完了し、このメッセージ・フローでそれ以降の処理が必要な場合に、応答のビジネス・オブジェクトの送信先となる出力ターミナル。
Failure SAPRequest ノードでエラーが生じる場合、メッセージが Failure ターミナルに伝搬されます。 エラーに関する情報とビジネス・オブジェクトイベントも、Failure ターミナルに伝搬することができます。

以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力する必要がある場合、パネル上にアスタリスクのマークが付きます)。C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。

SAPRequest ノードの「説明」プロパティーについては、次の表に説明されています。
プロパティー M C デフォルト 説明
ノード名 いいえ いいえ ノード・タイプ、SAPRequest ノードの名前。
簡略説明 いいえ いいえ ノードの簡単な説明
詳細説明 いいえ いいえ メッセージ・フロー内のノードの目的を説明するテキスト
SAPRequest ノードの「基本」プロパティーについては、次の表に説明されています。
プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
1 次アダプター・コンポーネント はい いいえ   アダプターの構成プロパティーを含む、アダプター・コンポーネントの名前。 アダプター・ファイルの名前を入力するか、「参照」をクリックして、参照メッセージ・セットのプロジェクトで使用可能なファイルのリストからアダプター・ファイルを選択します。

SAPRequest ノードは、SAP システムからデータを受信するときに、そのデータをメソッド名に関連付けます。 SAPRequest ノードは、基本アダプターで定義されたメソッドの呼び出しを試みます。 基本アダプターでメソッドが定義されていない場合、ノードは、同じ実行グループにデプロイされたマッチする 2 次アダプターで定義されたメソッドを呼び出すことができます。

 
2 次アダプター・モード いいえ はい なし 2 次アダプターで定義されたメソッドをノードが呼び出すことができるかどうかを指定します。

「2 次アダプター・モード」プロパティーを「なし」に設定した場合、SAPRequest ノードは基本アダプターで定義されたメソッドだけを呼び出します。 基本アダプターでメソッドが定義されていない場合、エラーが発生します。

このプロパティーを「実行グループ内のすべてのアダプター」に設定した場合、ノードは、同じ実行グループにデプロイされたマッチする SAP アウトバウンド・アダプターで定義されたメソッドを呼び出すことができます。 例えば、IDoc メッセージ用に基本アダプターが構成されている場合、マッチする 2 次アダプターは IDoc アウトバウンド・アダプターです。

secondaryAdapterMode
デフォルト・メソッド はい はい   使用するデフォルトのメソッド・バインディング。 このプロパティーでは、アダプターによって定義されたメソッドがリストされます。 LocalEnvironment.Adapter サブツリーでメソッド名を設定することにより、このプロパティーをオーバーライドできます。 詳しくは、ローカル環境のツリー構造を参照してください。

メソッド名は、「アダプター接続」ウィザードで構成するサービス・オペレーション名に対応しています。 ほとんどの場合、発見されるサービス (例えば BAPI) の名前に基づいた名前になります。

defaultMethod
SAPRequest ノードの「応答メッセージの構文解析」プロパティーについては、次の表に説明されています。
プロパティー M C デフォルト 説明
メッセージ・ドメイン いいえ いいえ DataObject 応答メッセージの構文解析に使用されるドメイン。 デフォルトで、SAPRequest ノードから伝搬されるメッセージは DataObject ドメインに存在します。別のドメインを指定することはできません。
メッセージ・セット はい いいえ 自動的に設定される 着信メッセージが定義されているメッセージ・セットの名前。 このフィールドは、「アダプター・コンポーネント」プロパティーから自動的に設定されます。

このプロパティーを設定して、その後にプロジェクトの依存関係を更新してこのメッセージ・セットの参照を削除すると、警告が発行されます。「メッセージ・セット」プロパティーを更新するか、このメッセージ・セット・プロジェクトへの参照を復元してください。

メッセージ・タイプ いいえ いいえ   応答メッセージの名前。ノードはメッセージ・タイプを自動的に検出します。 このプロパティーを設定することはできません。
メッセージ形式 いいえ いいえ   応答メッセージの物理フォーマットの名前。このプロパティーを設定することはできません。
SAPRequest ノードの「トランザクション特性」プロパティーについては、次の表に説明されています。
プロパティー M C デフォルト 説明
トランザクション・モード いいえ いいえ 自動 更新の処理方法を指定します。
  • 「はい」を選択すると、SAPRequest ノードは、メッセージ・フローの入力ノードによって開始されるローカル・トランザクションに加わります。
  • 「いいえ」を選択すると、SAPRequest ノードは、メッセージ・フローの入力ノードによって開始されるローカル・トランザクションに加わりません。
  • 「自動」を選択すると、SAPRequest ノードは、メッセージ・フローを駆動する入力ノード上で設定された値を使用します。 例えば、メッセージ・フローが SAPInput ノードによって駆動される場合、SAPRequest では、SAPInput ノード上で設定されたトランザクション・モードをとります。

トランザクション特性の詳細については、SAP BAPI トランザクション・コミットを参照してください。

SAPRequest ノードの「要求」プロパティーについては、次の表に説明されています。
プロパティー M C デフォルト 説明
メソッド・ロケーション はい いいえ $LocalEnvironment/Adapter/MethodName 外部システムで 1 つのアクションを実行するために、SAPRequest ノードのトリガーに使用されるビジネス・メソッド (createPurchaseOrder や deletePurchaseOrder など) のロケーション。
データのロケーション はい いいえ $Body SAPRequest ノードから EIS に送信される要求を形成するためのデータの取得元になる受信メッセージ・ツリー内での場所。
SAPRequest ノードの「結果」プロパティーについては、次の表に説明されています。
プロパティー M C デフォルト 説明
出力データのロケーション いいえ いいえ $OutputRoot SAPRequest ノードが出力を送信する宛先のメッセージ・ツリーのロケーション。
ローカル環境のコピー いいえ いいえ 選択されている このプロパティーは、ローカル環境がどのように出力メッセージにコピーされるかを制御します。 このチェック・ボックスを選択すると、ローカル環境の新しいコピーがツリー内 (メッセージ・フロー内の各ノードごと) に作成されて、前のノードのローカル環境の内容がそこに取り込まれます。したがって、ノードによってローカル環境が変更されても、フロー内のそれまでのノードは、それぞれ独自のコピーを保有しているので、そのような変更を認知しません。このような動作は、FlowOrder ノードを使用する場合や、Compute ノード上で propagate コマンドを使用する場合に問題になる可能性があります。

チェック・ボックスをクリアした場合、各ノードは、それぞれ独自のローカル環境のコピーを生成しないで、前のノードから渡されたローカル環境を使用します。 したがって、ノードがローカル環境を変更した場合、その変更は上流のノードで認知されます。

ノードのモニター・プロパティーが、次の表に説明されています。
プロパティー M C デフォルト 説明
イベント なし なし なし ノードに対して定義したイベントが、このタブに表示されます。デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。

「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:40:32


参照トピック参照トピック | バージョン 8.0.0.1 | ac37300_