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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يعرض المثال التالي مقتطفًا لملف البيان القسم manifest التي تحدد وحدات ماكرو "جداول بيانات 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، أو النماذج أو العروض التقديمية.