وحدات ماكرو "جداول بيانات Google"

يتيح لك تطبيق "جداول بيانات Google" تسجيل الإجراءات المُجمَّعة التي تكرّر سلسلة محدّدة من تفاعلات واجهة المستخدم التي تحدّدها. بعد تسجيل مَعلمة macro، يمكنك ربطها بختصار لوحة مفاتيح على النحو التالي: Ctrl+Alt+Shift+Number. يمكنك استخدام هذا الاختصار لتنفيذ خطوات الماكرو بالضبط مرة أخرى بسرعة، عادةً في مكان مختلف أو على بيانات مختلفة. يمكنك أيضًا تفعيل وحدة الماكرو من قائمة الإضافات > وحدات الماكرو في "جداول بيانات Google".

عند تسجيل وحدة ماكرو، تُنشئ "جداول بيانات Google" تلقائيًا دالة "برمجة تطبيقات Google" (دالة الماكرو) التي تكرّر خطوات الماكرو. تتم إضافة دالة الماكرو إلى مشروع "برمجة تطبيقات Google" مرتبط بالورقة، في ملف بعنوان macros.gs. في حال توفّر ملف مشروع مرتبط بالورقة بهذا الاسم، تتم إضافة دالة الماكرو إليه. تعمل جداول بيانات Google أيضًا على تحديث manifest مشروع النص البرمجي تلقائيًا، مع تسجيل الاسم واختصار لوحة المفاتيح المخصّص لوحدة الماكرو.

بما أنّ كل ماكرو مسجّل يتم تحديده بالكامل ضمن Apps Script، يمكنك تعديله مباشرةً ضمن محرِّر Apps Script. يمكنك أيضًا كتابة وحدات ماكرو من البداية في Apps Script، أو استخدام الدوال التي سبق لك كتابتها و تحويلها إلى وحدات ماكرو.

إنشاء وحدات ماكرو في Apps Script

يمكنك استخدام الدوال المكتوبة في Apps Script كدوالّ ماكرو. أسهل طريقة لإجراء ذلك هي استيراد دالة حالية من محرر "جداول بيانات Google".

بدلاً من ذلك، يمكنك إنشاء وحدات ماكرو في محرِّر Apps Script باتّباع الخطوات التالية:

1. في واجهة مستخدم "جداول بيانات Google"، اختَر الإضافات > برمجة تطبيقات Google لفتح النص البرمجي المرتبط بالورقة في محرِّر "برمجة تطبيقات Google".
2. اكتب دالة الماكرو. يجب ألا تأخذ دوالّ الماكرو أي وسيطات وألا تعرِض أي قيم.
3. عدِّل بيان النص البرمجي لإنشاء وحدة الماكرو وربطها بوظيفة الماكرو. امنح الإجراء اختصارًا فريدًا للوحة المفاتيح واسمًا.
4. احفظ مشروع النص البرمجي. بعد ذلك، يصبح الماكرو متاحًا للاستخدام في ورقة البيانات.
5. اختبِر وظيفة الماكرو في جدول البيانات للتأكّد من أنّها تعمل على النحو المطلوب.

تعديل وحدات ماكرو

يمكنك تعديل وحدات الماكرو المرفقة بجدول بيانات من خلال اتّباع الخطوات التالية:

1. في واجهة مستخدم "جداول بيانات Google"، اختَر الإضافات > وحدات الماكرو > إدارة وحدات الماكرو.
2. ابحث عن وحدة الماكرو التي تريد تعديلها وانقر على more_vert > تعديل الماكرو. يؤدي ذلك إلى فتح محرر "برمجة تطبيقات Google" على ملف المشروع الذي يحتوي على دالة الماكرو.
3. عدِّل دالة الماكرو لتغيير سلوك وحدة الماكرو.
4. احفظ مشروع النص البرمجي. بعد ذلك، يصبح الماكرو متاحًا للاستخدام في ورقة البيانات.
5. اختبِر دالة الماكرو في ورقة البيانات للتأكّد من أنّها تعمل على النحو المنشود.

استيراد الدوالّ كوحدات ماكرو

إذا كان هناك نص برمجي مرتبط بجدول بيانات، يمكنك import دالة في النص البرمجي كوحدة ماكرو جديدة ثم تحديد اختصار لوحة مفاتيح لها. يمكنك إجراء ذلك من خلال تعديل ملف البيان وإضافة عنصر آخر إلى السمة sheets.macros[].

بدلاً من ذلك، اتّبِع الخطوات التالية لاستيراد دالة كإجراء مجمّع من واجهة مستخدم "جداول بيانات Google":

1. في واجهة مستخدم "جداول بيانات Google"، اختَر الإضافات > وحدات الماكرو > استيراد.
2. اختَر دالة من القائمة المعروضة، ثم انقر على إضافة دالة.
3. انقر على clear لإغلاق مربّع الحوار.
4. اختَر الإضافات > وحدات الماكرو > إدارة وحدات الماكرو.
5. حدِّد مكان الدالة التي استوردتها للتو في القائمة. خصِّص اختصارًا فريدًا للوحة مفاتيح للماكرو. يمكنك أيضًا تغيير اسم الماكرو هنا، ويكون الاسم تلقائيًا هو اسم الدالة.
6. انقر على تعديل لحفظ إعدادات الماكرو.

بنية البيان لوحدات الماكرو

يعرض مثال المقتطف التالي من ملف البيان القسم في manifest الذي يحدّد وحدات الماكرو في "جداول بيانات Google". يحدِّد القسم sheets من البيان الاسم واختصار لوحة المفاتيح المخصّصَين للماكرو واسم دالة الماكرو.

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

اطّلِع على مستند بيان وحدات الماكرو في "جداول بيانات Google" لمزيد من التفاصيل حول كيفية إنشاء بيانات بيان وحدات الماكرو في "جداول بيانات Google".

أفضل الممارسات

عند إنشاء وحدات الماكرو أو إدارتها في Apps Script، ننصحك باتّباع الإرشادات التالية.

1. تحقّق وحدات الماكرو أداءً أفضل عندما تكون خفيفة الوزن. حدِّد، قدر الإمكان، عدد الإجراءات التي تتّخذها وحدة الماكرو.
2. وحدات الماكرو هي الأنسب للعمليات الروتينية التي يجب تكرارها بكثرة بدون إعدادات قليلة أو بدون إعدادات على الإطلاق. بالنسبة إلى العمليات الأخرى، ننصحك باستخدام عنصر قائمة مخصّص بدلاً من ذلك.
3. تذكَّر دائمًا أنّ اختصارات لوحة المفاتيح الخاصة بالإجراءات المجمّعة يجب أن تكون فريدة، ولا يمكن أن تتضمّن جدول بيانات معيّن سوى عشرة إجراءات مجمّعة مع اختصارات في أي وقت. لا يمكن تنفيذ أي وحدات ماكرو إضافية إلا من قائمة الإضافات > وحدات الماكرو.
4. يمكن تطبيق وحدات الماكرو التي تُجري تغييرات على خلية واحدة على نطاق من الخلايا بتحديد النطاق الكامل أولاً ثم تفعيل وحدة الماكرو. وهذا يعني أنّه غالبًا ما يكون من غير الضروري إنشاء وحدات ماكرو تكرّر الإجراء نفسه على نطاق محدّد مسبقًا من الخلايا.

الإجراءات التي لا يمكنك اتّخاذها

هناك بعض القيود المفروضة على الإجراءات التي يمكنك تنفيذها باستخدام وحدات الماكرو:

استخدام وحدات ماكرو خارج النصوص البرمجية المرتبطة

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

تحديد وحدات الماكرو في إضافات "جداول بيانات Google"

لا يمكنك توزيع تعريفات الوحدات النمطية باستخدام إضافة "جداول بيانات Google". يتجاهل مستخدمو هذه الإضافة أي تعريفات ماكرو في مشروع إضافة "جداول بيانات Google".

توزيع وحدات الماكرو في مكتبات النصوص البرمجية

لا يمكنك توزيع تعريفات وحدات الماكرو باستخدام مكتبات Apps Script.

استخدام وحدات الماكرو خارج "جداول بيانات Google"

وحدات ماكرو هي مجرد ميزة في جداول بيانات Google، ولا توجد في "مستندات Google" أو "نماذج Google" أو "العروض التقديمية من Google".