タスクの取得
get
/ic/api/process/v1/tasks/{id}
タスク番号によってタスクを取得します。 特定のインスタンスAPIでドキュメント・ストアを有効にして添付をフェッチおよびアップロードすると、「ドキュメント・ストアが有効な添付は使用できません」というエラー・メッセージが返されます。 特定のインスタンスAPIでフォルダをフェッチするドキュメント・ストアが有効になっていない場合、「ドキュメント・ストアが構成されていません」というエラー・メッセージが返されます。 会話の詳細をフェッチする特定のインスタンスAPIに対して会話が有効になっていない場合、「会話は有効ではありません」というエラー・メッセージが返されます。
リクエスト
パス・パラメータ
- id(required): string
タスク番号
問合せパラメータ
- expand(必須): string
展開する(詳細)すべてのフィールドの値 - All、comments、attachments、history、payload。 指定しない場合は、各フィールドへのリンクが返されます。デフォルト値:
- metadataFlag(required): boolean
メタデータ - trueまたはfalseデフォルト値:
false
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ルート・スキーマ : タスク
型:
object400レスポンス
不正リクエスト
401レスポンス
未認可
404レスポンス
指定されたIDのタスクが見つからない。
500レスポンス
内部サーバー・エラー
例
次の例では、RESTリソースに対してGETリクエストを使用することによってタスクを取得する方法を示しています。
webフォームを含むタスクの場合、webform (/webforms/{id})のメタデータへのリンクを含むformMetadata属性がレスポンスとして設定されます。 タスクにwebフォームがある場合は、/webforms/{id} エンドポイントを使用するようにしてください。
リクエストの送信
https://example.com/ic/api/process/<version>/tasks/{id}説明
-
example.comは、Oracle Integrationが実行されているホストです。 -
<version>はREST APIバージョンです。
-
{id}は、「タスク・リストの取得」を使用して取得するタスクIDです。
レスポンス本文の例
{
"length": 0,
"title": "NewPCSFormsSubmit",
"actionList”:””
"assignedDate": "2017-01-25T09:37:07.000Z",
"number": 200091,
"priority": 3,
"createdDate": "2017-01-25T09:37:07.000Z",
"state": "ASSIGNED",
"ownerRole": "NewFormsRestApp.Process Owner",
"processName": "NewPCSForms",
...
...
"hasSubTasksFlag": false,
"updatedDate": "2017-01-25T09:37:23.000Z",
"formMetadata": "http://example.com/ic/api/process/<version>/
webforms/default~NewFormsRestApp!1.0~NewPCSForms~d5fb3e55-682b-4dd7-8836-3f670d1c9b3a~c162fd27-99d7-4f81-944d-33ae26c0f089",
"isDocsEnabledFlag": false,"isDocsEnabledFlag": false,
"isConversationEnabledFlag": false,
"routingType": "SINGLE",
"originalAssignees": {
"totalResult": true,
"count": 1,
"hasMore": false,
"items": [
{
"levels": 0,
"id": "bpm:getPerformer()",
"type": "application_role"
}
]
},
"processDefId": "default~NewFormsRestApp!1.0*~NewPCSForms",
"processId": "93",
"processInstanceDetail": {
"href": "http://example.com/ic/api/process/<version>/processes/93",
"length": 0,
"rel": "processInstanceDetail"
}
}