افتح قوائم أسعار الموردين مباشرة في نظام متجرك: file_handlers
باختصار: محلات كثيرة تتلقى قوائم أسعار من الموردين كملفات CSV، ثم يفتحها الموظف في Excel وينسخ الأسعار يدوياً إلى نظام المتجر. إن كان نظامك تطبيق ويب قابلاً للتثبيت على الحاسوب، فخاصية file_handlers في ملف manifest تتيح له أن يسجّل نفسه عند نظام التشغيل كتطبيق يفتح ملفات CSV، فيضغط الموظف على الملف بزر الفأرة الأيمن ويختار «فتح باستخدام» تطبيقك، فيُفتح مباشرة في صفحة الاستيراد. تشرح MDN أن الملفات تصل إلى الصفحة عبر window.launchQueue، وأن الميزة حالياً متاحة فقط في المتصفحات المبنية على Chromium وعلى أنظمة الحاسوب، لا الجوال. هي تجريبية، فأبقِ زر «اختر ملفاً» في صفحة الاستيراد دائماً.
العمل الذي يتكرر كل أسبوع
متجر قطع غيار سيارات في عمّان يتعامل مع أربعة موردين. كل أسبوع يصل من كل مورد ملف أسعار CSV بالبريد. موظف المشتريات يحفظ الملف، يفتحه، يقارن الأسعار بالموجودة في النظام، ثم يحدّث ما تغيّر. العملية تستغرق ساعة على الأقل، والأخطاء واردة: سطر منسوخ في المكان الخطأ، أو سعر قديم لم يُحدّث.
نظام المتجر يعمل في المتصفح، وفيه صفحة «استيراد أسعار المورد» تقرأ CSV وتعرض الفروق. لكن الموظف ما زال يفتح الصفحة، ويضغط «اختر ملفاً»، ويبحث عن الملف في التنزيلات. خطوات صغيرة، لكنها تتكرر.
ما الذي تفعله file_handlers
بحسب MDN، تحدد خاصية file_handlers في ملف manifest مصفوفة من الكائنات تمثل أنواع الملفات التي يستطيع تطبيق الويب المثبت التعامل معها. ويقرأها المتصفح عند تثبيت التطبيق، ويستخدمها لربط التطبيق بأنواع الملفات على مستوى نظام التشغيل.
وكل كائن يحتاج إلى خاصيتين إلزاميتين:
- action: الرابط الذي يُفتح عند التعامل مع ملف، ويجب أن يكون ضمن نطاق تطبيق الويب.
- accept: كائن مفاتيحه أنواع MIME، وقيمه مصفوفات بالامتدادات المقابلة.
وتشرح MDN في دليل «ربط الملفات بتطبيق الويب» أن نظام التشغيل يتيح عادة للمستخدم اختيار التطبيق الذي يفتح ملفاً، وتعيين تطبيق افتراضي. ومثالها في ماك: الضغط بزر الفأرة الأيمن على الملف، ثم «الحصول على معلومات»، وتحديد التطبيق الافتراضي.
مثال توضيحي لملف manifest
{
"name": "نظام المتجر",
"start_url": "/admin/",
"scope": "/admin/",
"file_handlers": [
{
"action": "/admin/import/supplier-prices",
"accept": {
"text/csv": [".csv"]
}
}
]
}
هنا صفحة الاستيراد داخل نطاق التطبيق، كما تشترط MDN.
استقبال الملف في الصفحة
تذكر MDN أن ربط الملفات وحده لا يكفي؛ يجب أن يستخدم كود الصفحة window.launchQueue للتعامل مع الملفات الواردة، وأن ذلك يتم في كود الصفحة نفسها الذي يعمل على الخيط الرئيسي، لا في عامل الخدمة.
واجهة LaunchQueue فيها دالة واحدة، setConsumer، تأخذ دالة تُستدعى حين يُطلق المتصفح التطبيق بملف أو أكثر. وكل عنصر في launchParams.files مقبض ملف، يُقرأ محتواه عبر getFile. وتنبه MDN إلى أن الكود يجب أن يتحقق من وجود launchQueue قبل استخدامه.
مثال توضيحي:
if ('launchQueue' in window) {
launchQueue.setConsumer(async (launchParams) => {
for (const handle of launchParams.files) {
const file = await handle.getFile();
const text = await file.text();
showPricePreview(parseCsv(text), file.name);
}
});
}
الدالة showPricePreview هي نفسها التي تُستدعى حين يختار الموظف الملف بالزر العادي. لا يوجد منطق منفصل.
أول مرة: سؤال تأكيد
توضح MDN أنه في أول مرة يوشك فيها المتصفح على تشغيل تطبيقك لفتح ملف اختاره المستخدم، سيطلب منه تأكيد أنه يريد استخدام تطبيقك لذلك. أخبر الموظف بهذا مسبقاً حتى لا يتردد أو يرفض النافذة ظناً أنها شيء مريب.
الحدود الحالية
- حاسوب فقط: تذكر MDN أن الميزة متاحة حالياً فقط في المتصفحات المبنية على Chromium، وعلى أنظمة تشغيل الحاسوب.
- التطبيق مثبت: الربط يحدث عند التثبيت. الموظف الذي يفتح النظام في تبويب عادي لن يرى تطبيقك في «فتح باستخدام».
- تجريبية: MDN تصفها بأنها ليست Baseline. لا تجعلها الطريقة الوحيدة.
صفحة الاستيراد: لا تحدّث شيئاً قبل المراجعة
ميزة الفتح المباشر تختصر الطريق إلى صفحة الاستيراد، لكن ما يحدث بعدها هو الأهم. لا تجعل فتح الملف يحدّث الأسعار تلقائياً. الأفضل:
- اعرض جدولاً بالأصناف التي تغيّر سعرها: السعر القديم، والجديد، ونسبة التغيير.
- ميّز بلون مختلف التغييرات الكبيرة غير المعتادة، فقد تكون خطأً في ملف المورد.
- اعرض الأصناف الموجودة في الملف وغير الموجودة في النظام في قائمة منفصلة.
- زر «اعتماد التغييرات» واحد، يضغطه الموظف بعد المراجعة.
- احفظ سجلاً بكل استيراد: الملف، والتاريخ، ومن اعتمده، وما تغيّر.
من يستطيع اعتماد الأسعار
فتح الملف أصبح أسهل، فلا تجعل اعتماد الأسعار أسهل مما يجب. اجعل زر «اعتماد التغييرات» متاحاً فقط لأدوار محددة، كمدير المشتريات، بينما يستطيع موظف آخر فتح الملف ومراجعته وترك ملاحظات. وإن كان التغيير يمس أكثر من عدد معين من الأصناف أو يرفع سعراً بنسبة كبيرة، فاطلب تأكيداً ثانياً. هذا يحمي المتجر من ملف خاطئ أُرسل بالخطأ، أو من ضغطة متسرعة في نهاية يوم مزدحم.
ملفات الموردين ليست موحدة
كل مورد يرسل CSV بأعمدة مختلفة: مرة «رقم القطعة» ومرة «الكود»، ومرة السعر بالقطعة ومرة بالكرتونة. اجعل صفحة الاستيراد تحفظ لكل مورد طريقة ربط أعمدته بأعمدة نظامك، تُضبط مرة واحدة. ومن اسم الملف أو أول سطر فيه، يمكن للنظام أن يقترح المورد تلقائياً.
وانتبه للترميز: ملفات CSV العربية القادمة من Excel قد تصل بترميز يجعل الأسماء رموزاً غريبة. اختبر ملفاً حقيقياً من كل مورد قبل الاعتماد، واعرض في صفحة المعاينة أول خمسة أسطر كما قرأها النظام، حتى يلاحظ الموظف فوراً إن ظهرت الأسماء العربية رموزاً غير مفهومة أو انزاحت الأعمدة. وإن تغيّر شكل ملف مورد فجأة، كعمود جديد أو ترتيب مختلف، فاجعل النظام يتوقف ويطلب ضبط الربط من جديد، بدل أن يقرأ الأعمدة بالترتيب القديم ويضع الأسعار في غير مكانها.
مثال توضيحي ليوم العمل بعد التعديل
مثال توضيحي: يصل بريد المورد. يحفظ الموظف الملف، يضغط عليه بزر الفأرة الأيمن، يختار «فتح باستخدام نظام المتجر». تُفتح صفحة الاستيراد، ويتعرف النظام على المورد، ويعرض 37 صنفاً تغيّر سعرها، منها ثلاثة بزيادة كبيرة مميزة بالأحمر. يراجعها، يتصل بالمورد بشأن الثلاثة، ويعتمد الباقي.
أسئلة شائعة
لماذا لا يظهر تطبيقي في قائمة «فتح باستخدام»؟
تأكد أن التطبيق مثبت من متصفح مبني على Chromium على الحاسوب، وأن file_handlers مضبوطة بنوع الملف الصحيح.
هل تعمل على الجوال؟
بحسب MDN، الميزة حالياً على أنظمة الحاسوب فقط.
أين أكتب كود استقبال الملف؟
في الصفحة المحددة في action، عبر window.launchQueue.setConsumer، لا في عامل الخدمة.
هل يُحدّث الملف الأسعار مباشرة؟
لا يجب أن يحدث ذلك. اعرض الفروق للمراجعة أولاً، ثم اعتمدها يدوياً.
إذا كان فريقك يقضي ساعات في نقل أسعار الموردين يدوياً، تواصل معنا لنبني صفحة استيراد تختصر ذلك.