手動によるワークフローの開始

パラメータ	説明	有効な値
orgId	開始可能なワークフローの名前を取得するオーガニゼーションの ID	有効なオーガニゼーション ID を指定する文字列。すべてのオーガニゼーション ID のリストの取得方法については、アクティブなオーガニゼーションの管理を参照。

パラメータ

説明

有効な値

orgId

開始可能なワークフローの名前を取得するオーガニゼーションの ID

有効なオーガニゼーション ID を指定する文字列。

すべてのオーガニゼーション ID のリストの取得方法については、アクティブなオーガニゼーションの管理を参照。

public java.lang.String instantiateWorkflow(
java.lang.String orgId,
java.lang.String templateId,
java.lang.String xml,
java.util.Map initialValues,
java.util.Map pluginData
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

public java.lang.String instantiateWorkflow(
java.lang.String orgId,
java.lang.String templateId,
java.lang.Object transactionId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

public java.lang.String instantiateWorkflow(
java.lang.String orgId,
java.lang.String templateId,
java.lang.String xml,
java.util.Map initialValues,
java.util.Map pluginData,
java.lang.Object transactionId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

表20-2 instantiateWorkflow() メソッドのパラメータ

パラメータ	説明	有効な値
orgId	ユーザが開始するワークフローに関連したオーガニゼーションの ID	有効なオーガニゼーション ID を指定する文字列。すべてのオーガニゼーション ID のリストの取得方法については、アクティブなオーガニゼーションの管理を参照。
templateId	ワークフローを開始するワークフローテンプレートの ID	有効なテンプレート ID を指定する文字列。テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。 public final String getId() getId() メソッドは、templateId を返す。各 templateId には、複数の定義が含まれる可能性がある。どのテンプレート定義を使用するか判断するために、WebLogic Integration はアクティブテンプレート定義セットの中から、もっとも有効で適切な日付（現在または過去の日付）と終了日（現在または将来の日付）を持つバージョンを選択する。テンプレート定義に有効日および終了日を定義し、テンプレート定義をアクティブ化する方法については、テンプレート定義 DTD、または『WebLogic Integration Studio ユーザーズガイド』を参照。 TemplateInfo オブジェクトを取得する方法については、オーガニゼーションのテンプレートの取得を参照。TemplateInfo オブジェクトで選択可能なメソッドの詳細については、TemplateInfo オブジェクトを参照。
xml	ワークフローインスタンスの初期設定値	ワークフローインスタンスに有意な初期設定値を含む XML ドキュメント。初期設定値が不要の場合は null。
initialValues	ワークフロー変数の初期値	キーとして初期設定される変数、および値として必要な値を指定する「key-value」ペアを持つマップオブジェクト。変数の初期設定が不要の場合は null を指定するマップオブジェクト。
pluginData	プラグインインスタンスデータ	キーとしてプラグイン名を指定し、および値としてインスタンスデータを指定する「key-value」ペアを持つマップオブジェクト。プラグインデータの定義が不要な場合は、null を指定するマップオブジェクト。 BPM プラグインのプログラミングの詳細については、『WebLogic Integration BPM プラグインプログラミングガイド』を参照。
transactionId	トランザクションの ID 注意: このパラメータは、クラスタ化環境においてのみ必要です。	ユニークなトランザクション ID を指定するオブジェクト。ユニークなトランザクション ID を生成するには、次のコンストラクタを使用して新しい com.bea.wlpi.client.common.GUID オブジェクトを作成する。 GUID transactionId = new GUID(); GUID クラスの詳細については、Javadoc の com.bea.wlpi.client.common.GUID を参照。

/* ユーザとの通信のための入力ストリームを作成する */
stdIn = new BufferedReader( new InputStreamReader( System.in ) );

/* ツールタイトルを表示する */
System.out.print( "¥n--- Command Line Worklist v1.2 ---" );

/* メインメニューを表示してユーザと交信する */
while( true ) {
/* メニューを表示する */
System.out.println( "¥n--- Main Menu ---" );
System.out.println( "¥nEnter choice:" );
System.out.println( "1) Organizations" );
System.out.println( "2) Workflows" );
System.out.println( "3) Tasks" );
System.out.println( "Q) Quit" );
System.out.print( ">> " );
.
.
.
public static void mngWorkflows( ) {
String templateId;

/* ユーザとの通信のための入力ストリームを作成する */
BufferedReader stdIn = new BufferedReader(
new InputStreamReader( System.in ) );

try {
/* メインメニューを表示してユーザと交信する */
while( true ) {
/* メニューを表示する */
System.out.println( "¥n¥n--- Workflows ---" );
System.out.println( "¥nEnter choice:" );
System.out.println( "1) List Startable workflow templates" );
System.out.println( "2) Start a workflow" );
System.out.println( "B) Back to previous menu" );
System.out.println( "Q) Quit" );
System.out.print( ">> " );

/* ユーザの選択を取得する */
String line = stdIn.readLine( );

/* ユーザが選択を行わないで〔Enter〕を押したか ? */
if( line.equals( "" ) )
continue;
/* ユーザが複数の文字を入力したか ? */
else if( line.length( ) > 1 ) {
System.out.println( "*** Invalid choice" );
continue;
}

/* 大文字および文字へのコンバート*/
char choice = line.toUpperCase( ).charAt( 0 );

/* ユーザの選択を処理する */
switch( choice ) { ...

/*開始可能なワークフローテンプレートをリストアップする */
case '1' :
/* WLPI 公開 API メソッド */
/* 注意 : 発生した例外を取り込むコードを
* 追加するとよい */
String activeOrgId = worklist.getActiveOrganization( );
List templateList;

/* WLPI 公開 API メソッド */
/* 注意 : 発生した例外を取り込むコードを
* 追加するとよい */
templateList = worklist.getStartableWorkflows( activeOrgId );

/* 開始可能なワークフローがあるか ? */
if( templateList.size( ) == 0 )
System.out.println( "¥nNo Startable Workflows." );
else
System.out.println( "¥nStartable Workflows:" );

/* リストを処理して、開始可能なワークフローを表示する */
for( int i = 0; i < templateList.size( ); i++ ) {
/* リストから要素を取り出す */
TemplateInfo templateInfo = (
TemplateInfo )templateList.get( i );

/* テンプレート ID と名前を取り出して表示する */
System.out.println( "- ID: " + templateInfo.getId( ) +
" Name: " + templateInfo.getName( ) );
}
break; ...

/* ワークフローテンプレートのインスタンス化 */
case '2' :
/* インストタンス化するワークフローのテンプレート ID を取得する */
if( ( templateId = askQuestion(
"¥nEnter Workflow Template ID" ) ) == null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
break;
}

try {
/* WLPI 公開 API メソッド */
/* アクティブなオーガニゼーション ID を取り出す */
activeOrgId = worklist.getActiveOrganization( );

/* WLPI 公開 API メソッド */
/* ワークフローをインスタンス化する */
String clientReq = worklist.instantiateWorkflow(
activeOrgId, templateId );

/* 正常終了（例外の発生なし） */
System.out.println( "- Success" );
// System.out.println( "- Client Request:¥n" + clientReq );

/* クライアントの要求 (もしあれば) を処理するために、
* サーバからの応答を解析する */
parser.handleRequest( clientReq );
}
catch( Exception e ) {
System.out.println(
"*** Failed to instantiate Workflow Template (ID: " +
templateId + ")" );
System.err.println( e );
}
break;

/* 前のメニューに戻る */
case 'B' :
return;

/* ツールを終了 */
case 'Q' :
/* サーバから切断 */
disconnect( );
System.exit( 1 );

default:
System.out.println( "*** Invalid choice" );
}
}
}
/* 「Unhandled」例外 */
catch( Exception e ) {
System.err.println( e );
}
return;
}

JSP Worklist へのプライマリインタフェースの図に示すように、ユーザが JSP Worklist 内の Start Workflow リンクをクリックして、開始可能なワークフローを選択すると、ワークフローが開始されます。次のように、Start Workflow リンクは startworkflow.jsp ファイルを参照します。

<%@ page import="
javax.ejb.*,
java.rmi.RemoteException,
java.util.*,
com.bea.wlpi.common.*
com.bea.wlpi.server.worklist.*
" session="true"%>

<jsp:usebean id="responseParser" class="jsp_servlet._worklist.ResponseParser" scope="session"/>

<%
Worklist worklist = null;
String name;
String error = null;
String currentOrg = (String)session.getValue("currentOrg");
worklist = (Worklist)session.getValue("worklist");
name = (String)session.getValue("name");

if (worklist != null) {
Hashtable h = new Hashtable();
h.put(javax.naming.Context.SECURITY_PRINCIPAL, name);
h.put(javax.naming.Context.SECURITY_CREDENTIALS,
(String)session.getValue("password"));
new javax.naming.InitialContext(h);

/* 開始パラメータが設定された場合にワークフローを開始する */
String start = request.getParameter("start");
if (start != null)
try {
responseParser.parse(worklist.instantiateWorkflow(
currentOrg, start));
session.removeValue("error");
if (responseParser.isQuery())
pageContext.forward("query.jsp");
else
pageContext.forward("worklist.jsp");
return;
} catch (Exception e) {
error = e.getMessage();
} out.println(error);
%>
<html>
<title>eProcess Integrator</title>
<head>
</head>

<body bgcolor=#ffffff>
<font face="Arial" size="4">

<table dir="ltr" border="0" cellpadding="1" cellspacing="1">
<tr>
<td><img src="logo.gif"></td>
<td>
<font color="red" size="7"><strong><em>Weblogic</em></strong></font>
<font color="black" size="7"><strong><em>Process Integrator
</em></strong></font></td>
</tr>
<tr>
<td bgcolor="navy" valign="top">
<table dir="ltr" border="0" cellpadding="2" cellspacing="2" >
<tr>
<td><font color="yellow"><strong>Go ...</strong></font></td>
</tr>
<tr>
<td><a href="worklist.jsp?worklist">
<font color="white">Worklist</font></a></td>
</tr>
<tr>
<td><a href="logoff.jsp"><font color="white">Logoff</font></a></td>
</tr>
</table>
</td>

<td valign="top">
<table dir="ltr" border="0" cellpadding="2" cellspacing="2" valign="top">
<tr>
<td><font color="navy" size="5" face="Arial">
Start Workflow</font></td>
</tr>

/* 開始可能なワークフロー名を取得し、それらをリストアップする /*
<%
try {
List templates = worklist.getStartableWorkflows(currentOrg);
for (int i = 0; i < templates.size(); i++) {
TemplateInfo info = (TemplateInfo)templates.get(i);

%>
<tr>
<td><a href="startworkflow.jsp?start=<%=info.getId()%>">
<%=info.getName()%></a></td>
</tr>
<%
}
} catch (Exception e) {
out.print("Error 3: " + e);
}
}
%>
</table>
</td>
</tr>
</table>
</font>
</body>
</html>