タスクの CSV インポート
タスク Markdown で表示
POST/api/project/{projectId}/task/import-csv
CSV からプロジェクトにタスクを取り込み、取り込んだ件数を返します。
multipart/form-data で、file という名前のパートに CSV を入れて送ります (10 MB・10,000 行まで、UTF-8。BOM があってもかまいません)。
1 行目は見出しとして読み飛ばします。各行は次の 14 列をこの順に並べます。CSV エクスポートと同じ並びなので、書き出したファイルを直して取り込めます。
id, name, description, responsibleUser, ballHoldingUser, startDate, dueDate, status, milestone, parent, tags, planned, actual, sortOrder
・id: このプロジェクトのタスクの ID なら、そのタスクを更新します。空か、それ以外の値なら新しく作ります (その値は同じファイルの parent から参照できます)。
・name は必須です。description は Markdown です。
・responsibleUser・ballHoldingUser: ユーザー名か表示名。見つからない名前は無視します。
・startDate・dueDate: YYYY-MM-DD。
・status・milestone: このプロジェクトのステータス名・マイルストーン名。見つからない名前は空になります。
・parent: 親タスクの ID か、同じファイルの id 列の値。空なら最上位になります。
・tags: カンマ区切りのタグ名。無いタグは作ります。
・planned・actual・sortOrder: 数値 (予定・実績・並び順)。
更新する行では、空のセルはその項目を空にします。
パラメーター
projectIdintegerpath必須- プロジェクトの ID です。
リクエストボディ
filefile必須- 取り込む CSV ファイル。
レスポンス
200Import result (count)400Invalid CSV, column count mismatch, row limit exceeded, or task limit exceeded401Authentication is required403Not a project member404Project not found