11.5.40 イベント(メッセージ)の送信処理
メッセージイベントの送信処理をします。このAPIを実行すると,BPMN連携ライブラリのJava APIのCIWBPMNLib.sendMessageインタフェースが呼び出されます。
メソッドとURL
POST /v1/event/send-message/<案件ID>
<案件ID>:イベント(メッセージ)の送信処理をする案件ID(必須)
リクエストボディ
項番 |
名前 |
型 |
指定要否 |
内容 |
|---|---|---|---|---|
1 |
UserDescription |
文字列 |
省略可 |
ユーザ記述子を指定します。省略した場合はデフォルト値が指定されます。空文字列は指定できません。 |
2 |
ProcessDataList |
配列 |
省略可 |
プロセスデータ一覧を指定します。省略した場合はプロセスデータを更新しません。 |
3 |
ProcessData |
オブジェクト |
必須 |
プロセスデータオブジェクトを指定します。次の2つの要素(KeyおよびValue)から構成されています。 |
4 |
Key |
文字列 |
必須 |
プロセスデータキー名を指定します。空文字列は指定できません。 |
5 |
Value |
文字列 |
省略可 |
プロセスデータ値を指定します。省略した場合,Keyに対応する値は未設定となります。空文字列は指定できません。 |
6 |
MessageRef |
文字列 |
必須 |
メッセージを受信するイベントのMessageRefを指定します。空文字列は指定できません。 |
リクエストボディの構造を次に示します。
|
項番 |
名前 |
出現回数 |
|||
|---|---|---|---|---|---|
|
1 |
Parameter |
1 |
|||
|
2 |
UserDescription |
0または1 |
|||
|
3 |
ProcessDataList |
0または1 |
|||
|
4 |
ProcessData |
1以上 |
|||
|
5 |
Key |
1 |
|||
|
6 |
Value |
0または1 |
|||
|
7 |
MessageRef |
1 |
|||
リクエスト例
リクエストURL
POST http://restserver/csciwws/v1/event/send-message/5001
リクエストボディ(XMLの場合)
<?xml version="1.0" encoding="UTF-8" ?>
<Parameter>
<UserDescription>csciwuser</UserDescription>
<ProcessDataList>
<ProcessData>
<Key>$Sdata1</Key>
<Value>stringvalue1</Value>
</ProcessData>
<ProcessData>
<Key>$Ndata2</Key>
<Value>100</Value>
</ProcessData>
</ProcessDataList>
<MessageRef>message1</MessageRef>
</Parameter>
リクエストボディ(JSONの場合)
{
"UserDescription" : "csciwuser",
"ProcessDataList" : {
"ProcessData" : [
{
"Key" : "$Sdata1",
"Value" : "stringvalue1"
},
{
"Key" : "$Ndata2",
"Value" : "100"
}
]
},
"MessageRef" : "message1"
}
レスポンス
レスポンスボディは空になります。
ステータスコード
|
項番 |
ステータスコード |
内容 |
|---|---|---|
|
1 |
204 |
成功 |
|
2 |
400 |
リクエストパラメタの不正 |
|
3 |
404 |
データが見つからなかった |
|
4 |
500 |
内部処理エラー |
レスポンス例
レスポンスボディは空になります。