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

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

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

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

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

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

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

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

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

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

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

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

إذا كان هناك نص برمجي مرتبط بورقة من قبل، يمكنك import دالة في النص البرمجي كوحدة ماكرو جديدة، ثم تخصيص اختصار لوحة مفاتيح له. ويمكنك إجراء ذلك من خلال تعديل ملف البيان وإضافة عنصر آخر إلى السمة 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".

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

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

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

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

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

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

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

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

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

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

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

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

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