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

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

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

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

إنشاء وحدات ماكرو في "برمجة تطبيقات Google"

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

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

1. في واجهة مستخدم "جداول بيانات 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".

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

عند إنشاء وحدات ماكرو أو إدارتها في "برمجة تطبيقات Google"، ننصحك بالالتزام بالإرشادات التالية.

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

إجراءات لا يمكنك فعلها

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

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

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

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

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

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

لا يمكنك توزيع تعريفات ماكرو باستخدام مكتبات "برمجة تطبيقات Google".

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

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