BEA ホーム | 製品 | デベロッパ・センタ | support | askBEA
 ドキュメントのダウンロード   サイト マップ   用語集 
検索

BPM クライアント アプリケーション プログラミング

 前 次 目次 索引 PDFで表示  

実行時の変数のモニタリング

この章では、実行時の変数をモニタする方法について説明します。内容は以下のとおりです。

WebLogic Integration Studio を使用して実行時の変数をモニタする方法の詳細については、『WebLogic Integration Studio ユーザーズ ガイド』の「ワークフローのモニタリング」を参照してください。

 


ワークフロー インスタンスの変数の取得

ワークフロー インスタンスに関連した変数のリストを取得するには、次の com.bea.wlpi.server.admin.Admin メソッドを使用します。

public java.util.List getInstanceVariables(
java.lang.String instanceId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

getInstanceVariables() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。

表23-1 getInstanceVariables() メソッドのパラメータ

パラメータ

説明

有効な値

instanceId

変数を取得するワークフロー インスタンスの ID

有効なワークフロー インスタンス ID。

ワークフロー インスタンス ID を取得するには、ワークフロー インスタンスの取得で説明するように、タスクを取得するインスタンスに対応する InstanceInfo オブジェクトを取得する必要がある。インスタンス ID を取得するには、次の com.bea.wlpi.common.InstanceInfo メソッドを使用する。

public final java.lang.String getId()

注意: InstanceInfo オブジェクトで利用可能なメソッドの詳細については、InstanceInfo オブジェクトを参照してください。


 

このメソッドは、com.bea.wlpi.common.VariableInfo オブジェクトのリストを返します。各変数に関する情報にアクセスするには、VariableInfo オブジェクトで説明する VariableInfo オブジェクトを使用します。

注意: XML の型の変数の場合、返される値は byte[ ] 型になります。戻り値をプリントまたは表示するには、それを String の値にコンバートする必要があります。たとえば、次のコードでは、byte[ ] 型の variable の値が String の値にコンバートされます。

String value=new String((byte[ ])variable.getValue())

たとえば、次のコードでは、指定されたインスタンス ID に対応するワークフロー インスタンスに対する変数が取得されます。このコード例では、adminAdmin EJB への EJBObject 参照を表します。

List list = admin.getInstanceVariables(instance.getId());

インスタンス ID は、com.bea.wlpi.common.InstanceInfo オブジェクトの instance に関連した getInstanceId() メソッドを使用して取得されます。instance オブジェクトは、ワークフロー インスタンスの取得に記載のメソッドを使用して取得されます。

getInstanceVariables() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。

 


ワークフロー インスタンスの変数の設定

ワークフロー インスタンスに関連する変数を設定するには、次の com.bea.wlpi.server.admin.Admin メソッドのいずれかを使用します。

public void setInstanceVariable(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String variable,
java.lang.Object value
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
public void setInstanceVariables(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String variables
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException

setInstanceVariable() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。

表23-2 setInstanceVariable() メソッドのパラメータ

パラメータ

説明

説明

templateDefinitionId

ユーザがワークフロー インスタンスの変数を設定するテンプレート定義の ID

有効なテンプレート定義 ID。

テンプレート定義のインスタンス ID を取得するには、ワークフロー インスタンスの取得で説明するように、インスタンス変数を設定するインスタンスに対応する InstanceInfo オブジェクトを取得する必要がある。インスタンス ID を取得するには、次の com.bea.wlpi.common.InstanceInfo メソッドを使用する。

public final java.lang.String getTemplateDefinitionId()

注意: InstanceInfo オブジェクトで利用可能なメソッドの詳細については、InstanceInfo オブジェクトを参照してください。

instanceId

タスクと対応するワークフロー インスタンスの ID

有効なワークフロー インスタンス ID。

テンプレート定義のインスタンス ID を取得するには、ワークフロー インスタンスの取得で説明するように、インスタンス変数を設定するインスタンスに対応する InstanceInfo オブジェクトを取得する必要がある。インスタンス ID を取得するには、次の com.bea.wlpi.common.InstanceInfo メソッドを使用する。

public final java.lang.String getInstanceId()

注意: InstanceInfo オブジェクトで利用可能なメソッドの詳細については、InstanceInfo オブジェクトを参照してください。

variable

ユーザが設定する変数の名前

有効な変数名。

変数名を取得するには、次の com.bea.wlpi.common.VariableInfo メソッドを使用する。

public final String getName()

VariableInfo オブジェクトの取得に関する詳細については、ワークフロー インスタンスの変数の取得を参照。VariableInfo オブジェクトで利用可能なメソッドの詳細については、VariableInfo オブジェクトを参照。

variables

変数名と値

キーとして設定される変数、および値として必要な値を指定する「key-value」ペアを持つマップ オブジェクト。

value

変数用に該当する値

指定された変数に対して有効な値。

value パラメータ用にサポートされているコンバートのリストについては、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。


 

たとえば、次のコードでは、指定された変数が指定された value に設定され、更新されます。このコード例では、adminAdmin EJB への EJBObject 参照を表します。

admin.setInstanceVariable(
instance.getTemplateDefinitionId(),
instance.getInstanceId(),
variable.getName(),
value
);

変数名は、com.bea.wlpi.common.VariableInfo オブジェクトの variable に関連した getName() メソッドを使用して取得されます。変数のオブジェクトは、ワークフロー インスタンスの変数の取得に記載のメソッドを使用して取得されます。テンプレート定義とワークフロー インスタンス ID は、com.bea.wlpi.common.InstanceInfo オブジェクトである instance と関連付けられたメソッドを使用して取得されます。instance オブジェクトは、ワークフロー インスタンスの取得に記載のメソッドを使用して取得されます。

com.bea.wlpi.common.VariableInfocom.bea.wlpi.common.TaskInfo メソッドの詳細については、値オブジェクトのまとめを参照してください。

setInstanceVariable() および setInstanceVariables() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。

 

ページの先頭 前 次