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

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

عند تسجيل وحدة ماكرو، ينشئ "جداول بيانات Google" تلقائيًا دالة "برمجة تطبيقات Google" (دالة الماكرو) التي تكرّر خطوات الماكرو. تتم إضافة دالة الماكرو إلى مشروع "برمجة تطبيقات Google" مرتبط بورقة البيانات، في ملف بعنوان macros.gs. في حال وجود ملف مشروع مرتبط بالورقة بهذا الاسم، يتم إلحاق دالة الماكرو به. تعمل "جداول بيانات 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".

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

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

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

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

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

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

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

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

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

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

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

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

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