ワークフローテンプレートの作成および管理

public java.lang.String createTemplate(
java.lang.String name,
java.lang.String xml,
java.util.Collection orgs,
java.lang.Object transactionId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

表13-1 createTemplate() メソッドのパラメータ

パラメータ	説明	有効な値
name	テンプレート名	非ヌル文字列。
xml	プラグインデータを定義し、テンプレート定義 DTDに記載の Template Definition DTD に準拠する XML ドキュメント名 BPM プラグインのプログラミングの詳細については、『WebLogic Integration BPM プラグインプログラミングガイド』を参照。	非ヌル文字列。
orgs	テンプレートにアクセスできるオーガニゼーション ID のコレクション	有効なオーガニゼーション ID を含む文字列のコレクション。オーガニゼーション ID のリストの取得については、すべてのオーガニゼーション名を取得するを参照。
transactionId	トランザクションの ID 注意: このパラメータは、クラスタ化環境においてのみ必要です。	ユニークなトランザクション ID を指定するオブジェクト。ユニークなトランザクション ID を生成するには、次のコンストラクタを使用して新しい com.bea.wlpi.client.common.GUID オブジェクトを作成する。 GUID transactionId = new GUID(); GUID クラスの詳細については、Javadoc の com.bea.wlpi.client.common.GUID を参照。

パラメータ	説明	有効な値
templateId	検索するテンプレートの ID または名前	有効なテンプレート ID または名前を指定する文字列。
byName	templateId パラメータに指定された値がテンプレート名 (true) または ID (false) であるかを指定するブールフラグ	true (名前) または false (名前)。

パラメータ

説明

有効な値

templateId

検索するテンプレートの ID または名前

有効なテンプレート ID または名前を指定する文字列。

byName

templateId パラメータに指定された値がテンプレート名 (true) または ID (false) であるかを指定するブールフラグ

true (名前) または false (名前)。

パラメータ	説明	有効な値
orgId	テンプレートを取得するオーガニゼーションの ID	有効なオーガニゼーション ID を指定する文字列。オーガニゼーション ID のリストの取得については、すべてのオーガニゼーション名を取得するを参照。

パラメータ

説明

有効な値

orgId

テンプレートを取得するオーガニゼーションの ID

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

オーガニゼーション ID のリストの取得については、すべてのオーガニゼーション名を取得するを参照。

パラメータ	説明	有効な値
templateId	オーガニゼーションの検索を行うテンプレートの ID	有効なテンプレート ID を指定する文字列。テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。 public final java.lang.String getId() TemplateInfo オブジェクトを取得する方法については、オーガニゼーションのテンプレートの取得を参照。TemplateInfo オブジェクトで選択可能なメソッドの詳細については、TemplateInfo オブジェクトを参照。

パラメータ

説明

有効な値

templateId

オーガニゼーションの検索を行うテンプレートの ID

有効なテンプレート ID を指定する文字列。

テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。

public final java.lang.String
getId()

TemplateInfo オブジェクトを取得する方法については、オーガニゼーションのテンプレートの取得を参照。TemplateInfo オブジェクトで選択可能なメソッドの詳細については、TemplateInfo オブジェクトを参照。

パラメータ	説明	有効な値
templateId	オーガニゼーションの設定を行うテンプレートの ID	有効なテンプレート ID を指定する文字列。テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。 public final java.lang.String getId() TemplateInfo オブジェクトを取得する方法については、オーガニゼーションのテンプレートの取得を参照。TemplateInfo オブジェクトで選択可能なメソッドの詳細については、TemplateInfo オブジェクトを参照。
orgs	テンプレートにアクセスできるオーガニゼーション ID のコレクション	有効なオーガニゼーション ID を含む文字列のコレクション。オーガニゼーション ID のリストの取得については、すべてのオーガニゼーション名を取得するを参照。

パラメータ

説明

有効な値

templateId

オーガニゼーションの設定を行うテンプレートの ID

有効なテンプレート ID を指定する文字列。

テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。

public final java.lang.String
getId()

orgs

テンプレートにアクセスできるオーガニゼーション ID のコレクション

有効なオーガニゼーション ID を含む文字列のコレクション。オーガニゼーション ID のリストの取得については、すべてのオーガニゼーション名を取得するを参照。

パラメータ	説明	有効な値
info	テンプレート名、ID、および新情報	name および ID フィールドを含む TemplateInfo オブジェクトは、更新する既存テンプレートを識別するために設定され、残りのフィールドは新しい情報に設定される。

パラメータ

説明

有効な値

info

テンプレート名、ID、および新情報

name および ID フィールドを含む TemplateInfo オブジェクトは、更新する既存テンプレートを識別するために設定され、残りのフィールドは新しい情報に設定される。

パラメータ	説明	有効な値
templateId	削除するテンプレートの ID	有効なテンプレート ID を指定する文字列。テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。 public final java.lang.String getId() TemplateInfo オブジェクトを取得する方法については、オーガニゼーションのテンプレートの取得を参照。TemplateInfo オブジェクトで選択可能なメソッドの詳細については、TemplateInfo オブジェクトを参照。

パラメータ

説明

有効な値

templateId

削除するテンプレートの ID

有効なテンプレート ID を指定する文字列。

テンプレート ID を取得するには、次の com.bea.wlpi.common.TemplateInfo メソッドを使用する。

public final java.lang.String
getId()

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

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

/* メインメニューを表示してユーザと交信する */
while( true ) {
/* メニューを表示する */
System.out.println( "¥n--- Main Menu ---" );
System.out.println( "¥nEnter choice:" );
System.out.println( "1) Templates" );
System.out.println( "2) Task Reroutes" );
System.out.println( "Q) Quit" );
System.out.print( ">> " );
.
.
.
/**
* WLPI ワークフローテンプレートと関連する、Admin インタフェースで選択可能な公開 API メソッドを示す目的で
* 必要な情報をすべて取得するために
* ユーザと交信するメソッド
*/
public static void mngTemplates() {
ArrayList orgsList = new ArrayList();
String answer;
String orgId;
String templateId;
String templateName;

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

try {
/* メニューを表示してユーザと交信する*/
while( true ) {
/* メニューを表示する */
System.out.println( "¥n¥n--- Workflow Templates ---" );
System.out.println( "¥nEnter choice:" );
System.out.println( "1) Create a Template" );
System.out.println( "2) Delete a Template" );
System.out.println( "3) List Templates for an Organization" );
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 selection" );
continue;
}

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

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

/* テンプレートを作成する */
case '1' :
/* テンプレート名を取得する */
if( ( templateName = askQuestion( "¥nEnter Template Name" ) )
== null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
break;
}

System.out.println( "¥nDefining organizations where
the template is accessible" );
boolean isEnterMore = true;
boolean isCancelled = false;

/* オーガニゼーション ID リストを取得するループ */
while( isEnterMore ) {
/* アクティブに設定するオーガニゼーションのオーガニゼーション ID を取得する */
if( ( orgId = askQuestion( "Enter an Organization ID" ) )
== null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
isCancelled = true;
break;
}

orgsList.add( orgId );

/* さらにオーガニゼーション ID を入力するためにループを継続するか ? */
if( ( answer = askQuestion( "Enter more (y/n)?" ) ) == null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
isCancelled = true;
break;
}

/* 応答を評価する */
isEnterMore = ( answer.equals( "y" ) || answer.equals( "Y" ) );
}

/* ユーザが操作をキャンセルしたか ? */
if( isCancelled )
break;

try {
/* WLPI 公開 API メソッド */
/* 新しいテンプレートを作成する */
templateId = admin.createTemplate( templateName, null, orgsList );

/* 正常終了（例外の発生なし） */
System.out.println( "- Created (template Id = " +
templateId + ")" );
}
catch( Exception e ) {
System.out.println( "*** Unable to create Template" );
System.err.println( e );
}
break;
.
.
.

/* テンプレートを削除する */
case '2' :
/* 削除するテンプレートのテンプレート ID を取得する */
if( ( templateId = askQuestion( "¥nEnter Template ID
to delete" ) ) == null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
break;
}

try {
/* WLPI 公開 API メソッド */
/* テンプレートを削除する */
admin.deleteTemplate( templateId );

/* 正常終了（例外の発生なし） */
System.out.println( "- Deleted" );
}
catch( Exception e ) {
System.out.println( "*** Unable to delete Template" );
System.err.println( e );
}
break;

/* オーガニゼーションのテンプレートをリストアップする */
case '3' :
/* クエリするオーガニゼーションのオーガニゼーション ID を取得する */
if( ( orgId = askQuestion( "¥nEnter Organization ID" ) ) == null ) {
/* ユーザによる操作の取り消し */
System.out.println( "*** Cancelled" );
break;
}

/* WLPI 公開 API メソッド */
/* このオーガニゼーションで定義されているすべてのテンプレートを取り出す */
/* 注意 : 発生した例外を取り込むコードを
* 追加するとよい */
List templateList = admin.getTemplates( orgId );

/* 定義されているテンプレートはあるか ? */
if( templateList.size() == 0 )
System.out.println( "¥nNo template defined" );
else
System.out.println( "¥nDefined Templates:" );

/* リストを処理して、テンプレートを表示する */
for( int i = 0; i < templateList.size(); i++ ) {
/* リストから要素を取り出す */
TemplateInfo templateInfo =
( TemplateInfo )templateList.get( i );

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

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