TwineballRequest ノードを使用して、WebSphere® Adapters ノードの機能の仕方を調べます。
このトピックには、以下のセクションが含まれています。
TwineballRequest ノードは教材用として用意されていて、WebSphere Adapters ノードがどのように動作するかを確認することができます。 TwineballRequest ノードは独自のサンプル EIS を伴うサンプル・ノードです。 SAP、Siebel、および PeopleSoft の各外部 EIS システムに接続するために、TwineBall ノードを使用することはできません。 実動時には、このノードを使用しないでください。
TwineballRequest ノードはメッセージ・フローのノード・パレットの WebSphere Adapters ドロワーに含まれ、WebSphere Message Broker Toolkit では、次のアイコンで表されます。
mqsisetdbparms broker name -n adapter name -u user name -p password
以下に例を示します。 mqsisetdbparms BRK1 -n eis::TwineballOutbound.outadapter -u mqbroker -p ********
サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。
TwineballRequest ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。 TwineballRequest ノードをダブルクリックすると、「アダプター接続」ウィザードが開きます。 値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。
TwineballRequest ノードのターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | 要求ビジネス・オブジェクトを受け入れる入力ターミナル。 |
Out | 要求が正常に完了し、このメッセージ・フローでそれ以降の処理が必要な場合に、応答のビジネス・オブジェクトの送信先となる出力ターミナル。 |
Failure | TwineballRequest ノードでエラーが起きた場合、メッセージが Failure ターミナルに伝搬されます。 エラーに関する情報とビジネス・オブジェクトイベントも、Failure ターミナルに伝搬することができます。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、パネル上にアスタリスクのマークが付きます)。C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
TwineballRequest ノードの「説明」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ノード名 | いいえ | いいえ | ノード・タイプ、TwineballRequest | ノードの名前。 |
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
---|---|---|---|---|---|
アダプター・コンポーネント | はい | いいえ | アダプターの構成プロパティーを含む、アダプター・コンポーネントの名前。 アダプター・ファイルの名前を入力するか、「参照」をクリックして、参照メッセージ・セットのプロジェクトで使用可能なファイルのリストからアダプター・ファイルを選択します。 | ||
デフォルト・メソッド | はい | はい | 使用するデフォルトのメソッド・バインディング。 | defaultMethod |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
メッセージ・ドメイン | いいえ | いいえ | DataObject | 応答メッセージの構文解析に使用されるドメイン。 デフォルトで、TwineballRequest ノードから伝搬される応答メッセージは DataObject ドメインに存在します。 別のドメインを指定することはできません。 |
メッセージ・セット | はい | いいえ | 自動的に設定される | 着信メッセージが定義されているメッセージ・セットの名前。 このフィールドは、「アダプター・コンポーネント」プロパティーから自動的に設定されます。 このプロパティーを設定して、その後にプロジェクトの依存関係を更新してこのメッセージ・セットの参照を削除すると、警告が発行されます。 「メッセージ・セット」プロパティーを更新するか、このメッセージ・セット・プロジェクトへの参照を復元してください。 |
メッセージ・タイプ | いいえ | いいえ | 応答メッセージの名前。 ノードはメッセージ・タイプを自動的に検出します。 このプロパティーを設定することはできません。 | |
メッセージ形式 | いいえ | いいえ | 応答メッセージの物理フォーマットの名前。このプロパティーを設定することはできません。 |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
トランザクション・モード | いいえ | いいえ | 自動 | このプロパティーは更新の処理方法を指定します。 「はい」を選択すると、更新は単一トランザクションで実行されます。 「いいえ」を選択すると、更新は単独で実行されます。 |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
メソッド・ロケーション | はい | いいえ | $LocalEnvironment/Adapter/MethodName | 外部システムで 1 つのアクションを実行するために、TwineballRequest ノードのトリガーに使用されるビジネス・メソッド (createPurchaseOrder や deletePurchaseOrder など) のロケーション。 |
データのロケーション | はい | いいえ | $Body | TwineballRequest ノードから EIS に送信される要求を形成するためのデータの取得元になる受信メッセージ・ツリー内での場所。 |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
出力データのロケーション | いいえ | いいえ | $OutputRoot | TwineballRequest ノードが出力を送信する宛先のメッセージ・ツリーのロケーション。 |
ローカル環境のコピー | いいえ | いいえ | 選択されている | このプロパティーは、ローカル環境がどのように出力メッセージにコピーされるかを制御します。 メッセージ・フロー内の各ノードごとに、チェック・ボックスを選択すると、ローカル環境の新しいコピーがツリー内に作成されて、前のノードのローカル環境の内容がそこに取り込まれます。 ノードによってローカル環境が変更されても、上流のノードは、それぞれ独自のコピーを保有しているので、そのような変更を認知しません。 このような動作は、FlowOrder ノードを使用する場合や、Compute ノード上で propagate コマンドを使用する場合に問題になる可能性があります。 チェック・ボックスをクリアした場合、各ノードは、それぞれ独自のローカル環境のコピーを生成しないで、前のノードから渡されたローカル環境を使用します。 ノードがローカル環境を変更した場合、その変更は上流のノードで認知されます。 |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
イベント | いいえ | いいえ | なし | ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |