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

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

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

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

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

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

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

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

ملاحظة: تتضمّن ملفات البيان مكوّنات أخرى ذات صلة بخصائص "برمجة تطبيقات Google". ترتبط الحقول ضمن 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"

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

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

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

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

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