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

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

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

بما أنّ كل ماكرو مسجّل محدّد بالكامل ضمن 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. انقر على تعديل لحفظ إعدادات الماكرو.

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

يعرض مثال المقتطف التالي من ملف البيان القسم في البيان الذي يحدِّد وحدات الماكرو في "جداول بيانات 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".