Hitachi

uCosminexus Service Coordinator Interactive Workflow BPMN連携機能 使用の手引


11.5.43 リスト型プロセスデータのインデクス取得

指定したリスト型プロセスデータの要素が,リストの何番目の要素かのインデクスを取得します。このAPIを実行すると,BPMN連携ライブラリ Java APIのCIWBPMNLib.getListProcessDataIndexインタフェースが呼び出されます。

メソッドとURL

POST /v1/process-data/list-index

リクエストボディ

項番

名前

指定要否

内容

1

UserDescription

文字列

省略可

ユーザ記述子を指定します。省略した場合はデフォルト値が指定されます。空文字列は指定できません。

2

ID

数値

必須

プロセスデータのインデクスを取得する案件のIDを指定します。

3

ProcessData

オブジェクト

必須

プロセスデータオブジェクトを指定します。次の2つの要素(KeyおよびValue)から構成されています。

4

Key

文字列

必須

インデクスを取得するリスト型プロセスデータの全要素を示すキー名を指定します。空文字列は指定できません。

5

Value

文字列

省略可

インデクスを取得するリスト型プロセスデータの値を指定します。省略した場合,値がnullのプロセスデータを検索します。空文字列は指定できません。

リクエストボディの構造を次に示します。

項番

名前

出現回数

1

Parameter

1

2

UserDescription

0または1

3

ID

1

4

ProcessData

1

5

 

Key

1

6

Value

0または1

リクエスト例

リクエストURL

POST http://restserver/csciwws/v1/process-data/list-index

リクエストボディ(XMLの場合)

<?xml version="1.0" encoding="UTF-8" ?>
<Parameter>
  <UserDescription>csciwuser</UserDescription>
  <ID>12100</ID>
  <ProcessData>
    <Key>$SSTATE{}</Key>
    <Value>ACTIVE</Value>
  </ProcessData>
</Parameter>

リクエストボディ(JOINの場合)

{
  "UserDescription" : "csciwuser",
  "ID" : "12100",
  "ProcessData" : {
    "Key" : "$SSTATE{}",
    "Value" : "ACTIVE"
  }
}

レスポンス

リスト型プロセスデータのインデクスを返します。

項番

名前

内容

1

Index

文字列

リスト型プロセスデータのインデクスを返します。案件が見つからなかった場合は,ステータスコード404を返します。プロセスデータが見つからなかった場合は,ステータスコード200を返し,Indexの値は-1になります。

レスポンスの構造を次に示します。

項番

名前

出現回数

1

Resources

1

2

Index

1

ステータスコード

項番

ステータスコード

内容

1

200

成功

2

400

リクエストパラメタの不正

3

404

データが見つからなかった

4

500

内部処理エラー

レスポンス例

レスポンス(XMLの場合)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Resources>
  <Index>3</Index>
</Resources>

レスポンス(JSONの場合)

{
  "Index" : "3"
}