Lorixen.
AR

حفظ التقارير المصدّرة مباشرة في مجلد مختار: showSaveFilePicker

باختصار: في نهاية كل يوم يصدّر محاسب المحل أو مدير الفرع تقرير المبيعات من نظام يعمل في المتصفح، فيذهب الملف إلى مجلد التنزيلات باسم مثل report (14).csv، ثم ينقله يدوياً إلى مجلد التقارير ويعيد تسميته. واجهة File System Access تتيح لتطبيق الويب أن يفتح نافذة «حفظ باسم» عبر showSaveFilePicker باسم مقترح ومجلد بداية، أو أن يطلب مرة واحدة الوصول إلى مجلد بعينه عبر showDirectoryPicker ويحفظ فيه مباشرة. توضح MDN أن الدالتين تحتاجان ضغطة من المستخدم وسياقاً آمناً، وأنهما تجريبيتان وليستا Baseline، فلا تعملان في بعض المتصفحات الأكثر استخداماً. أبقِ التنزيل العادي بديلاً دائماً.

المشكلة اليومية

سلسلة صغيرة من ثلاثة فروع لمحلات أحذية في عمّان والزرقاء تستخدم نظام مبيعات يعمل في المتصفح. كل مساء، يصدّر مدير كل فرع تقرير اليوم ويرسله للمحاسب. في مجلد التنزيلات تتراكم ملفات بأسماء متشابهة، وأحياناً يُرسل تقرير الأمس بدل اليوم، أو يُحفظ فوق ملف آخر.

المحاسب يريد شيئاً بسيطاً: كل تقرير يُحفظ في مجلد «تقارير المبيعات» على حاسوب الفرع، باسم يحمل اسم الفرع والتاريخ، دون خطوات يدوية.

نافذة «حفظ باسم» من التطبيق

بحسب MDN، تعرض الدالة showSaveFilePicker نافذة لاختيار مكان حفظ ملف، وتعيد عند الاختيار مقبض ملف من نوع FileSystemFileHandle. ومن خياراتها:

  • suggestedName: اسم الملف المقترح.
  • types: أنواع الملفات المسموح حفظها، مع وصف لكل نوع.
  • startIn: مجلد تبدأ فيه النافذة، إما مقبض ملف أو مجلد سابق، أو مجلد معروف مثل documents أو downloads أو desktop.
  • id: معرّف يجعل المتصفح يتذكر المجلد الذي فُتح فيه آخر مرة لهذا المعرّف، فتُفتح النافذة فيه لاحقاً.

وتذكر MDN أن الدالة ترمي AbortError إن أغلق المستخدم النافذة دون اختيار، أو إن رأى المتصفح أن الملف المختار حساس أو خطير. وترمي SecurityError إن لم تُستدعَ عبر تفاعل مستخدم كضغط زر.

مثال توضيحي لتصدير تقرير اليوم

async function saveDailyReport(csvText, branch) {
  const today = new Date().toISOString().slice(0, 10);
  if (!('showSaveFilePicker' in window)) return downloadFallback(csvText, branch, today);
  try {
    const handle = await window.showSaveFilePicker({
      id: 'daily-reports',
      suggestedName: `مبيعات-${branch}-${today}.csv`,
      startIn: 'documents',
      types: [{ description: 'ملف CSV', accept: { 'text/csv': ['.csv'] } }]
    });
    const writable = await handle.createWritable();
    await writable.write(csvText);
    await writable.close();
    showMessage('تم حفظ التقرير');
  } catch (e) {
    if (e.name !== 'AbortError') downloadFallback(csvText, branch, today);
  }
}

الاسم المقترح يحمل الفرع والتاريخ، والمعرّف daily-reports يجعل النافذة تُفتح في المجلد نفسه كل مساء.

كيف تتم الكتابة

يشرح توثيق createWritable في MDN أن الدالة تنشئ تياراً قابلاً للكتابة إلى الملف، وأن التغييرات لا تظهر في الملف الفعلي حتى يُغلق التيار. وعادة يُنفّذ ذلك بالكتابة إلى ملف مؤقت ثم استبدال الملف الأصلي به عند الإغلاق.

النتيجة العملية: إن انقطعت الكهرباء أو أُغلق المتصفح أثناء الكتابة، لن يبقى ملف نصف مكتوب في مجلد التقارير. لكن لا تنسَ استدعاء close، وإلا لن يُحفظ شيء.

خطوة أبعد: مجلد ثابت دون سؤال كل مرة

إن كان المدير يحفظ في المجلد نفسه كل يوم، فبدل نافذة «حفظ باسم» يومياً، يمكن للتطبيق أن يطلب الوصول إلى المجلد مرة واحدة عبر showDirectoryPicker. توضح MDN أن خيار mode فيها يكون "read" افتراضياً للقراءة فقط، أو "readwrite" للقراءة والكتابة.

بعد اختيار المجلد، يستطيع التطبيق إنشاء ملفات داخله مباشرة. لكن الإذن ليس دائماً بالضرورة. يشرح توثيق requestPermission أن الدالة تعيد حالة الإذن، وهي granted أو denied أو prompt، وأنها تحتاج تفاعل مستخدم كضغط زر. فاجعل زر «حفظ التقرير» نفسه يتحقق من الإذن ويطلبه إن لزم، ولا تفترض أنه ما زال ممنوحاً من الأمس.

ومن التفاصيل المفيدة أن مقبض المجلد يمكن حفظه في قاعدة بيانات المتصفح IndexedDB واستعادته لاحقاً، مع إعادة التحقق من الإذن.

اسم الملف: تفاصيل صغيرة تفرق

اسم الملف هو ما يبحث به المحاسب بعد أشهر، فاتفق على قاعدة واحدة:

  • التاريخ بصيغة سنة-شهر-يوم: مثل 2026-11-09، لأن الملفات تترتب بهذه الصيغة ترتيباً زمنياً صحيحاً في أي مجلد.
  • اسم الفرع ثابت: «الزرقاء» دائماً، لا مرة «زرقاء» ومرة «فرع الزرقاء».
  • بلا رموز تسبب مشكلات: تجنب الشرطة المائلة والنقطتين وعلامات الاستفهام في الاسم، فبعض أنظمة الملفات لا تقبلها.
  • العربية أم الإنجليزية: الأسماء العربية تعمل في الأنظمة الحديثة، لكن إن كانت الملفات ستُرفع إلى نظام محاسبة قديم أو تُرسل بالبريد إلى جهات أخرى، فقد تكون الأسماء اللاتينية أسلم، مثل sales-zarqa-2026-11-09.csv.

وإن احتوى ملف CSV على نصوص عربية سيفتحها المحاسب في Excel، فتأكد أن الترميز مناسب حتى لا تظهر الحروف رموزاً غريبة. هذه مشكلة منفصلة عن طريقة الحفظ، لكنها تظهر غالباً في الوقت نفسه.

متى لا تستخدمها

  • المتصفحات التي لا تدعمها: MDN تصف الواجهة بأنها تجريبية وليست Baseline. على أجهزة الفروع، اختبر المتصفح المستخدم فعلاً قبل الاعتماد عليها.
  • الجوال: التقرير اليومي على حاسوب الفرع فكرة جيدة، أما على الجوال فالتنزيل العادي أو الإرسال بالبريد أبسط.
  • التقارير الحساسة: إن كان الحاسوب مشتركاً بين موظفين، فحفظ تقارير المبيعات في مجلد يراه الجميع قد لا يكون مناسباً. ربما الأفضل أن تُرسل التقارير إلى الخادم أو إلى بريد المحاسب مباشرة.

البديل الذي يعمل دائماً

التنزيل العادي عبر رابط بخاصية download يعمل في كل المتصفحات. حسّنه على الأقل باسم ملف واضح، مثل «مبيعات-الزرقاء-2026-11-09.csv»، بدل report.csv. هذا وحده يحل نصف المشكلة، حتى قبل أي واجهة جديدة.

مثال توضيحي لترتيب العمل في الفروع

مثال توضيحي لما قد تتفق عليه السلسلة:

  1. حاسوب كل فرع يُجهّز بمجلد «تقارير المبيعات» داخل المستندات.
  2. أول مرة، يضغط المدير «اختيار مجلد التقارير» ويمنح الإذن.
  3. كل مساء، يضغط «حفظ تقرير اليوم»، فيُحفظ الملف باسم الفرع والتاريخ.
  4. المجلد نفسه متزامن مع خدمة تخزين سحابية، فيصل التقرير للمحاسب تلقائياً.
  5. في المتصفحات التي لا تدعم الواجهة، يظهر زر تنزيل عادي بالاسم الصحيح نفسه.

أسئلة شائعة

لماذا لا تظهر نافذة «حفظ باسم» عند بعض الموظفين؟

لأن الواجهة ليست مدعومة في كل المتصفحات بحسب MDN. التطبيق يجب أن يعود إلى التنزيل العادي.

هل يستطيع الموقع الوصول إلى ملفاتي دون علمي؟

لا. الوصول يتطلب ضغطة منك واختيارك للملف أو المجلد، والإذن يُطلب بشكل صريح.

لماذا لم يُحفظ الملف رغم عدم ظهور خطأ؟

غالباً لم يُستدعَ close على التيار، فالتغييرات لا تُكتب في الملف قبل الإغلاق.

هل يتذكر التطبيق المجلد؟

خيار id يجعل نافذة الحفظ تتذكر آخر مجلد. ولحفظ مباشر، يمكن تخزين مقبض المجلد وإعادة التحقق من الإذن.

إذا كان موظفوك يضيعون وقتاً في تنظيم التقارير المصدّرة يدوياً، تواصل معنا لنرتّب طريقة حفظها في نظامك.

المصادر

WhatsAppاحجز مكالمة