ヘッダーをスキップ
Oracle Workflow APIリファレンス リリース2.6.3.5 部品番号: B15622-01
|
Default_Rule
PL/SQL構文
function Default_Rule
(p_subscription_guid in raw,
p_event in out wf_event_t) return varchar2;
説明
イベント・サブスクリプションのデフォルトのサブスクリプション処理を実行します。 次の処理が、デフォルトで実行されます。
- ワークフロー・プロセスへのイベント・メッセージの送信(サブスクリプション定義で指定されている場合)
- エージェントへのイベント・メッセージの送信(サブスクリプション定義で指定されている場合)
これらの操作のどちらかで例外が発生した場合、Default_Rule()は、その例外をトラップし、エラー情報をイベント・メッセージに格納して、ステータス・コードERRORを返します。 例外が発生しなかった場合は、ステータス・コードSUCCESSを返します。
注意: イベント・メッセージが「デフォルト・イベント・エラー」ワークフロー・プロセスに送信される場合、Default_Rule()は、プロセスの項目キーとして相関IDを新しく生成し、項目キーが一意になるようにします。
イベント・メッセージに対してカスタム・ルール関数を実行してから、イベント・メッセージを送信する場合は、カスタム・ルール関数を使用するサブスクリプションを下位のフェーズ番号で定義し、イベントを送信するデフォルト・ルール関数を使用するサブスクリプションを上位のフェーズ番号で定義します。
たとえば、次の手順で行います。
1. カスタム・ルール関数とフェーズ番号10を使用して、対象となるイベントへのサブスクリプションを定義します。
2. ルール関数WF_EVENT.Default_Ruleとフェーズ番号20を使用して、そのイベントへのサブスクリプションをもう1つ定義し、イベントの送信先となるワークフローまたはエージェントを指定します。
3. イベントを呼び出して、それらのサブスクリプションをトリガーします。まず、フェーズ番号が下位のサブスクリプションが実行され、イベント・メッセージに対してカスタム・ルール関数が実行されます。イベントが2番目のサブスクリプションに渡されると、変更されたイベント・メッセージが指定のワークフローまたはエージェントに送信されます。
Default_Rule()をコールして、カスタム・ルール関数内にデフォルトの送信処理を追加することもできます。 サブスクリプションに対してDefault_Rule()以外のルール関数を入力した場合は、サブスクリプションに指定されたワークフローおよびエージェントに対して、イベント・メッセージは自動的に送信されません。 このサブスクリプションからメッセージを送信する場合は、送信処理をカスタム・ルール関数に明示的に組み込む必要があります。Default_Rule()をコールして組み込むこともできます。 『Oracle Workflow開発者ガイド』のイベント・サブスクリプションのルール関数の標準APIに関する項を参照してください。
注意: 再利用できない複雑で特別なルール関数を作成するのではなく、再利用できる単純なルール関数を作成して複数のサブスクリプションをイベントに定義することをお薦めします。
引数(入力)
p_subscription_ guid
| サブスクリプションのグローバル一意識別子。
|
p_event
| イベント・メッセージ。
|
Copyright © 2003, 2004, Oracle. All rights reserved.