CaseApp の要求

CaseApp v3 API を介してアドホック ケース タスクをトリガーするための API エンドポイント。

アドホック ケース タスクをトリガーする

実行中の Maestro Case インスタンスで、ケース プラン名で識別される、手動でトリガーする (アドホック) タスクを 1 つトリガーします。

POST

{AutomationCloudURL}/{organizationName}/{tenantName}/pims_/api/v3/caseapp/instances/{instanceId}/tasks/trigger

要求ヘッダー

キー	値 (Value)
認可	Bearer
X-UIPATH-FolderKey	ケース インスタンスのフォルダー キーです

要求本文

フィールド	入力	Required	説明
taskName	string	はい	トリガーするアドホック タスクの名前です。ケース プランで解決される名前とまったく同じです。一致では大文字と小文字が区別されます。
タスク入力	object	いいえ	自由形式の JSON オブジェクトが、入れ子になったペイロードとしてトリガーされたタスクに逐語的に転送されます。たとえば、承認の参照や意思決定データなどです。このペイロードは解釈もスキーマ検証も行わず、タスクの宣言された入力にバインドされません。

{
  "taskName": "string",
  "taskInput": {}
}

応答コード

200成功(空の本体)

エラー応答

コード	意味
400	要求本文が見つからないか、無効です。
401	呼び出し元は認証されていません。
403	呼び出し元には、このタスクに必要なアクセス許可がありません。
404	ケース インスタンスが存在しないか、同じ名前のアドホック タスクがケース プランに存在しません。エントリ条件が「アドホック」のタスクのみが対象となります。それ以外の名前では 404 が返されます。
500	予期しないサーバー エラーが発生していました。

権限

要求されたタスクを所有するステージの範囲で承認された Cases.RunAdhocTasks 権限が必要です。

ケース インスタンスを閉じる

実行中の Maestro Case インスタンスを閉じます。

POST

{AutomationCloudURL}/{organizationName}/{tenantName}/pims_/api/v3/caseapp/instances/{instanceId}/close

要求ヘッダー

キー	値 (Value)
認可	Bearer
X-UIPATH-FolderKey	ケース インスタンスのフォルダー キーです

応答コード

コード	意味
200	インスタンスは Cancelingに移行します。作業者がシフトを完了して、非同期に Cancelled します。すでにターミナルにあるインスタンスは、現在のステータスを変更せずに返します。
400	インスタンスはすでに Completed に達しているため、キャンセルできません。
401	呼び出し元は認証されていません。
403	呼び出し元には、このインスタンスに必要な権限がありません。
404	インスタンス ID がケース インスタンスに解決されません。

権限

Cases.Close ペルソナの付与が必要です。