Lorixen.
AR

أول سكربت Apps Script لجدولك: تنظيف الأرقام وإرسال ملخص بالبريد

باختصار: Apps Script لغة برمجة مبنية على جافاسكربت، تعمل داخل جدول Google Sheets دون تثبيت أي شيء. في هذا الدليل تكتب سكربتين صغيرين: الأول يوحّد أرقام الهاتف المحلية إلى الصيغة الدولية، والثاني يرسل ملخصاً بعدد الطلبات كل صباح عبر البريد. ستحتاج إلى مشغّل زمني لتشغيل الثاني تلقائياً، وستظهر لك نافذة صلاحيات عند أول تشغيل، وهي طبيعية إذا كان السكربت لك. عند الخطأ، افتح سجل التنفيذ لترى السطر الذي فشل. ابدأ بالجدول التجريبي قبل أن تعدّل أي بيانات حقيقية، واحتفظ بنسخة من الملف قبل كل تغيير كبير.

قبل أن تبدأ

افتح جدولاً جديداً، واكتب في الورقة الأولى عناوين الأعمدة: الاسم، والهاتف، والتاريخ، والمبلغ. ثم أضف عشرة صفوف تجريبية، واكتب بعض أرقام الهاتف بطرق مختلفة، مثل 0791234567 و+962 79 123 4567 و00962791234567. هذا التنوع هو ما سيختبره السكربت الأول.

السكربت الأول: توحيد الأرقام

من قائمة الإضافات اختر Apps Script، ثم امسح الكود الافتراضي والصق هذا:

function normalizePhone(value) {
  let digits = String(value).replace(/\D/g, '');
  if (digits.indexOf('00962') === 0) digits = digits.substring(5);
  if (digits.indexOf('962') === 0) return '+' + digits;
  if (digits.charAt(0) === '0') digits = digits.substring(1);
  return '+962' + digits;
}

function cleanPhoneColumn() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const last = sheet.getLastRow();
  if (last < 2) return;
  const range = sheet.getRange(2, 2, last - 1, 1);
  const cleaned = range.getValues().map(row => [normalizePhone(row[0])]);
  range.setNumberFormat('@');
  range.setValues(cleaned);
}

الدالة normalizePhone تحذف كل شيء غير الأرقام، ثم تعالج ثلاث حالات: الرقم يبدأ بـ 00962، أو بـ 962 مباشرة، أو بصفر محلي. في كل حالة ينتهي الرقم بالمفتاح +962 أمامه. أما الدالة cleanPhoneColumn فتعمل على العمود الثاني من الصف الثاني إلى آخر صف، وتضبط التنسيق على نص حتى لا يفقد الرقم صفره أو علامته.

تشغيل السكربت

احفظ المشروع، ثم اختر الدالة cleanPhoneColumn من القائمة الموجودة في الشريط العلوي للمحرر، واضغط تشغيل. ستطلب Google صلاحية تعديل الجدول، وهذه صلاحية تحتاجها فعلاً. عد إلى الجدول ولاحظ أن الأرقام توحدت. إذا أصلحت خطأ في الكود، فشغّل الدالة من جديد، فهي تعيد المعالجة على القيم الحالية دون أن تكرر شيئاً.

السكربت الثاني: الملخص اليومي

الآن نريد أن يرسل السكربت إليك كل صباح عدد طلبات اليوم السابق. أضف هذا الكود في الملف نفسه:

const RECIPIENT = 'owner@example.com'; // بريد تجريبي، غيّره لبريدك

function sendDailySummary() {
  const sheet = SpreadsheetApp.getActive().getSheetByName('Orders');
  const rows = sheet.getDataRange().getValues().slice(1);

  const yesterday = new Date();
  yesterday.setDate(yesterday.getDate() - 1);
  const key = yesterday.toDateString();

  const count = rows.filter(r => r[0] instanceof Date && r[0].toDateString() === key).length;
  const body = `عدد الطلبات أمس: ${count}`;
  MailApp.sendEmail(RECIPIENT, 'ملخص طلبات أمس', body);
}

الدالة تقرأ ورقة Orders، وتفترض أن العمود الأول فيها هو التاريخ، ثم تحسب الصفوف التي تنتمي إلى الأمس وترسل النتيجة. اسم الورقة وموقع التاريخ في الكود يجب أن يطابقا جدولك، فإن اختلفا فعدّلهما قبل الاختبار.

تشغيل المشغّل الزمني

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

function createDailyTrigger() {
  ScriptApp.newTrigger('sendDailySummary')
    .timeBased()
    .everyDays(1)
    .atHour(8)
    .create();
}

بعد التشغيل، افتح قسم المشغّلات في محرر Apps Script وتأكد من وجود المشغّل. الساعة المحددة تعني أن التنفيذ يحدث في الساعة الثامنة تقريباً، لأن Google تختار نافذة زمنية مدتها ساعة. وتحدد المنطقة الزمنية في إعدادات المشروع، فراجعها إن كان المشروع قد أُنشئ من حساب بمنطقة مختلفة.

صلاحيات تظهر لأول مرة

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

التصحيح بسجل التنفيذ

عند الفشل، افتح من القائمة الجانبية قسم التنفيذات، وسترى كل تشغيل مع حالته وسبب الخطأ. الرسالة الأكثر شيوعاً تكون اسم ورقة مكتوباً بشكل مختلف، أو عموداً فارغاً يسبب خطأ في التواريخ. أضف سطر console.log(rows.length) داخل الدالة لتعرف عدد الصفوف التي قرأها السكربت، فهذا يكشف معظم المشكلات.

أخطاء يقع فيها المبتدئون

  • تعديل الجدول الأصلي مباشرة: اعمل على نسخة تجريبية أولاً، ثم انقل الكود إلى الجدول الحقيقي بعد التأكد.
  • التاريخ المكتوب كنص: إذا كانت التواريخ في الجدول نصاً، فلن يتعرف السكربت عليها، لذلك حوّلها إلى تاريخ حقيقي عبر تنسيق التاريخ في الجدول، أو أعد إدخالها.
  • نسيان حفظ المشروع: المحرر يحفظ عادة، لكن تأكد من أن التعديل ظهر قبل التشغيل.
  • مشغّل مكرر: كل تشغيل لدالة إنشاء المشغّل يضيف مشغّلاً جديداً، فتصل الرسالة أكثر من مرة. احذف المكرر من قائمة المشغّلات.

لماذا نبدأ بالتجريب على نسخة

السكربت الذي يكتب في الجدول قد يخطئ في أول تجربة، والخطأ هنا يمسح قيماً لا تعود. لذلك انسخ الجدول كله قبل أي تشغيل، وسمِّ النسخة بتاريخ اليوم، وشغّل السكربت على النسخة أولاً. إذا جاءت النتيجة صحيحة، فانقل الكود إلى الجدول الحقيقي، وكرر الخطوة مرة واحدة فقط قبل الاعتماد عليه.

قائمة تحقق

  • ☐ جربت السكربت الأول على جدول تجريبي قبل الجدول الحقيقي.
  • ☐ الأرقام المحلية تتحول إلى صيغة دولية بعد التشغيل.
  • ☐ المشغّل الزمني موجود مرة واحدة فقط في قائمة المشغّلات.
  • ☐ البريد المستلم صحيح، وأُرسل الملخص لمرة واحدة على الأقل للتجربة.
  • ☐ سجل التنفيذ يُراجع عند أي فشل.

أسئلة شائعة

هل يغيّر السكربت الأرقام في الجدول فعلاً؟

نعم، يكتب القيم الجديدة مكان القديمة. لذلك احتفظ بنسخة من العمود قبل التشغيل الأول، فإن أردت الرجوع فستجد الأرقام الأصلية.

هل يكفي مشغّل واحد للساعة الثامنة؟

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

هل أحتاج إلى تشغيل جهاز الكمبيوتر ليعمل السكربت؟

لا، فالمشغّلات الزمنية تعمل على خوادم Google، ولا تحتاج جهازك مفتوحاً أو متصلاً بالإنترنت.

هل يعمل السكربت مع جداول أخرى؟

نعم، إذا اتبعت الأسماء نفسها للأوراق والأعمدة. كرر الفكرة، وغيّر اسم الورقة ومكان التاريخ في الكود بما يطابق الجدول الجديد.

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

المصادر

WhatsAppاحجز مكالمة