IM-BPM for Accel Platform プログラミングガイド 第8版 2020-12-01

4.2. タスク

プロセス定義の中での最小単位の業務・アクションを表します。

../../../_images/task_1.png
図:タスク(ユーザタスク)

コラム

タスクの詳細は「IM-BPM 仕様書」 - 「タスク」を参照してください。

4.2.1. タスクを操作する

タスクの操作について以下を解説します。
  • タスクを完了させる。
  • タスクの担当者を振り分ける。
  • タスクの担当者をはずす。

4.2.1.1. タスクを完了させる

タスクをタスクIDを指定して完了させます。

4.2.1.1.1. REST-API

メソッド POST
URI %ベースURL%/api/bpm/runtime/tasks/{taskId}
BODY {‘action’ : ‘complete’, ‘variables’ : [{‘name’ : ‘%変数名%’, ‘type’ : ‘%変数タイプ%’, ‘variableScope’ : ‘%変数スコープ%’, ‘value’ : ‘%値%’}, ...]}

4.2.1.1.2. JavaEE開発モデル

TaskService taskService = ProcessEngineFactory.getInstance().getProcessEngine().getTaskService();

taskService.complete("%タスクID%");

// 変数を設定する場合
taskService.complete("%タスクID%", %変数Map%);

4.2.1.1.3. スクリプト開発モデル

var taskService = new bpm.TaskService();

taskService.complete("%タスクID%");

// プロセスの変数を設定する場合
var variables = {
   "var1": "string",
   "var2": 123,
   "var3": new Date(),
   "var4": true
};
taskService.complete("%タスクID%", variables);

// タスクローカルの変数を設定する場合
taskService.complete("%タスクID%", variables, true);

4.2.1.2. タスクの担当者を振り分ける

タスクにタスクIDを指定して担当者を振り分けます。

4.2.1.2.1. REST-API

メソッド POST
URI %ベースURL%/api/bpm/runtime/tasks/{taskId}
BODY {‘action’ : ‘claim’, ‘assignee’ : ‘%担当者ID%’}

4.2.1.2.2. JavaEE開発モデル

TaskService taskService = ProcessEngineFactory.getInstance().getProcessEngine().getTaskService();

taskService.claim("%タスクID%", "%担当者ID%");

4.2.1.2.3. スクリプト開発モデル

var taskService = new bpm.TaskService();

taskService.claim("%タスクID%", "%担当者ID%");

4.2.1.3. タスクの担当者を外す

タスクからタスクIDを指定して担当者を外します。

4.2.1.3.1. REST-API

メソッド POST
URI %ベースURL%/api/bpm/runtime/tasks-unclaim/{taskId}
BODY {}

4.2.1.3.2. JavaEE開発モデル

TaskService taskService = ProcessEngineFactory.getInstance().getProcessEngine().getTaskService();

taskService.unclaim("%タスクID%");

4.2.1.3.3. スクリプト開発モデル

var taskService = new bpm.TaskService();

taskService.unclaim("%タスクID%");