値の当てはめを試す
customers.csv では、国とランクが "UK"・"Deutschland"・"Gold"・"VIP" のように、人が読む形で書かれています。このアプリはコード(gb・de・gold)で保存します。"Gold" と "United States" は選択肢の名前とぴったり合うので自動で当てはまり、ほかの値のせいで 4 行のうち 3 行がエラーになります。
- 「サンプルファイル」を押してから「顧客を取り込む」を押し、customers.csv を開いた取り込みの窓にドラッグして「4 行を確認する」を押します。
- ランクのエラーの横の「選ぶ…」を押します。この列の値が、行の数と一緒に並びます。「!」は、そのままでは取り込めない値の印です。gold と silver はアプリの値そのもので、"Gold" は選択肢 Gold の名前なので自動で gold に当てはまっていて、残りは VIP だけです。VIP に Gold を選んで「当てはめる」を押すと、その値のある行がまとめて直ります。
- 国も同じように選びます(UK に United Kingdom、Deutschland に Germany、USA に United States。"United States" そのものはもう当てはまっています)。これで 4 行とも取り込めます。C0002 は登録済みなので、その行は変更になり、前の値と新しい値が並びます。
このデモで承認を試す
承認が要る取り込みは、ほかの人が承認するまでデータに書き込まれません。このデモでは、デモユーザー(Demo User)が承認を頼み、Manager が承認します。
- 「承認を受けて取り込む」を押して customers.csv を取り込みます。確認の画面で、国とランクのエラーの横の「選ぶ…」から値を選んでエラーをなくし、「◯ 行の承認を頼む」を押します。
- 右上のユーザーメニューで「Manager(承認する人)に切り替える」を選ぶと、Manager として操作できます。右上のベルのマークを押すと、承認を頼む通知が届いています。
- 通知の「確認する」を押し、変わる内容を確かめて「承認して ◯ 行を取り込む」か「差し戻す…」を押します。ユーザーメニューの「デモユーザーに戻る」で戻ると、結果の通知が届いています。
承認する人の決め方・通知・承認のしかた
承認が要る取り込みは、ほかの人が承認するまでデータに書き込まれません。だれが承認するか、どう知らせるか、どう承認するかを説明します。
1. 承認する人を決める
取り込みのアクションに ->requireApproval() を足します。approvers: に承認できる人を、when: に承認が要る人を書きます。承認できる人はアプリの開発者がコードで決めるので、取り込む人が画面で選ぶことはありません。承認を頼んだ人は、承認できる人の中に入っていても、自分の取り込みは承認できません。
use Qalainau\FilamentWarpImport\Actions\WarpImportAction;
WarpImportAction::make()
->importer(CustomerImporter::class)
->requireApproval(
// Who can approve: any users (a query, a collection or an array)
approvers: fn () => User::query()->where('role', 'manager')->get(),
// Who needs approval (default: everyone). Here managers import directly
when: fn (User $user): bool => $user->role !== 'manager',
),
2. 承認を頼む
取り込む人は、いつもどおり確認の画面まで進みます。「取り込む」のボタンが「◯ 行の承認を頼む」に変わり、承認する人へのひとことを書けます。頼むと、データには何も書き込まれず、確認の画面は見るだけになります。「取り下げる」を押すと、頼むのをやめて行を直せます。
Clerk Check 42 rows
→ Request approval for 42 rows (note: "Prices for October")
→ Waiting for approval: nothing is written, the review is read only
→ Withdraw request (to edit the rows again)
3. 承認する人に知らせる
承認する人には、Filament のデータベース通知が届きます(画面の右上のベルのマーク)。通知の「確認する」を押すと、その取り込みの確認の画面が開きます。取り込みの履歴にも「承認待ち」で並ぶので、通知を見落としても開けます。パネルに ->databaseNotifications()、ユーザーのモデルに Laravel の Notifiable が要ります。メールや Slack にも知らせるときは、ImportApprovalRequested・ImportApproved・ImportRejected のイベントを受けて送ります。
// app/Providers/Filament/AdminPanelProvider.php: the bell at the top right
$panel->databaseNotifications();
// app/Models/User.php
class User extends Authenticatable
{
use Notifiable;
}
// Also by email or Slack: listen to the events (each has the ImportRun as $run)
use Qalainau\FilamentWarpImport\Events\ImportApprovalRequested;
use Qalainau\FilamentWarpImport\Events\ImportApproved;
use Qalainau\FilamentWarpImport\Events\ImportRejected;
Event::listen(ImportApprovalRequested::class, function (ImportApprovalRequested $event) {
Mail::to('managers@example.com')->send(new ImportWaitingForApproval($event->run));
});
4. 承認する・差し戻す
承認する人は、頼んだ人と同じ確認の画面で、新しく登録される行、変わる行(変わる前と後の値)、インポートしたデータに無い登録済みのデータを見ます。「承認して ◯ 行を取り込む」を押すと、ここで初めて書き込まれます(行が多ければキューで)。「差し戻す…」を押すと、理由をつけて返せます。承認する人は行を直せません。どちらの場合も頼んだ人に通知が届き、差し戻されたときは確認の画面に理由が出るので、直してもう一度頼みます。取り込んだあとは、頼んだ人も承認した人も取り消せます。
Manager (bell) "Clerk asks you to approve an import" → Review
→ the same review: new rows, changes (before → after), records not in the data
→ Approve and import 42 rows → written; Clerk is notified
→ Send back… "The mug costs 900" → nothing written; Clerk is notified,
fixes the rows and asks again
5. このデモでは
顧客の「承認を受けて取り込む」は、Manager(manager@example.com)だけが承認できます。Manager 自身は承認なしで取り込めます。右上のユーザーメニューで、デモユーザーと Manager を切り替えられます。
// app/Filament/Resources/Customers/Pages/ListCustomers.php
WarpImportAction::make('warpImportApproval')
->label('Import with approval')
->importer(CustomerImporter::class)
->requireApproval(
approvers: fn () => User::query()->where('email', 'manager@example.com')->get(),
when: fn (User $user): bool => $user->email !== 'manager@example.com',
),
カラム
| メールアドレス | 電話番号 | 国 | ランク | ||
|---|---|---|---|---|---|
|
C0001
|
伊藤 晃
|
customer1@example.com
|
04621-8-6767
|
Japan
|
Silver
|
|
C0002
|
Emmanuelle Torphy
|
customer2@example.com
|
(480) 802-0394
|
Canada
|
Regular
|
|
C0003
|
Bart Larson
|
customer3@example.com
|
1-612-273-4913
|
United States
|
Gold
|
|
C0004
|
Loyal Hamill
|
customer4@example.com
|
1-605-943-4555
|
France
|
Silver
|
|
C0005
|
Timmothy McDermott IV
|
customer5@example.com
|
352-237-2182
|
Germany
|
Regular
|
|
C0006
|
Aric Zboncak
|
customer6@example.com
|
281.980.6663
|
Australia
|
Silver
|
|
C0007
|
Jaeden Steuber
|
customer7@example.com
|
678-212-1870
|
United States
|
Regular
|
|
C0008
|
Tod Bailey
|
customer8@example.com
|
1-351-881-7799
|
Germany
|
Silver
|
|
C0009
|
Mathilde Rippin
|
customer9@example.com
|
413.628.8409
|
United Kingdom
|
Silver
|
|
C0010
|
Miss Annabel Harris
|
customer10@example.com
|
(364) 512-9965
|
Canada
|
Silver
|