公開デモ。取り込みも修正も取り消しも自由に試せます。データは 1 時間ごとに元に戻ります。 warpui.com Warp Import について ドキュメント 質問する サポート filamentphp.com
本文へスキップ

はじめに

下のサンプルファイルをダウンロードし、商品や顧客の一覧を開いて、取り込みのボタンを押してください。取り込みのボタンはどれも、Filament の普通の Importer をそのまま使う WarpImportAction です(各一覧の「コードを見る」で中身を見られます)。最後に取り込みのボタンを押すまで、データには何も書き込まれません。取り込んだあとも、どの取り込みも取り消せます。

同じ Importer のまま、1 語を替えるだけ。

いまある Importer のクラスはそのまま。ImportAction を WarpImportAction に替えます。

Filament 標準 ImportAction
protected function getHeaderActions(): array{    return [        ImportAction::make()            ->importer(ProductImporter::class),    ];}
  • ✕ファイルはキューに回され、失敗した行の数と CSV があとから届きます
  • ✕書き込む前に、何が増えて何が変わるかを見られません
  • ✕取り込んだあとで元に戻せません
Warp Import を使うと 1 語
protected function getHeaderActions(): array{    return [        WarpImportAction::make()            ->importer(ProductImporter::class),    ];}
  • ✓書き込む前に、新しい行・変わる行(どう変わるか)・エラーの行が分かります
  • ✓その場でまちがいを直してから取り込めます
  • ✓取り込みをボタン 1 つで元に戻せます
10,000 行の取り込みが 6.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 に入っていない写真の名前が書かれています。

5,000 件の商品

登録済みの商品の変更が 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 が答えます。

値を AI で当てはめる

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 を直して明細も一緒に取り込む方法は、注文の一覧の上の説明にあります。