Oracle Workflow APIリファレンス リリース2.6.3.5 部品番号: B15622-01 |
![]() |
![]() |
![]() |
![]() |
![]() |
||
前へ | 次へ | 目次 | 索引 | 用語集 |
function Error
(p_subscription_guid in raw,
p_event in out wf_event_t) return varchar2;
説明
ステータス・コードERRORを返します。また、この関数をサブスクリプションのルール関数として割り当てるときは、エラー・メッセージの内部名を表すテキスト文字列をサブスクリプションの「パラメータ」フィールドに入力する必要があります。 サブスクリプションが実行されると、Error()は、setErrorMessage()を使用してそのエラー・メッセージをイベント・メッセージに格納します。 「setErrorMessage」を参照してください。
「パラメータ」フィールドに入力するテキスト文字列は、有効なOracle Workflowエラー・メッセージ名である必要があります。Oracle Workflowから提供されるエラー・メッセージの名前は、WFERRタイプのメッセージとして、WF_RESOURCES表のNAME列に格納されています。
特定のイベントが発生するたびに、事前定義済のWorkflowエラー・メッセージを含むエラー通知をシステム管理者に送信する場合は、Error()をサブスクリプションのルール関数として使用できます。
たとえば、対象となるイベントへのサブスクリプションを定義し、ルール関数WF_RULE.Errorを指定し、その「パラメータ」フィールドにWFSQL_ARGSと入力します。次に、そのイベントを呼び出し、サブスクリプションをトリガーします。 Error()がステータス・コードERRORを返すため、イベント・マネージャはイベント・メッセージをWF_ERRORキューに格納し、イベントのサブスクリプション処理が停止します。 WF_ERRORキュー上でリスナーが動作しているときは、エラー通知がシステム管理者に送信されます。このエラー通知には、「引数に無効な値が渡されました。」というメッセージが含まれます。これが、WFSQL_ARGSエラー・メッセージの表示名になります。
注意: コール元のアプリケーションが正常に処理を完了した場合、Error()はそのアプリケーションに対して例外を呼び出しません。
引数(入力)
p_subscription_ guid | サブスクリプションのグローバル一意識別子。 |
p_event | イベント・メッセージ。 |
前へ | 次へ | 目次 | 索引 | 用語集 |