タスクの添付ファイルの追加
post
/ic/api/process/v1/tasks/{id}/attachments
タスクに添付ファイルを追加します。
ノート:
プロセス・アプリケーションがドキュメントまたは添付ファイルを使用するかどうかは、アプリケーションの構成によって異なります。
- Oracle Content and Experience(documents)が有効な場合、アプリケーションはドキュメントのみを使用でき、添付ファイルのAPI操作は適用されません。
- Oracle Content and Experience(documents)が有効でない場合、アプリケーションは添付ファイルのみを使用でき、文書のAPI操作は適用されません。
Oracle Content and Experience(documents)がプロセス・アプリケーションで有効かどうかを識別するには、API /ic/api/process/v1/processes/{processId} を使用してプロセス・インスタンスの詳細を取得します。 Oracle Content and Experience(documents)は、パラメータisDoCSEnabled=trueの場合に有効になります。
リクエスト
サポートされているメディア・タイプ
- multipart/mixed
パス・パラメータ
トップに戻る
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
添付ファイルは正常に追加された
ルート・スキーマ: Collection
型:
object400レスポンス
不正リクエスト
401レスポンス
未認可
404レスポンス
タスクが見つからない
409レスポンス
失効したタスク・オブジェクトが見つかった
500レスポンス
内部サーバー・エラー
例
次の例では、RESTリソースに対するPOSTリクエストを発行することによって添付ファイルを追加する方法を示しています。
リクエストの送信
curl -F "part1=@request.json;type=application/json" -F "part2=@serviceRequest.txt;type=text/plain" -X POST http://example.com/ic/api/process/v1/tasks/20002/attachments -H "Content-Type:multipart/mixed" -H 'Authorization: Bearer access_token'説明
-
example.comは、Oracle Integrationが実行されているホストです。 -
request.jsonは、添付ファイルに関するデータを含むファイルです。request.jsonファイルの例を次に示します:{ "attachmentName" : "serviceRequest.txt", "mimeType" :"text/plain" }attachmentNameは添付ファイルの名前で、mimeTypeはそのMIMEタイプです。
レスポンス本文の例
{
"levels":0,
"links":[
{
"href":"http://example.com/ic/api/process/v1/tasks/200002",
"length":0,
"rel":"parent"
},
{
"href":"http://example.com/ic/api/process/v1/tasks/200002/attachments",
"length":0,
"rel":"self"
},
{
"href":"http://example.com/ic/api/process/v1/tasks/200002/attachments",
"length":0,
"rel":"canonical"
}
],
"attachment":[
{
"levels":0,
"title":"serviceRequest.txt",
"mimeType":"text/plain",
"attachmentScope":"TASK",
"updatedBy":"jsmith",
"userId":"jsmith",
"updatedDate":"2016-08-25T08:53:07.000Z",
"uri"{ "href":"http://example.com/ic/api/process/v1/tasks/200002/attachments/serviceRequest.txt/stream",
"length":0,
"rel":"stream"
}
}
]
}