同じ Importer のまま、1 語を替えるだけ。
いまある Importer のクラスはそのまま。ImportAction を WarpImportAction に替えます。
protected function getHeaderActions(): array{ return [ ImportAction::make() ->importer(ProductImporter::class), ];}
- ✕ファイルはキューに回され、失敗した行の数と CSV があとから届きます
- ✕書き込む前に、何が増えて何が変わるかを見られません
- ✕取り込んだあとで元に戻せません
protected function getHeaderActions(): array{ return [ WarpImportAction::make() ->importer(ProductImporter::class), ];}
- ✓書き込む前に、新しい行・変わる行(どう変わるか)・エラーの行が分かります
- ✓その場でまちがいを直してから取り込めます
- ✓取り込みをボタン 1 つで元に戻せます
ノートパソコンのサーバー側で測った値です(Apple M4 Max、PHP 8.4、SQLite)。
ファイルを試す
価格が "$1,200"、日付が "Jan 5, 2026"、はい・いいえが Yes / Y / No のように書かれたファイルです。ほかに、価格が "abc" の行、登録されていない分類、重複した SKU、名前が空の行も入っています。確認の画面で間違いを直して取り込み、結果の画面で取り込みを取り消してみてください。
2 つのファイルをダウンロードし、products-with-photos.csv を取り込みます。「列の対応」の画面で、写真のファイル名が入った列が見つかり、写真を追加するよう求められます。そこで product-photos.zip を追加すると、ファイル名が同じ写真が ZIP から取り出されます。1 行だけ、ZIP に入っていない写真の名前が書かれています。
登録済みの商品の変更が 1,500 件、新しい商品が 3,500 件入っています。まずエラーの行を外して取り込みます。そのあと結果の画面でエラーの行を直し("Kitchenware" と "Gadgets" をどの分類にするか選びます)、同じ取り込みに追加で取り込みます。
国が "UK"・"USA"・"Deutschland"、ランクが "Gold"・"VIP" のように書かれていますが、アプリには gb・gold のようなコードで登録します。"Gold"・"United States" のように選択肢の名前とぴったり合う値は自動で当てはまり、エラーになりません。エラーの横の「選ぶ…」を押して残りを選ぶと、同じ値のすべての行に当てはまります。
顧客管理のシステム(CRM)から書き出したファイルで、見出しが "Client ID"・"Mail"・"Membership level" のように、Importer が当てられない名前になっています。「列の対応」で「AI で提案」を押すと、見出しが項目に対応づけられます(Client ID → 顧客コード、Mail → メールアドレス)。このデモでは、決まった短い一覧から答えを返します。あなたのアプリでは Claude が答えます。
customers-crm.csv を取り込みます(「ほかのシステムの見出し」のカードと同じく、「列の対応」で「AI で提案」を押します)。確認の画面で、国かランクのエラーの横の「選ぶ…」を押し、開いた窓の「AI で提案」を押すと、"England" は United Kingdom に、"VIP" は Gold になります。提案を確かめてから「当てはめる」を押します。このデモでは、決まった短い一覧から答えを返します。あなたのアプリでは Claude が答えます。
注文のシートと明細のシートがある Excel のブックです。明細は、注文番号で注文とつながっています。注文の一覧の上の説明で、登録されていない顧客の注文を直し、その明細も一緒に取り込む流れを試せます。
登録済みのデータを書き換える
products.csv の SKU-00002 の行は、名前が空です。そのまま取り込むと、登録されている名前が消えてしまうので、この行はエラーになります。「列の対応」で「インポートしたデータの空のセルでは、登録されている値を消さない」にチェックを入れると、この行は変更になり、名前は登録されているまま、ほかの値だけが変わります。
products.csv を選び、「列の対応」で価格の行の「登録済みを書き換える」のチェックを外します。確認の画面では、SKU-00001 の価格がグレーになり、登録されている価格のまま残ります。名前と分類は書き換わります。新しい商品には、ファイルの価格が入ります。
承認
顧客の一覧で「承認を受けて取り込む」を押し、customers.csv を取り込みます。国とランクのエラーを「選ぶ…」で直して(やり方は顧客の一覧の上の説明にあります)、承認を頼みます。次に、右上のユーザーメニューで「Manager(承認する人)に切り替える」を選びます。Manager には通知が届いていて、同じ変更の内容を確かめて、承認するか差し戻せます。
取り込んだあと
これまでのすべての取り込みが並び、それぞれで新しく作ったもの・変えたもの・取り込めなかったものが分かります。1 つを開くと行ごとの内容が見られ、取り消すこともできます。「ダウンロード」を押すと、取り込んだ内容を CSV で取り出せます。
テンプレートには、列の対応・整え方・選んだ値(UK → United Kingdom)が保存されるので、来月同じ見出しのファイルが届いても選び直さずに済みます。customers.csv を選び、国とランクを「選ぶ…」で当てはめます(やり方は顧客の一覧の上の説明にあります)。確認の画面で「テンプレートとして保存…」を押して保存します。「戻る」と「別のファイルを選ぶ」で customers.csv をもう一度選ぶと、テンプレートを当てたという知らせが出て、4 行ともそのまま取り込める状態になります。
「列の対応」で「インポートしたデータに無い商品は販売停止にする」にチェックを入れて products-5000.csv を取り込みます。products-5000.csv に入っていない 500 件の商品が、確認の画面の「インポートしたデータに無い」に並びます。取り込むと、その 500 件は販売停止になり(商品の一覧の「有効」の欄が × になります)、「この取り込みを取り消す」を押すと元に戻ります。
「定期の取り込み」のページで、見本「Supplier price list」の「今すぐ動かす」を押します。ストレージにある supplier-prices.csv を、見本に保存してある設定(products.csv の列の対応)で取り込み、一覧に結果が出ます。商品の一覧では、SKU-00001 が Blue pen・1,350 に変わっています。
商品の一覧で products.csv を取り込み、結果の画面で「定期的に取り込む…」を押します。件数の下に設定の欄が開き、ストレージ「supplier」の supplier-prices.csv がもう選ばれているので、「定期の取り込みにする」を押します。そのあとは毎日、ストレージ「supplier」の supplier-prices.csv が、products.csv のときに決めた列の対応・整え方・値の対応で取り込まれます。仕入れ先は毎回同じ列のファイルを送ってくるからです。「定期の取り込み」のページに並び、「今すぐ動かす」ですぐに試せます。
取り込みの画面は、ふつうは一覧の上に大きな窓で開きます。商品の一覧で「全画面で取り込む」を押すと、同じ画面がウィンドウいっぱいに開くので、比べてみてください(->modalWidth(Width::Screen))。スマホではどちらも全画面です。
商品の一覧で「商品を取り込む」を押すと、ファイルを置く欄の下に「Excel や Google スプレッドシートからセルを貼り付けることもできます」と書かれた欄があります。Excel や Google スプレッドシートのセルを見出しの行も含めてコピーし、ファイルを選ぶ代わりにそこへ貼り付けます。
国別のファイル
ドイツの Excel が保存するとおりのファイルです。区切りはセミコロンで、小数点はコンマです(1.250 €・2.480,00 €)。日付は 31.12.2026・15. Januar 2026、はい・いいえは ja / nein です。「価格」の整え方を開くと、Warp がファイルを見て「小数点はコンマ」を選んでいます。そのため 1.250 は 1250(千二百五十)として読まれます。
数の中に空白が入り(1 890,00 €)、日付は 13/02/2026・05/06/2026・1er février 2026、はい・いいえは oui / non です。13 月はないので、Warp は日が先に書かれていると判断し、05/06/2026 を 6 月 5 日として読みます。
日本の Excel が保存するとおりの、Shift_JIS のファイルです。「列の対応」の「文字コード」には、もう「日本語(Shift_JIS)」が選ばれています。「確認」では、価格の「1,200円」が 1200 に、在庫の「△2」が -2 になります(△ は帳簿でマイナスを表す書き方です)。和暦の「令和8年1月5日」「R8.3.1」は 2026-01-05・2026-03-01 になり、「有効」は「はい」「○」ならチェックの印 ✓、「いいえ」「×」ならバツの印 ✗ になります(表を右へ動かすと見えます)。名前のない行、価格の「abc」、分類の「Gadgets」、SKU の重複のエラーは、products.csv と同じ、わざと入れた間違いです。SKU-00001 は登録済みなので、その行は「変更」になります。
見出しは日本語で、都道府県は「東京都」のような名前で、ランクは「ゴールド」「一般」「Gold」「silver」が混ざっています。C0001 のメールアドレスと電話番号は全角です。見出しは自動で項目に対応づけられます。「確認」では「YAMADA@example.com」が yamada@example.com に、「03ー1234ー5678」が 03-1234-5678 に、「1000001」が 100-0001 になります。アプリは都道府県とランクを名前ではなくコードで登録します。東京都・大阪府・北海道・Gold は選択肢の名前とぴったり合うので自動で当てはまり、「愛知」「ゴールド」「一般」がエラーになります。都道府県のエラーの横の「選ぶ…」を押し、「愛知」に「愛知県」を選びます。ランクでは「ゴールド」に Gold、「一般」に Regular を選びます(silver は登録するコードそのものなので、そのまま通ります)。これで 4 行とも取り込めます。C0001 は登録済みなので、その行は「変更」になります。
注文と明細の 2 枚のシートがある Excel のファイルで、「確認」では、シートの名前のままの「Orders」と、「注文の明細」のタブに分かれます。見出しは日本語(受注番号・顧客コード、明細のシートには数量)で、日付の 1 つが和暦です。「列の対応」では、日本語の見出しがもう項目に対応づけられています(受注番号 → 注文番号)。「確認」では「令和8年10月18日」が 2026-10-18 になり、登録済みの ORD-00001 は「変更」になります。ORD-90002 の顧客(C9999)は登録されていないので、「注文の明細」にもエラーが 2 つ出ます。ORD-90002 の明細(注文の行を直すまで取り込めないもの)と、ファイルにない注文 ORD-99999 の明細です。ORD-90002 を直して明細も一緒に取り込む方法は、注文の一覧の上の説明にあります。