タスクに対するアクションの実行
put
/ic/api/process/v1/tasks/{id}
指定のタスク番号のペイロードに基づいてアクションを実行します。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
- id(required): string
タスク番号
ペイロード
ネストされたスキーマ : action
型:
ソースを表示
object- abortType: string
- activityChanges: array activityChanges
- assignees: array assignees
- comments: string
- correlationKeyChanges: array correlationKeyChanges
- dataObjectChanges: array dataObjectChanges
- faultActionType: string
- flowId: integer(int64)
- id: string
- instanceAttributeChanges: array instanceAttributeChanges
- processes: array processes
- type: string
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ルート・スキーマ : タスク
型:
object400レスポンス
タスク番号が無効。アクションは実行されません。
401レスポンス
未認可
404レスポンス
タスクが見つからない
409レスポンス
競合
500レスポンス
内部サーバー・エラー
例
次の例では、RESTリソースに対するPUTリクエストを使用することによって、タスクを別のユーザーに再割当てする方法を示しています。
リクエストの送信
https://example.com/ic/api/process/v1/tasks/<taskId>
説明
-
example.comは、Oracle Integrationが実行されているホストです。 -
<taskId>は、アクションを実行するタスクのIDです。
現在のユーザーのタスクIDを取得するには、「タスク・リストの取得」を参照してください。
ノート: 別のユーザーへの再割当て、別のユーザーへの委任または別のユーザーからの詳細情報のリクエストを行う場合は、リクエストにIdentities要素を追加する必要があります。 タスクをclaim(acquire)する場合は、ペイロードにIdentities属性を指定しないでください。 現在のユーザーのみがタスクを申告できます。
リクエスト本文の例
例1:
次の例は、タスクIDを再割り当てするときのリクエスト本文を示しています:
{
"identities":
[{
"id":"<userId>","type":"user"
}],
"action":
{
"id":"REASSIGN", "type":"SYSTEM"
}
}<userId>はユーザーIDです。
例2:
次の例では、コメント付きのタスクIDをエスカレートまたは承認する場合のリクエスト本文を示しています。
{
"identities":[{"id":"jstein","type":"user" }],
"action":{"id":"ESCALATE","type":"SYSTEM"},
"comment":{"commentStr":"Some comment","commentScope":"BPM"}
}例3:
次の例では、タスクを承認する際のリクエスト本体を示します。
{
"action":{"id":"APPROVE"}
}
レスポンス・ヘッダーの例
Status Code: 200 OK Date: Wed, 27 Apr 2016 00:53:16 GMT Content-Type: application/json
レスポンス本文の例
{
"totalResult": false,
"hasMore": false,
"items":
[
{
"href": "http://example.com/ic/api/process/v1/tasks/200002",
"length": 0,
"rel": "self",
"title": "Approver to review request and approve, reject, or request additional information",
"hasSubTasksFlag": false,
"isDocsEnabledFlag": false,
"isConversationEnabledFlag": false,
"hasSubTasks": false
}
],
"user":
{
"href": "http://example.com/ic/api/process/v1/identities/user/jsmith",
"length": 0,
"rel": "user"
}
}