11.5.25　作業者を変更して着手 : uCosminexus Service Coordinator Interactive Workflow BPMN連携機能　使用の手引

指定した作業を，作業者を変更してから着手します。この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"
}

11.5.25 作業者を変更して着手

11.5.25　作業者を変更して着手