Cookle では材料などのデータを CSV ファイルで一括登録できます。CSV の取り込みがうまくいかない場合は、ファイルの形式や内容に問題があることがほとんどです。以下のポイントを順番に確認してください。
ファイル形式・文字コードを確認する
文字コードを確認する
CSV ファイルの文字コードが指定の形式と異なると、文字化けやエラーの原因になります。Cookle では UTF-8（BOM なし）形式を推奨しています。Excel などで保存した場合は Shift-JIS になっていることがあるため、テキストエディタや変換ツールで UTF-8 に変換してから取り込んでください。
ファイルの拡張子・形式を確認する
取り込めるファイルは .csv 形式のみです。Excel の .xlsx や .xls 形式はそのままでは取り込めません。Excel で作成した場合は「名前を付けて保存」で「CSV（コンマ区切り）」を選択して保存してください。
テンプレート・必須項目を確認する
公式テンプレートを使用する
Cookle が提供する CSV テンプレートを使用してください。独自のフォーマットや列の順序が異なる場合、正しく取り込めないことがあります。一括登録画面からテンプレートをダウンロードし、そのフォーマットに沿ってデータを入力してください。
必須項目が入力されているか確認する
名称や単位など、必須の項目が空欄になっている行はエラーになります。テンプレートの各列の意味と必須・任意の区別を確認し、必須項目をすべて入力してください。
データの内容に不備がないか確認する
以下のような不備があると取り込みに失敗することがあります。
- 数値項目に文字列や記号が混入している
- 1 セル内に改行が含まれている
- ヘッダー行が変更・削除されている
- データ行が空白行で区切られている
材料の CSV 一括登録について
材料の一括登録は、CSV を使ってまとめて登録・更新できる機能です。店舗で使用する食材・調味料などを大量に登録する際に便利です。テンプレートに沿って材料名・単位・原価などを入力し、一括登録画面からアップロードしてください。既存データの上書き更新にも対応しています。詳しい手順は「材料の CSV 一括登録」の記事をご覧ください。
よくある質問
文字コードの不一致が原因です。CSV ファイルを UTF-8（BOM なし）形式で保存し直して、再度取り込んでください。Windows の Excel で保存する場合は Shift-JIS になりやすいため、テキストエディタや変換ツールで文字コードを変換することをおすすめします。
取り込みエラーの詳細メッセージに問題のある行番号や項目が表示されることがあります。メッセージを確認し、該当箇所のデータを修正してください。エラー内容が分からない場合は、データを少量に絞って取り込みをテストすると原因を特定しやすくなります。
取り込まれなかった行に必須項目の漏れや形式の不備がある可能性があります。エラーメッセージで該当行を確認し、データを修正してから再度取り込んでください。正常に取り込まれたデータは重複しないよう、修正行のみを CSV に含めて再取り込みすることをおすすめします。