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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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

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

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

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

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

  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.