Oracle Workflow APIリファレンス リリース2.6.3.5 部品番号: B15622-01 |
![]() |
![]() |
![]() |
![]() |
![]() |
||
前へ | 次へ | 目次 | 索引 | 用語集 |
procedure DequeueEventDetail
(dequeuemode in number,
navigation in number default 1,
correlation in varchar2 default null,
itemtype in out varchar2,
itemkey out varchar2,
actid out number,
function_name out varchar2,
param_list out varchar2,
message_handle in out raw,
timeout out boolean);
説明
指定のメッセージに対するすべてのイベントの詳細を、送信キューからデキューします。このAPIはDequeueOutboundと同様ですが、ペイロード・タイプを参照しません。そのかわりにペイロードの一部であるitemkey、actid、function_nameおよびparam_listを出力します。
注意: このプロシージャをループ内でコールする場合は、戻されるメッセージ・ハンドルをNULLに設定しないと、プロシージャで同じメッセージが再度デキューされます。これは望ましくない動作であり、無限ループの原因となることがあります。
引数(入力)
dequeuemode | 番号1、2および3にそれぞれ対応するDBMS_AQ.BROWSE、DBMS_AQ.LOCKEDまたはDBMS_AQ.REMOVEという値で、デキューのロック動作を表します。DBMS_AQ.BROWSEモードでは、メッセージのロックを取得せずにキューからメッセージを読み込みます。DBMS_AQ.LOCKEDモードでは、メッセージを読み込み、トランザクションが完了するまでメッセージの書込みロックを取得します。DBMS_AQ.REMOVEモードでは、メッセージを読み込んでから更新か削除を行います。 |
navigation | 番号1、2にそれぞれ対応するDBMS_AQ.FIRSTMESSAGEまたはDBMS_AQ.NEXTMESSAGEを指定し、取り出されるメッセージの場所を示します。DBMS_AQ.FIRSTMESSAGEという値では、取出し可能で相関基準と合致している最初のメッセージを取り出します。キューの始まりの位置もリセットします。DBMS_AQ.NEXTMESSAGEという値では、取出し可能で相関基準に合致している次のメッセージを取り出します。 デフォルトは1です。 |
correlation | デキューされるメッセージのオプションの相関識別子を指定します。Oracle Advanced Queuingでは、特定の相関値に基づいてメッセージのキューを検索できます。「%」などのLIKE比較演算子を使用して、識別子の文字列を指定できます。NULLの場合、ワークフロー・エンジンではWorkflowスキーマ名と項目タイプに基づいて相関識別子が作成されます。 |
acctname | Oracle Workflowデータベースのアカウント名。アカウント名がNULLの場合、デフォルトはUSERという疑似列になります。 |
itemtype | 相関を指定していない場合、デキューするメッセージに対するオプションの項目タイプを指定します。 |
message_handle | デキューされる特定のイベントに対する、オプションのメッセージ・ハンドルIDを指定します。メッセージのハンドルIDを指定すると相関識別子は無視されます。 |
注意: キューから読み込むものがなくなると、タイムアウト出力はTRUEという値を戻します。
前へ | 次へ | 目次 | 索引 | 用語集 |