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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. في واجهة مستخدم "جداول بيانات Google"، انقر على الإضافات > وحدات الماكرو > استيراد.
  2. اختَر دالة من القائمة المعروضة، ثم انقر على إضافة دالة.
  3. انقر على لإغلاق مربّع الحوار.
  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".