タスク・リストの取得
get
/ic/api/process/v1/tasks
現在のユーザーのタスク・リストを取得します。
リクエスト
問合せパラメータ
- assignment: string
タスクの譲受人 - MY、GROUP、MY_AND_GROUP (デフォルト)、MY_AND_GROUP_ALL、REPORTEES、OWNER、REVIEWER、PREVIOUS、ALL、ADMIN MY - コンテキスト・ユーザーに排他的に割り当てられたタスク。 これは、ワークスペースの自分のタスク/自分と同じです。 GROUP - 非排他的にコンテキスト・ユーザーに割り当てられたタスク。 メンバーであるグループに割り当てられているタスクを表示します。 MY_AND_GROUP - コンテキスト・ユーザーに割り当てられたすべてのタスク(排他的または非排他的)。 これは、ワークスペースの自分のタスク/自分とグループと同じです。 自分が属するグループに含まれる任意のユーザーに割り当てられたタスクを表示します。自分が属するグループの他のユーザーによって取得されたタスクはフェッチしません。 MY_AND_GROUP_ALL - コンテキスト・ユーザーに割り当てられたすべてのタスク(排他的、またはすべてのグループ・ベースのタスク)。 これは、ワークスペースの'自分のタスク/自分と自分のグループのすべて'と同じです。 自分が属するグループの、自分を含む誰かに割り当てられたタスクを表示します。 これにより、属しているグループ内の他のユーザーによって取得されたタスクもフェッチされます。 REPORTEES - 自分にレポートするユーザーに割り当てられているタスクを表示します。OWNER - 自分がタスク所有者であるタスクを表示します。 これは、ワークスペースの自分が管理フィルタと同じです。 レビュー担当者 -自分がレビュー担当者であるタスクが表示されます。 これは、ワークスペースの自分でレビュー済フィルタと同じです。 PREVIOUS - 以前に更新されたタスクが表示されます。 これは、ワークスペースで自分の作業フィルタと同じです。 CREATOR - コンテキスト・ユーザーが作成者であるタスク。 これは、ワークスペースで自分が開始フィルタと同じです。 ALL - すべてのタスク(管理者のみ) ADMIN - フィルタリングなし(管理者のみ);割当てまたは作成者に関係なくすべてのタスクを表示します。 DEFAULT - 現在のユーザーがフィルタを導出したユーザーに基づいて、ADMIN、OWNERまたはMY_AND_GROUP_ALLのいずれかにすることができますデフォルト値:
MY_AND_GROUP - dueDateFrom: string
期日範囲の開始をISO-8601形式YYYY-MM-DDTHH:MM:SS[.sss]Zで指定
- dueDateTo: string
ISO-8601形式YYYY-MM-DDTHH:MM:SS[.sss]Zの期限終了日
- fields: array[string]
コレクション形式:
multi選択されたタスク属性のみを表示します - fromuser: array[string]
コレクション形式:
multiプロセス内の前のタスク割当て先 - identificationKey: string
タスクのidentificationKey
- includeOnTrackFlag: boolean
ON Trackタスクを含めます。このフラグは、dueDateFrom問合せパラメータと組み合せて使用されます。includeOnTrackFlagがtrueの場合は、dueDateFromを今日から2日に設定します。デフォルト値:
false - instanceId: array[string]
コレクション形式:
multi指定されたprocess-instance-id値のタスクを表示 - keyword: string
タスク・タイトルのキーワード
- limit: integer(int32)
ページ当たりの最大アイテム数、デフォルト25デフォルト値:
25 - metadataFlag: boolean
metadataFlag - trueまたはfalse。metadataFlagがtrueの場合、タスク詳細URLが移入されます。デフォルト値:
false - offset: integer(int32)
リスト項目のページにある最初の項目の索引デフォルト値:
0 - orderBy: string
結果を順序付けるフィールド orderBy=fieldname:asc/descの場合、デフォルトは昇順の昇順です。
- pattern: string
パターン値が'ToDo'に設定されると、ToDoタスクのみが返されます。
- priority: array[string]
コレクション形式:
multiタスク優先度で、1 (最高)から5 (最低)またはAny (デフォルト)を指定します - process: array[string]
コレクション形式:
multi指定したプロセス名のタスクのみを含めます - processDefId: array[string]
コレクション形式:
multi指定されたプロセス定義IDのタスクを表示 - showActionFlag: boolean
アクションの表示 - trueまたはfalse
- showPermissionFlag: boolean
権限の表示 - trueまたはfalse
- since: string
返されるアイテムは、ISO-8601形式YYYY-MM-DDTHH:MM:SS[.sss]Zで指定された時間より後で作成する必要があります
- status: array[string]
コレクション形式:
multiタスクのステータス デフォルトはASSIGNEDです。 有効な状態: ASSIGNED, COMPLETED, SUSPENDED, WITHDRAWN, EXPIRED, ERRORED, ALERTED, INFO_REQUESTED. タスク・ステータスCOMPLETEDは、次の割当で使用した場合に有効です - ADMIN, ALL, PREVIOUS-
デフォルト値:
ASSIGNED許容値:[ "ASSIGNED", "COMPLETED", "SUSPENDED", "WITHDRAWN", "EXPIRED", "ERRORED", "ALERTED", "INFO_REQUESTED" ]
-
- taskNumber: array[string]
コレクション形式:
multi指定したタスク番号のタスクを表示 - totalResults: boolean
合計結果 - trueまたはfalseデフォルト値:
true - until: string
返品アイテムは、ISO-8601形式YYYY-MM-DDTHH:MM:SS[.sss]Zで指定された時間より前に作成する必要があります
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ネストされたスキーマ : task
型:
object206レスポンス
部分的内容
400レスポンス
不正リクエスト
401レスポンス
未認可
404レスポンス
タスク・リストが見つからない
500レスポンス
内部サーバー・エラー