BEA ホーム | 製品 | デベロッパ・センタ | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > WebLogic Integration > BPM トピック > BPM クライアント アプリケーション プログラミング > タスクの管理 |
BPM クライアント アプリケーション プログラミング
|
タスクの管理
タスクは、テンプレート定義の作成に記載のように、テンプレート定義の作成プロセスの一部として定義されます。
この章では、タスクの管理方法について説明します。内容は以下のとおりです。
この章に記載するメソッドの詳細については com.bea.server.admin.Admin を参照してください。WebLogic Integration Studio を使用してタスクを管理する方法については、『WebLogic Integration Studio ユーザーズ ガイド』の「ワークフロー テンプレートの定義」を参照してください。
タスクの取得
特定のワークフロー テンプレートで定義されたタスクのリストを取得するには、以下の com.bea.wlpi.server.admin.Admin メソッドのいずれかを使用します。
public javautil.List getTasks(
java.lang.String assigneeId,
java.lang.String orgId,
boolean role
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
public javautil.List getTasks(
java.lang.String assigneeId,
java.lang.String orgId,
boolean role,
boolean incompleteonly,
boolean sortAscending
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
getTasks() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。
各メソッドは、com.bea.wlpi.common.TaskInfo オブジェクトのリストを返します。各タスクについての情報にアクセスするには、TaskInfo オブジェクトに記載する TaskInfo オブジェクト メソッドを使用します。 たとえば、次のコードでは、オーガニゼーション ORG1 内のロール ROLE1 (role パラメータが true に設定してあることに注意) のタスクのリストが取得されます。このコード例では、admin は Admin EJB への EJBObject 参照を表します。 getTasks() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。
List taskList = admin.getTasks(“ROLE1”, “ORG1”, true);
タスクの割り当て
タスクに割り当てられているユーザまたはロールを変更する、またはタスクの割り当てを解除するには、それぞれ以下の com.bea.wlpi.server.admin.Admin メソッドを使用します。
public void taskAssign(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String taskId,
java.lang.String assignTo,
boolean bRole,
boolean bLoadBalance
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
public void taskUnassign(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String taskId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
taskAssign() および taskUnassign() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。
タスクが割り当てられる実際の割り当て先は、以下の条件で決定されます。
たとえば、次のコードでは、ユーザ joe にタスクが割り当てられます。このコード例では、admin は Admin EJB への EJBObject 参照を表します。
admin.taskAssign(
task.getTemplateDefinitionId(),
task.getInstanceId(),
task.getTaskId(),
“joe”,
false,
false
);
次のコードでは、同タスクの割り当てが解除されます。
admin.taskUnassign(
task.getTemplateDefinitionId(),
task.getInstanceId(),
task.getTaskId(),
“joe”,
false,
false
);
テンプレート定義、ワークフロー インスタンス、およびタスク ID は、com.bea.wlpi.common.TaskInfo オブジェクト、task と関連するメソッドを使用して取得されます。task オブジェクトは、タスクの取得に記載のメソッドを使用して取得されます。
com.bea.wlpi.common.TaskInfo メソッドの詳細については、TaskInfo オブジェクトまたは、Javadoc の com.bea.wlpi.common.TaskInfo を参照してください。
taskAssign() および taskUnassign() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。
タスク数の取得
特定のユーザに割り当てられているタスクの数を取得するには、次の com.bea.wlpi.server.admin.Admin メソッドを使用します。
public int[] getTaskCounts(
java.lang.String assigneeId,
java.lang.String orgId,
boolean isRole
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
getTaskCounts() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。
このメソッドは、次の表で説明する、5 つの要素から成る配列を返します。
たとえば、次のコードでは、現在のユーザに割り当てられたタスクの数が取得され、配列 taskCounts[ ] にその数が格納されます。このコード例では、admin は Worklist EJB への EJBObject 参照を表します。 配列 taskCounts[ ] の各要素にタスク数が格納されます。たとえば、 taskCounts[TASKCOUNT_TOTAL] は、タスクの総数、taskCounts[TASKCOUNT_PENDING] は、ペンディング中のタスクの総数を示します。 getTaskCounts() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。
int taskCounts[] = admin.getTaskCounts(“ROLE1”, “ORG1”, true);
タスクへの完了または未完了マークの付与
タスクに完了(done)または未完了(undone)としてマークするには、それぞれ以下の com.bea.wlpi.server.admin.Admin メソッドを使用します。
public void taskMarkDone(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String taskId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
public void taskUnmarkDone(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String taskId
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
taskMarkDone() および taskUnmarkDone() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。
taskMarkDone() メソッドは、現在の日付および時間にタスク Completed 値を設定します。さらに、指定されたタスクの Marked Done イベントと関連する、すべてのアクションの連続実行を行います。ただし、taskMarkDone() メソッドは完了マークの付けられたタスクには影響しません。タスクの Marked Done イベントの定義については、『WebLogic Integration Studio ユーザーズ ガイド』の「ワークフローのテンプレートの定義」を参照してください。 taskUnmarkDone() メソッドは Completed 日付を消去します。このメソッドは、指定されたタスクの Activated イベントと関連するアクションの実行にはつながりません。 たとえば、次のコードでは、指定されたタスクに完了マークが付けられ、Completed 値が現在の日付および時間に設定され、指定されたタスクの Marked Done イベントと関連するアクションが実行されます。このコード例では、admin は Admin EJB への EJBObject 参照を表します。 次のコードは、同タスクに未完了マークを付け、Completed 日付を消去します。 テンプレート定義、ワークフロー インスタンス、およびタスク ID は、com.bea.wlpi.common.TaskInfo オブジェクト、task と関連するメソッドを使用して取得されます。task オブジェクトは、タスクの取得に記載のメソッドを使用して取得されます。 com.bea.wlpi.common.TaskInfo メソッドの詳細については、TaskInfo オブジェクト または、Javadoc の com.bea.wlpi.common.TaskInfo を参照してください。 taskMarkDone() および taskMarkUndone() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。
admin.taskMarkDone(
task.getTemplateDefinitionId(),
task.getInstanceId(),
task.getTaskId()
);admin.taskMarkUndone(
task.getTemplateDefinitionId(),
task.getInstanceId(),
task.getTaskId()
);
タスク プロパティの設定
タスク プロパティを設定するには、次の com.bea.wlpi.server.admin.Admin メソッドを使用します。
public void taskSetProperties(
java.lang.String templateDefinitionId,
java.lang.String instanceId,
java.lang.String taskId,
int priority,
boolean doneWithoutDoit,
boolean doitIfDone,
boolean unmarkDone,
boolean modify,
boolean reassign
) throws java.rmi.RemoteException,
com.bea.wlpi.common.WorkflowException
taskSetProperties() メソッドのパラメータを次の表に示します。パラメータには値を指定する必要があります。
たとえば、次のコードは、デフォルトのタスク優先順位を 中(1)に設定し、他のすべてのタスク優先順位を有効化(true に設定)します。このコード例では、admin は Admin EJB への EJBObject 参照を表します。 テンプレート定義、ワークフロー インスタンス、およびタスク ID は、com.bea.wlpi.common.TaskInfo オブジェクト、task と関連するメソッドを使用して取得されます。task オブジェクトは、タスクの取得に記載のメソッドを使用して取得されます。 com.bea.wlpi.common.TaskInfo メソッドの詳細については、TaskInfo オブジェクト または、Javadoc の com.bea.wlpi.common.TaskInfo を参照してください。 taskSetProperties() メソッドの詳細については、Javadoc の com.bea.wlpi.server.admin.Admin を参照してください。
admin.taskSetProperties(
task.getTemplateDefinitionId(),
task.getInstanceId(),
task.getTaskId(),
1,
true,
true,
true,
true,
true
);
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |