前へ	次へ		目次	索引	用語集

procedure CompleteActivity

    (itemtype in varchar2,

     itemkey in varchar2,

     activity in varchar2,

     result in varchar2);

Java構文

public static boolean completeActivity

    (WFContext wCtx,

     String itemType,

     String itemKey,

     String activity,

     String result)

説明

特定の項目について指定されたアクティビティが完了したことを、ワークフロー・エンジンに通知します。 このプロシージャは、次の状況でコールできます。

• 完了したアクティビティとオプションの結果を通知する場合: ワークフロー・エンジンに非同期アクティビティが完了したことを知らせます。このプロシージャを実行するには、現在、アクティビティのステータスが「通知済」になっている必要があります。オプションでアクティビティの完了結果も渡すことができます。この結果により、プロセスの次のトランジションを判別できます。

• 新規項目を作成して開始する場合: 「開始」アクティビティで新規項目が暗黙的に作成されて開始されるように、CompleteActivity()をコールします。「開始」アクティビティは、Workflow Builderでプロセスの始めとして指定されています。このコールで指定する項目タイプおよびキーは、この項目を処理する後続のすべてのコールに渡す必要があります。

CreateProcess()とStartProcess()を使用してプロセスを開始できない場合は、CompleteActivity()を使用してください。 たとえば、プロセス・スレッドの始めではなく途中にあるアクティビティ・ノードでプロセスを開始する必要がある場合は、CompleteActivity()をコールします。 プロセスの始めとして指定するアクティビティ・ノードは、そのプロパティ画面の「ノード」タブで「開始」に設定しないと、エラーが発生します。

注意: プロセスの開始にCompleteActivity()を使用する方法と、CreateProcess()およびStartProcess()を使用する方法には、次のような違いがあります。

• CompleteActivity()でコールする「開始」アクティビティには、入力トランジションがあってもなくてもかまいません。 StartProcess()では、入力トランジションのない「開始」アクティビティのみが実行されます。

• CompleteActivity()では、コールされた単一の「開始」アクティビティのみが完了します。プロセス内の他の「開始」アクティビティは完了しません。 ただし、StartProcess()では、プロセス内で「開始」アクティビティとしてマーク付けされていて、入力トランジションを持たない各アクティビティが実行されます。

• CompleteActivity()では、コールされたアクティビティは実行されず、完了マークのみが設定されます。 StartProcess()では、プロセスの開始時の「開始」アクティビティが実行されます。

• CompleteActivity()を使用して新規プロセスを開始する場合、完了するアクティビティの項目タイプには、ルート・プロセスを選択するセレクタ関数が定義されているか、「開始」アクティビティとしてマークされていて完了するアクティビティには、実行可能なプロセスが1つのみである必要があります。 StartProcess()のように、ルート・プロセスを明示的に指定することはできません。

wCtx	ワークフローのコンテキスト情報。Javaメソッドの場合にのみ必須です。 「Oracle Workflowのコンテキスト」を参照してください。
itemtypeまたはitemType	有効な項目タイプ。
itemkeyまたはitemKey	アプリケーション・オブジェクトの主キーから生成される文字列。この文字列により、項目タイプの項目が一意に識別されます。項目タイプと項目キーにより、プロセスが識別されます。
activity	完了したアクティビティ・ノードの名前。アクティビティ・ノードのラベル名を指定します。アクティビティ・ノードのラベル名で特定のサブプロセスを識別できない場合は、ラベル名の前に親プロセスの内部名を追加できます。 たとえば、<parent_process_internal_name>:<label_name>のように指定します。 このアクティビティ・ノードは、「開始」アクティビティとしてマークされている必要があります。
result	オプションのアクティビティの完了結果。有効な値は、プロセス・アクティビティの「結果タイプ」、またはエンジンの標準の結果の1つによって決まります。 「AbortProcess」を参照してください。

例1

/*Complete the 'ENTER ORDER' activity for the 'ORDER' item type. The 'ENTER ORDER' activity allows creation of new items since it is the start of a workflow, so the item is created by this call as well.*/

wf_engine.CompleteActivity('ORDER', to_char(order.order_id),

                 'ENTER_ORDER', NULL);

例2

/*Complete the 'LEGAL REVIEW' activity with status 'APPROVED'. The item must already exist.*/

wf_engine.CompleteActivity('ORDER', '1003', 'LEGAL_REVIEW',

                 'APPROVED');

例3

/*Complete the BLOCK activity which is used in multiple subprocesses in parallel splits.*/

wf_engine.CompleteActivity('ORDER', '1003', 'ORDER_PROCESS:BLOCK-3',

                 'null');