前へ	次へ		目次	索引	用語集

procedure LaunchProcess

    (itemtype in varchar2,

     itemkey in varchar2,

     process in varchar2 default '',

     userkey in varchar2 default '',

     owner in varchar2 default '');

Java構文

public static boolean launchProcess

    (WFContext wCtx,

     String itemType,

     String itemKey,

     String process,

     String userKey,

     String owner)

説明

新しいランタイム・プロセスを作成し、指定したプロセスを開始して実行します。このプロシージャは、CreateProcessとStartProcessを組み合せたラッパーです。

引数（入力）

wCtx	ワークフローのコンテキスト情報。Javaメソッドの場合にのみ必須です。 「Oracle Workflowのコンテキスト」を参照してください。
itemtype	有効な項目タイプ。
itemkey	アプリケーション・オブジェクトの主キーから導出される文字列。この文字列により、項目タイプの項目が一意に識別されます。項目タイプと項目キーによって新しいプロセスが識別されるため、そのプロセスの後続のすべてのAPIコールにそれらを渡す必要があります。

注意: プロセス・インスタンスの項目キーに使用できるのは、1バイトのキャラクタのみです。マルチバイトの値を含めることはできません。

注意: itemkeyとして#SYNCHを渡して、強制同期プロセスを作成できます。 「同期プロセス、非同期プロセスおよび強制同期プロセス」を参照してください。

process	その項目の特定のプロセスを選択するためのオプションの引数。プロセスの内部名を指定します。プロセスがNULLの場合は、項目タイプのセレクタ関数によって、実行する最上位レベルのプロセスが判別されます。この引数のデフォルト値はNULLです。
userkey	指定した項目タイプと項目キーで識別される項目に割り当てるユーザー・キー。ユーザー・キーがNULLの場合は、項目インスタンスにユーザー・キーは割り当てられません。
owner	有効なロール。項目の所有者として指定します。所有者がNULLの場合は、プロセスに所有者は割り当てられず、プロセスを監視できるのはワークフローの管理者ロールのみとなります。

注意: データベース・トリガーからCreateProcess( )およびStartProcess( )をコールしてワークフロー・プロセスを開始できますが、状況によってはこの方法を使用しないでください。たとえば、データベース・エンティティにヘッダー、行および詳細があり、そのエンティティのヘッダー・レベルでAFTER INSERTトリガーからワークフロー・プロセスを実行すると、ワークフロー・プロセスが失敗することがあります。これは、プロセス内の後続のアクティビティによって、まだ値が挿入されていないエンティティの行レベルや詳細レベルの情報が要求されることがあるためです。

注意: ワークフロー・エンジンは、エラー発生時に直前のアクティビティにロールバックできるように、各アクティビティを実行する前に常にセーブポイントを発行します。データベース・トリガーや分散トランザクションなど、セーブポイントを使用できない環境では、ワークフロー・エンジンは自動的に「セーブポイントの使用不可」エラーを検出し、アクティビティの実行を遅延させます。ワークフロー・プロセスをデータベース・トリガーから開始する必要があれば、初期の「開始」アクティビティを即時にバックグラウンド・エンジンに遅延して、データベース・トリガーから実行されないようにする必要があります。