このトピックには、以下のセクションが含まれています。
TimeoutControl ノードは、タイムアウト要求を含む入力メッセージを受け取ります。 タイムアウト要求メッセージについて詳しくは、タイムアウト要求メッセージを参照してください。ノードは要求を妥当性検査し、メッセージを保管し、メッセージをメッセージ・フロー内の次のノードへ伝搬します (未変更)。
ワークベンチでは、TimeoutControl ノードは次のアイコンで表されます。
イベントが特定の時期にまたは一定の間隔で生じるようにする必要のあるアプリケーションでは、 TimeoutControl ノードと TimeoutNotification ノードをメッセージ・フロー内で一緒に使用します。
複数の TimeoutControl ノードを 1 つの TimeoutNotification ノードと対にすることができます。 それらの TimeoutControl ノードによって処理されるタイムアウト要求は、すべて同じ TimeoutNotification ノードによって処理されます。 これは、同じ固有 ID が TimeoutNotification ノードおよび各 TimeoutControl ノードに対して使用されている場合に生じます。
タイムアウト処理ノードの使用方法について詳しくは、Timeout Processing サンプル を参照してください。
TimeoutControl ノードのインスタンスをメッセージ・フローに入れると、TimeoutControl ノードを構成することができます。
エディター・ビューでノードを右クリックし、「プロパティー」をクリックします。ノードの基本プロパティーが表示されます。
「固有 ID」は、唯一の必須プロパティーです。 これにはデフォルト値がありません。
以下の方法で、ノードの基本プロパティーを構成します。
ここで、次のようにしてノードの「メッセージ」プロパティーを構成します。
XML、XMLNS、XMLNSC、JMS、MIME、および BLOB パーサーの場合、 「メッセージ・セット」はブランクのままにしてください。
XML、XMLNS、XMLNSC、JMS、IDOC、MIME、および BLOB パーサーの場合、「メッセージ・タイプ」はブランクのままにしてください。
XML、XMLNS、XMLNSC、JMS、MIME、および BLOB パーサーの場合、 「メッセージ形式」はブランクのままにしてください。
構成が完了したら、「適用」をクリックします。 これにより、プロパティー・ダイアログを閉じずに TimeoutControl ノードが変更されます。 「OK」をクリックすると、変更を適用してプロパティー・ダイアログを閉じます。「キャンセル」をクリックすると、ダイアログを閉じてプロパティーに対して行った変更をすべて破棄します。
TimeoutControl ノード・ターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | メッセージ・ツリーを受け入れて処理し (これには「要求ロケーション」で メッセージ・ツリーに指定されたタイムアウト要求の妥当性検査も含まれる)、それを制御キューに追加する、入力ターミナル。 |
Failure | このノード内の処理で障害が検出された場合に、入力メッセージが伝搬される出力ターミナル。 このターミナルが他のノードに接続されていない場合、メッセージ・フロー内の直前のノードにエラー情報が戻されます。 |
Out | タイムアウト要求の処理が正常に行われた後で着信メッセージが変更されないで伝搬される出力ターミナル。 このターミナルが他のノードに接続されていない場合、伝搬は行われません。 メッセージの伝搬が失敗した場合、そのメッセージは Failure ターミナルに伝搬されます。 |
以下の表でノードのプロパティーを説明します。M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、プロパティー・ダイアログにアスタリスクのマークが付きます)。C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを bar ファイルに追加してデプロイするとき、値を変更できます)。
TimeoutControl ノードの基本プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
固有 ID | はい | はい | なし | これはノードの唯一の必須プロパティーです。 その値は、ブローカー・ドメイン内で固有でなければなりません。 対になっている TimeoutNotification ノードの対応するプロパティーも、同じ値であることが必要です。 この ID の最大長は 12 文字です。 |
要求ロケーション | いいえ | いいえ | なし | このプロパティーは、タイムアウト要求の情報が存在する場所を示します。 これは、メッセージ・ツリー内の有効なロケーションでなければなりません。 これは実行時に妥当性検査されます。 要求ロケーションが指定されていない場合、LocalEnvironment.TimeoutRequest が想定されます。タイムアウト要求メッセージについて詳しくは、タイムアウト要求メッセージを参照してください。 |
要求の持続性 | いいえ | いいえ | 自動 | このプロパティーは、着信するタイムアウト要求がブローカーまたはメッセージ・フローの 再始動の後も存続するかどうかを決めます。 このプロパティーの値は、「自動」、「はい」、または「いいえ」とすることができます。 値が「自動」の場合は、 着信メッセージの「プロパティー」フォルダーにある「持続」設定が使用されます。 |
TimeoutControl ノードのメッセージ・プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
保管されたメッセージのロケーション | いいえ | いいえ | なし | このノードが対になっている TimeoutNotification ノードによる伝搬のために保管したい要求メッセージの部分のロケーション。 |
メッセージ・ドメイン | いいえ | いいえ | なし | 保管されたタイムアウト要求メッセージを構文解析するために TimeoutNotification ノードによって使用されるドメイン。 |
メッセージ・セット | いいえ | いいえ | なし | 保管されたタイムアウト要求メッセージが定義されているメッセージ・セットの名前または ID。 |
メッセージ・タイプ | いいえ | いいえ | なし | 保管されたタイムアウト要求メッセージの名前。 |
メッセージ形式 | いいえ | いいえ | なし | 保管されたタイムアウト要求メッセージの物理形式の名前。 |
TimeoutControl ノードの説明プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |