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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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