前へ	次へ		目次	索引	用語集

これらのメソッドは、Javaパッケージ「oracle.apps.fnd.wf.engine」内のWFEngineAPIクラスとWFNotificationAPIクラスに定義されています。ワークフロー・エンジンまたは通知のAPIに対応するJavaメソッドがある場合は、ドキュメント内でPL/SQL構文に続いて対象のJavaメソッドの構文が表示されます。 「Workflow Engine API」および「通知API」を参照してください。

また、Java関数を外部Java関数アクティビティとしてワークフロー・プロセス内に組み込むことができます。現在、この機能を使用できるのはOracle Workflowのスタンドアロン版のみです。これらのアクティビティのカスタムJavaクラスは、WFFunctionAPIクラスの拡張クラスとして実装します｡カスタム・クラスは、Oracle WorkflowのJava関数アクティビティ・エージェントで正しく実行できるように、標準APIの書式に従う必要があります。 『Oracle Workflow開発者ガイド』の関数アクティビティがコールするJavaプロシージャの標準APIに関する項、および『Oracle Workflow開発者ガイド』の関数アクティビティに関する項を参照してください。

WFFunctionAPIクラスとWFAttributeクラスには、Oracle Workflowと通信するときにコールできるメソッドも含まれています。これらのクラスは、Javaパッケージ「oracle.apps.fnd.wf」に定義されています。 「Workflow関数API」および「Workflow属性API」を参照してください。

Oracle Workflowと統合するJavaプログラムには、次のimport文を含めて、Oracle Workflowに必要なクラスへのアクセス権を付与する必要があります。

import java.io.*; 

import java.sql.*; 

import java.math.BigDecimal; 



import oracle.sql.*; 

import oracle.jdbc.driver.*;



import oracle.apps.fnd.common.*; 

import oracle.apps.fnd.wf.engine.*; 

import oracle.apps.fnd.wf.*; 

Oracle Workflowのコンテキスト

WFDB myDB;

WFContext ctx;

myDB = new WFDB(m_user, m_pwd, m_jdbcStr, m_conStr);

m_charSet = System.getProperty("CHARSET");

if (m_charSet == null) { // cannot be null

  m_charSet = "UTF8";

}

try {

  ctx = new WFContext(myDB, m_charSet); 

  // m_charSet is 'UTF8' by default



  if (ctx.getDB().getConnection() == null) {

    // connection failed

    return;

  }

  // We now have a connection to the database.

}



catch (Exception e) {

// exit Message for this exception

}

JDBC接続をすでに確立している場合は、次の例で示すように、その接続をWFContextオブジェクトに設定します。

WFContext ctx;

m_charSet = System.getProperty("CHARSET");

if (m_charSet == null) { // cannot be null

  m_charSet = "UTF8";

}



ctx = new WFContext(m_charSet); 

// m_charSet is 'UTF8' by default

ctx.setJDBCConnection(m_conn);  

// m_conn is a pre-established JDBC connection

Oracle Workflow Java APIはスレッド内で安全に使用できますが、次のような制限事項があります。

• 各スレッドに独自のWFContextオブジェクトが必要です。したがって、スレッドを開始する前にWFContextをインスタンス化しないでください。コンテキストごとにエラー・スタックが管理されるので、コンテキストを共有することはできません。

• 異なるワークフローに同じJDBC接続を使用しないでください。同じ接続を使用すると、関連のないトランザクションのコミットやロールバックで問題が発生する可能性があります。

Oracle Workflow Java APIには接続プーリングもありません。 Oracle Applicationsの場合、接続プーリングはAOL/Jレベルで実装されます。JDBC接続を取得した後、WFContext.setJDBCConnection() APIを使用して接続を設定します。 この方法を使用すれば、JDBC接続をOracle Workflow APIの外部で管理できます。

Javaプログラムのサンプル

setenv CLASSPATH 

<Workflow_JAR_file_directory>/wfapi.jar:${ORACLE_HOME}/jdbc/lib/classes111.zip

setenv LD_LIBRARY_PATH ${ORACLE_HOME}/lib:${LD_LIBRARY_PATH}

注意: Oracle Workflowスタンドアロン版を使用している場合、Workflow JARファイルは<ORACLE_HOME>/jlibディレクトリに格納されています。 Oracle Applicationsに組み込まれているWorkflowを使用している場合、Workflow JARファイルは<ORACLE_HOME>/wf/java/oracle/apps/fnd/wf/jar/ディレクトリに格納されています。

WFTestプログラムを開始するには、oracle.apps.fnd.wf.WFTestに対してJavaコマンドを実行します。 たとえば、UNIXの場合は、コマンドラインに次の文を指定します。

$java oracle.apps.fnd.wf.WFTest

このプログラムのソース・ファイルは、Oracle Workflowのインストールにも含まれているため、サンプル・コードを表示できます。 ソース・ファイル名はWFTest.javaで、<ORACLE_HOME>/wf/java/oracle/apps/fnd/wf/ディレクトリにあります。