CSV のフォーマット

ヘッダー行が必須で、文字コードは UTF-8。列の順序は問わず、列名で識別します。表にない列は無視されます。

列名	必須	形式	Freelogue 上の扱い
`Start date`	✓	`YYYY-MM-DD`	開始日（JST）
`Start time`	✓	`HH:MM`（秒付きの `HH:MM:SS` も可。秒もそのまま保存）	開始時刻
`End date`	✓	`YYYY-MM-DD`	終了日（日跨ぎ可）
`End time`	✓	`HH:MM`（同上、秒も保存）	終了時刻
`Client`	—	文字列	取引先
`Project`	✓	文字列	案件
`Task`	—	文字列	タスク
`Note`	—	文字列	メモ

サンプル:

Start date,Start time,End date,End time,Client,Project,Task,Note
2026-04-01,09:30,2026-04-01,12:00,株式会社サンプル,LP制作,デザイン,
2026-04-01,13:00,2026-04-01,17:00,株式会社サンプル,LP制作,コーディング,レビュー対応
2026-04-01,23:00,2026-04-02,02:00,株式会社別,深夜対応,本番デプロイ,

最後の行は日付を跨ぐ作業の例です。 Start date と End date を別日にすれば 24 時間を超えて続いた作業も 1 行で登録できます。

3 ステップで取り込み

1. ファイル選択

CSV を選ぶと、サーバー側でパースして有効行数 / エラー行数を返します。

行検証で除外される主なパターン:

Start date / End date が YYYY-MM-DD の形式でない、または実在しない月日
Start time / End time が HH:MM または HH:MM:SS でない
終了日時が開始日時より前（完全に同一は許容、 duration 0 として登録）
Project が空欄
いずれかのセルが 200 字を超える

エラー行は「除外して有効行だけ進む」または「やり直す」のいずれかを選びます。

2. マッピング

CSV に登場した取引先・案件・タスクのユニーク一覧が並びます。それぞれに対して:

既存から選択: Freelogue 上の取引先・案件・タスクに紐づける
新規作成: 取り込み時に新しく作る
タスクのみ タスク無し を選んで案件直下に紐づけることも可能

自動デフォルト:

取引先: 名前完全一致なら既存、それ以外は「新規作成」
案件: 取引先名 + 案件名 が完全一致したら既存。一致がなくても、案件名だけで完全一致する既存案件がちょうど 1 件あればその案件を自動選択。複数候補があるときは「新規作成」のままにし、ユーザーに選んでもらう
タスク: 親の案件が「既存」になっていて、その配下に同名タスクがあれば既存。それ以外は「新規作成」

案件の選択肢は すべての既存案件 が並びます。 CSV の取引先列は他ツールの命名と一致しないことが多いので絞り込みはせず、識別しやすいよう「案件名（取引先名）」の形で表示します。タスクの選択肢は、選んだ案件の配下に限定されます。

新規作成される案件のデフォルトは 時給制 / 単価 0 / ステータス進行中。後から案件編集で契約タイプや単価を変更できます。

3. 確認 & 実行

登録予定件数と新規作成される取引先 / 案件 / タスクの件数を表示します。「インポート実行」を押すとトランザクションで一括登録され、タイマー画面に戻ります。

重複は自動でスキップ

同じ 案件 ID + 開始時刻 の作業記録が既にある行は、自動で重複と判定してスキップします。結果のトーストに「N 件をインポート（M 件スキップ）」と表示されるので、重複が出たかどうかすぐ確認できます。

同じ CSV ファイル内で同じ案件・同じ開始時刻が複数あった場合も、最初の 1 件だけ採用して残りはスキップします。

制限

項目	制限
1 回のインポート行数	制限なし（Free / Pro 共通）
ファイルサイズ	数 MB までの CSV を想定
日跨ぎ行	対応。 `End date` を `Start date` より後の日にすれば、 24 時間を超える作業も 1 行で登録できます
ロールバック	1 行でも DB エラーが起きると全件ロールバックします。新規作成された取引先・案件・タスクも巻き戻ります

こんな時は？

Q. CSV の列名がこの表と違う A. CSV を編集してヘッダー名を上の表に合わせてください。表計算ソフトなら 1 行目を書き換えるだけです。

Q. 取り込んだ案件の契約タイプを後から変えたい A. 案件詳細から契約タイプ・単価を編集できます。既存の作業記録には影響しません。売上の自動生成は新しい契約条件で計算されます。