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

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

عند تسجيل وحدة ماكرو، تنشئ "جداول بيانات Google" تلقائيًا دالة في Apps Script (دالة الماكرو) التي تكرّر خطوات الماكرو. تتم إضافة دالة الماكرو إلى مشروع "برمجة تطبيقات 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. ابحث عن الماكرو الذي تريد تعديله وانقر على > تعديل الماكرو. يؤدي ذلك إلى فتح محرر "برمجة تطبيقات Google" على ملف المشروع الذي يحتوي على دالة الماكرو.
3. عدِّل دالة الماكرو لتغيير سلوك الماكرو.
4. احفظ مشروع النص البرمجي. بعد ذلك، يصبح الماكرو متاحًا للاستخدام في ورقة البيانات.
5. اختبِر وظيفة الماكرو في جدول البيانات للتأكّد من أنّها تعمل على النحو المطلوب.

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

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

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

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

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

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

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

  {
    ...
    "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".