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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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