11.5.25 作業者を変更して着手
指定した作業を,作業者を変更してから着手します。このAPIを実行すると,BPMN連携ライブラリ Java APIのCIWBPMNLib.reassignAndPerformWIインタフェースが呼び出されます。作業者を変更して作業が着手済みだった場合,リクエストは成功します(何もしないでステータスコード200を返します)。詳細については,「5.3 Java API利用時の注意事項」の「べき等性について」の説明を参照してください。
メソッドとURL
PUT /v1/work-item/<案件ID>/<作業ID>/reassign-and-perform
<案件ID>:作業者を変更して着手する作業の案件ID(必須)
<作業ID>:作業者を変更して着手する作業のID(必須)
リクエストボディ
項番 |
名前 |
型 |
指定要否 |
内容 |
---|---|---|---|---|
1 |
UserDescription |
文字列 |
省略可 |
ユーザ記述子を指定します。省略した場合はデフォルト値が指定されます。空文字列は指定できません。 |
2 |
Source |
文字列 |
省略可 |
変更する前の作業者IDを指定します。変更する前の作業者IDが未設定の場合は省略できます。空文字列は指定できません。 |
3 |
Target |
文字列 |
省略可 |
新しい作業者IDを指定します。省略した場合,作業者IDは設定されません。空文字列は指定できません。 |
4 |
ProcessDataList |
配列 |
省略可 |
プロセスデータ一覧を指定します。省略した場合はプロセスデータが更新されません。 |
5 |
ProcessData |
オブジェクト |
必須 |
プロセスデータオブジェクトを指定します。次の2つの要素(KeyおよびValue)から構成されています。 |
6 |
Key |
文字列 |
必須 |
プロセスデータキー名を指定します。空文字列は指定できません。 |
7 |
Value |
文字列 |
省略可 |
プロセスデータ値を指定します。省略した場合,Keyに対応する値は設定されません。空文字列は指定できません。 |
リクエストボディの構造を次に示します。UserDescription,Source,TargetおよびProcessDataListを省略する場合は,リクエストボディを省略できます。リクエストボディを省略するときは,HTTPヘッダのContent-Typeを指定しないでください。
項番 |
名前 |
出現回数 |
|||
---|---|---|---|---|---|
1 |
Parameter |
1 |
|||
2 |
UserDescription |
0または1 |
|||
3 |
Source |
0または1 |
|||
4 |
Target |
0または1 |
|||
5 |
ProcessDataList |
0または1 |
|||
6 |
ProcessData |
1以上 |
|||
7 |
Key |
1 |
|||
8 |
Value |
0または1 |
リクエスト例
リクエストURL
PUT http://restserver/csciwws/v1/work-item/5004/10005/reassign-and-perform
リクエストボディ(XMLの場合)
<?xml version="1.0" encoding="UTF-8" ?> <Parameter> <UserDescription>csciwuser</UserDescription> <Source>guest</Source> <Target>planner</Target> <ProcessDataList> <ProcessData> <Key>$Sdata1</Key> <Value>stringvalue1</Value> </ProcessData> <ProcessData> <Key>$Ndata2</Key> <Value>100</Value> </ProcessData> </ProcessDataList> </Parameter>
リクエストボディ(JSONの場合)
{ "UserDescription" : "csciwuser", "Source" : "guest", "Target" : "planner", "ProcessDataList" : { "ProcessData" : [ { "Key" : "$Sdata1", "Value" : "stringvalue1" }, { "Key" : "$Ndata2", "Value" : "100" } ] } }
レスポンス
着手した作業を返します。作業のプロパティを次に示します。
項番 |
名前 |
型 |
内容 |
---|---|---|---|
1 |
ActivityInstanceID |
数値 |
作業が所属する業務ステップのID |
2 |
ClosedDate |
日付 |
作業の終了日時 |
3 |
CreationDate |
日付 |
作業の発生日時 |
4 |
Deadline |
日付 |
作業の処理期限の絶対日時 |
5 |
ID |
数値 |
作業のID |
6 |
Name |
文字列 |
作業の名称(作業キー) |
7 |
Participant |
文字列 |
作業の作業者ID |
8 |
Priority |
数値 |
作業の優先度 |
9 |
ProcessDefinitionID |
数値 |
作業が所属するビジネスプロセス定義のID |
10 |
ProcessInstanceID |
数値 |
作業が所属する案件のID |
11 |
ProcessInstanceName |
文字列 |
作業の案件名(案件キー) |
12 |
StartDate |
日付 |
作業の開始日時 |
13 |
StateCode |
文字列 |
作業の状態 |
14 |
WorkDefinitionID |
数値 |
作業定義のID |
15 |
WorkDefinitionName |
文字列 |
作業定義の名称 |
16 |
WorkTypeCode |
文字列 |
作業の種類 |
レスポンスの構造を次に示します。
項番 |
名前 |
出現回数 |
|
---|---|---|---|
1 |
WorkItem |
1 |
|
2 |
ActivityInstanceID |
1 |
|
3 |
ClosedDate |
1 |
|
4 |
CreationDate |
1 |
|
5 |
Deadline |
1 |
|
6 |
ID |
1 |
|
7 |
Name |
1 |
|
8 |
Participant |
1 |
|
9 |
Priority |
1 |
|
10 |
ProcessDefinitionID |
1 |
|
11 |
ProcessInstanceID |
1 |
|
12 |
ProcessInstanceName |
1 |
|
13 |
StartDate |
1 |
|
14 |
StateCode |
1 |
|
15 |
WorkDefinitionID |
1 |
|
16 |
WorkDefinitionName |
1 |
|
17 |
WorkTypeCode |
1 |
ステータスコード
項番 |
ステータスコード |
内容 |
---|---|---|
1 |
200 |
成功 |
2 |
400 |
リクエストパラメタの不正 |
3 |
404 |
データが見つからなかった |
4 |
500 |
内部処理エラー |
レスポンス例
レスポンス(XMLの場合)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <WorkItem> <ActivityInstanceID>10005</ActivityInstanceID> <ClosedDate>2016-12-09T15:58:52+09:00</ClosedDate> <CreationDate>2016-12-09T15:54:55+09:00</CreationDate> <Deadline></Deadline> <ID>10005</ID> <Name></Name> <Participant>planner</Participant> <Priority>0</Priority> <ProcessDefinitionID>3001</ProcessDefinitionID> <ProcessInstanceID>5004</ProcessInstanceID> <ProcessInstanceName>案件20160609103256259</ProcessInstanceName> <StartDate>2016-12-09T15:58:52+09:00</StartDate> <StateCode>f</StateCode> <WorkDefinitionID>3001</WorkDefinitionID> <WorkDefinitionName>QuotationHandling_UTask1</WorkDefinitionName> <WorkTypeCode>0</WorkTypeCode> </WorkItem>
レスポンス(JSONの場合)
{ "ActivityInstanceID" : "10005", "ClosedDate" : "2016-12-09T15:58:52+09:00", "CreationDate" : "2016-12-09T15:54:55+09:00", "Deadline" : "", "ID" : "10005", "Name" : "", "Participant" : "planner", "Priority" : "0", "ProcessDefinitionID" : "3001", "ProcessInstanceID" : "5004", "ProcessInstanceName" : "案件20160609103256259", "StartDate" : "2016-12-09T15:58:52+09:00", "StateCode" : "f", "WorkDefinitionID" : "3001", "WorkDefinitionName" : "QuotationHandling_UTask1", "WorkTypeCode" : "0" }