タスクの作成
タスクの作成
タスクを作成するには、タスクのaction
と、タスクの追加先となるファイルを表すitem
を指定してPOST /tasks
APIを呼び出す必要があります。
curl -i -X POST "https://api.box.com/2.0/tasks" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"item": {
"id": "11446498",
"type": "file"
},
"action": "review"
}'
タスクのアクション
Boxは現在、action
値によって定義される、review
とcomplete
という2種類のタスクをサポートしています。
タスクのタイプによって、タスクがなりうる解決状態と、ウェブアプリおよびモバイルアプリでユーザーに表示されるインターフェースが決まります。
タスクのアクション | 考えられる解決状態 |
---|---|
review | incomplete , approved , rejected |
complete | incomplete , complete |
review
タスクはincomplete
状態で開始され、incomplete
、approved
、またはrejected
としてマークすることができます。ユーザーインターフェースには、テキストボックスのほか、タスクを承認または拒否する1組のボタンが表示されます。
complete
タスクはincomplete
状態で開始され、incomplete
またはcompleted
としてマークすることができます。このタスクが完了としてマークされると、タスクの状態をそれ以上変更することはできなくなります。ユーザーインターフェースには、テキストボックスのほか、タスクを完了としてマークするためのボタンが表示されます。
完了のルール
ファイルに関連するタスクは、そのファイルの複数のコラボレータに割り当てることができます。また、タスクのcompletion_rule
を使用すると、タスクを完了する必要があるのはタスクが割り当てられているすべてのユーザー (all_assignees
) か1人の担当者のみ (any_assignee
) かを定義できます。