إنشاء الدوال المُسمّاة واستخدامها

تسمح لك الدوال المُسمّاة بإنشاء دوال مخصصة يمكنها استخدام الصِيَغ المضمّنة في "جداول بيانات Google". لقد وفّرنا إمكانية استيراد الدوال المُسمّاة لكي يكون بإمكانك استخدامها في أكثر من ورقة بيانات واحدة.

Named functions tutorial

للاطّلاع على هذا الفيديو نفسه مع أوصاف الصوت: Named functions tutorial

للحصول على مثال لجدول بيانات والمتابعة للفيديو، يُرجى النقر على "إنشاء نسخة" أدناه.

إنشاء نسخة

فتح الدوال المُسمّاة

  1. في جدول بيانات جديد أو حالي، انقر على البيانات ثم الدوال المُسمّاة.

في خلية تحتوي على صيغة:

  1. انقر بزر الماوس الأيمن على الخلية التي تحتوي على صيغة.
  2. انقر على عرض المزيد من إجراءات الخليةثم تعريف الدالة المُسمّاة.

إنشاء دالة مُسمّاة

عند إنشاء دالة مُسمّاة، استخدِم النصوص كعناصر نائبة للإدخالات.

على سبيل المثال، تقبل دالة IF ما لا يزيد عن 3 وسيطات:

IF(التعبير_المنطقي، قيمة_إذا_صحيحة، قيمة_إذا_خاطئة)

إذا أدرجت النص "التعبير_المنطقي" أو "قيمة_إذا_صحيحة" أو "قيمة_إذا_خاطئة" كوسيطات في خلية، ستظهر لك رسالة خطأ. هذه الوسيطات هي عناصر نائبة وأوصاف لأنواع الإدخالات التي تتوقعها الدالة. إذا أردت استخدام إدخالات مختلفة في الدالة، عند كتابة دالة مُسمّاة، يجب تعريف العناصر النائبة للوسيطة.

في السابق، كان بإمكانك إنشاء دوال مخصصة باستخدام "برمجة تطبيقات Google" فقط، ما كان يتطلّب منك كتابة JavaScript. باستخدام الدوال المُسمّاة، يمكنك إنشاء دوال مخصصة باستخدام واجهة بسيطة وبدون كتابة أي رمز.

المكوّنات الأربعة الأساسية في الدالة المُسمّاة هي:

  • اسم الدالة
    • اسم الدالة الذي تستخدمه لإدراجها في خلية. وتتم كتابة هذا الاسم بالأحرف الكبيرة (باللغة الإنجليزية).
    • الشروط:
      • لا يمكن إعطاؤها نفس اسم دالة مضمّنة في "جداول بيانات Google"، مثلاً SUM.
      • لا يمكن تسميتها صحيح أو خطأ.
      • لا يمكن أن تكون بالبنية "A1" أو "R1C1".
        • على سبيل المثال، إذا منحت الدالة اسمًا مثل "A1" أو "AA11"، ستظهر لك رسالة خطأ.
      • لا يمكن أن يبدأ الاسم برقم.
      • يجب ألا يزيد عدد الأحرف عن 255 حرفًا.
      • يجب ألّا يتضمّن أي مسافات.
      • يجب ألا يحتوي على رموز خاصة باستثناء الشرطات السفلية.
  • وصف الدالة
    • وصف الدالة هو ما يظهر في القسم "لمحة" في مربّع مساعدة الدوال.
  • العناصر النائبة للوسيطات [اختياري]
    • العناصر النائبة هي أوصاف لأنواع الإدخالات التي تتوقعها الدالة. على سبيل المثال، يُستخدَم اسم الوسيطة "خلية" عندما يكون الإدخال الذي تتوقعه هو خلية واحدة، ويُستخدَم الاسم "نطاق" عندما يكون الإدخال الذي تتوقعه نطاقًا من الخلايا.
    • الشروط:
      • لا يمكن أن يكون هو نفسه اسم عنصر نائب آخر للوسيطة في الدالة المُسمّاة.
      • لا يمكن أن يكون بالبنية "A1" أو "R1C1".
        • على سبيل المثال، إذا منحت العنصر النائب اسمًا مثل "A1" أو "AA11"، ستظهر لك رسالة خطأ.
      • يجب ألا يتضمّن أي مسافات.
      • يجب ألا يحتوي على رموز خاصة باستثناء الشرطات السفلية.
  • تعريف الصيغة
    • هي الصيغة المكتوبة التي تدرجها في خلية. عند تضمين وسيطات محدَّدة، تتوقع الدالة إدخالات لكل وسيطة عند إدراج الدالة في خلية.
    • الشروط:
      • يجب أن تكون صيغة قابلة للتحليل.
      • يجب ألا يكون هناك أقواس مفقودة.
      • يجب ألا تحتوي على فواصل في مواضع غير صحيحة.

تفاصيل أخرى

بعد إعداد المكوّنات الأساسية أعلاه، يمكنك إضافة المزيد من التفاصيل في الصفحة الثانية. في كل عنصر نائب تحدِّده لوسيطة، تتوفّر الحقول التالية:

  • وصف الوسيطة
    • هذا وصف مختصر لما تتوقعه الدالة لهذه الوسيطة، مثلاً "قيمة واحدة تبحث عنها".
  • مثال للوسيطة
    • هذا مثال على إدخال لهذه الوسيطة، مثلاً وسيطة يجب أن تكون نطاقًا من الخلايا: "B3:B14".

يتم استخدام هذه التفاصيل الإضافية مع المكوّنات الأساسية لملء مربّع مساعدة الدالة عند إضافة الدالة المُسمّاة إلى خلية:

Sample of Named function arguments.

استيراد الدوال المُسمّاة

عندما تنشئ المزيد من الدوال المُسمّاة أو تبدأ في العثور على دوال مفيدة أنشأها الآخرون، يجب أن تتوفّر لك إمكانية استخدامها في أوراق بيانات مختلفة. لإعادة استخدام الدوال المُسمّاة التي تم إنشاؤها، يمكنك استيرادها من ورقة بيانات أخرى إلى الورقة الحالية:

  1. على الكمبيوتر، افتَح جداول بيانات Google.
  2. افتَح ورقة البيانات التي تريد استيراد الدوال المُسمّاة إليها.
  3. في أعلى الصفحة، انقر على البياناتثم الدوال المُسَمّاةثم استيراد دالة.
  4. اختَر ورقة البيانات التي تريد الاستيراد منها.
  5. اختَر الدوال المُسمّاة التي تريد استيرادها.
    • إذا كنت تريد استيراد جميع الدوال المُسمّاة من الملف، انقر على استيراد الكل.
  6. انقر على استيراد.

ملاحظات:

  • إذا كانت الدالة المُسمّاة التي اخترت استيرادها تحمل الاسم نفسه كدالة مُسمّاة حالية في ملفك النشط: تلغي الدالة التي تم استيرادها الدالة المُسمّاة الحالية.
  • إذا كانت الدالة المُسمّاة التي اخترت استيرادها تعتمد على دالة أخرى مُسمّاة، مثلاً تعريف صيغة: سيحذرك تطبيق "جداول بيانات Google" بشأن تلك الاعتمادية ويتم تمييز الدوال التي تعتمد عليها.
  • إذا كانت الدالة المُسمّاة التي اخترت استيرادها تستخدم صيغة تتفاعل مع مصدر خارجي، مثلاً IMAGE: يحذرك تطبيق "جداول بيانات Google" بشأن هذا التفاعل.

أمثلة

دالة مُسمّاة مع عنصرَين نائبَين للوسيطة

  • اسم الدالة: CONTAINS
  • الوصف: تتحقّق مما إذا كانت القيمة تظهر في نطاق. تعرض صحيح إذا ظهرت القيمة وخطأ إذا لم تظهر.
  • العنصران النائبان للوسيطة: طلب_البحث ونطاق_البحث
  • التعريف: (طلب_البحث,نطاق_البحث,0)))‎=NOT(ISERROR(MATCH
  • في ما يلي مزيد من التفاصيل:
    • وصف الوسيطة: طلب_البحث
      • القيمة التي تبحث عنها
    • مثال للوسيطة: طلب_البحث
      • B3
    • وصف الوسيطة: نطاق_البحث
      • النطاق الذي تبحث عن القيمة فيه
    • مثال للوسيطة: نطاق_البحث
      • B3:B14

دالة مُسمّاة بدون عناصر نائبة للوسيطات

  • اسم الدالة: شعار_الدالة_المسماة
  • الوصف: تُنشئ جملة رائعة تصِف الدوال المُسمّاة.
  • التعريف: ="تساعد الدوال المُسمّاة في تسهيل استخدام صيغي وقراءتها".

دالة مُسمّاة تستخدم التكرار

  • اسم الدالة: عكس_الكلمات
  • الوصف: تعكس ترتيب الكلمات في سلسلة بيانات.
  • العناصر النائبة: str
  • التعريف:‎=IF(ISERROR(FIND(" ", str)), str, عكس_الكلمات(RIGHT(str, LEN(str)-FIND(" ", str)))&" "&LEFT(str, FIND(" ",str)-1))
  • في ما يلي مزيد من التفاصيل:
    • وصف الوسيطة: str
      • سلسلة البيانات التي تريد عكسها
    • مثال للوسيطة: str
      • "عكسها التي تريد سلسلة البيانات"

دالة مُسمّاة باستخدام LAMBDA

  • اسم الدالة: عدّ_الصيغ
  • الوصف: تحسب عدد الصِيَغ لنطاق محدَّد.
  • العناصر النائبة: نطاق
  • التعريف: ‎=COUNTIF(MAP(‪نطاق,LAMBDA(خلية, ISFORMULA(خلية))),"TRUE"‎)
  • في ما يلي مزيد من التفاصيل:
    • وصف الوسيطة: نطاق
      • النطاق الذي تبحث عن الصِيَغ فيه
    • مثال للوسيطة: نطاق_البحث
      • A2:D7

الأسئلة الشائعة

هل يمكنني إنشاء نطاق نسبي في الدالة المُسمّاة؟

لا، فكل النطاقات المضمّنة في تعريفات الصِيَغ تكون مطلقة. إذا لم يتم تضمينها في التعريف بذلك التنسيق، يتم تحويلها إلى نطاقات مطلقة. على سبيل المثال، سيتم تعديل النطاق "A1:B3" عند حفظه في ورقة بيانات بالتنسيق "‎1!$A$1:$B$3‎". يمكنك ضبط النطاقات النسبية كوسيطات في الدالة المُسمّاة.

هل يمكنني استخدام أسماء الدوال المضمّنة كأسماء عناصر نائبة للوسيطات، مثلاً SUM؟

نعم. يمكنك تسمية العناصر النائبة للوسيطات بالاسم نفسه للدوال المضمّنة. على سبيل المثال، يمكنك تسمية عنصر نائب لوسيطة "SUM"، ولكن إذا تم استخدامهما معًا، سيُمنَح العنصر النائب للوسيطة الأولوية على الدالة المضمّنة.

هل يمكنني استيراد أسماء محدَّدة بدون معلَمات إلى "جداول بيانات Google"؟

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

هل يمكنني تعديل دالة مُسمّاة محدَّدة مستوردة بدون معلَمات في "جداول بيانات Google"؟

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

هل يمكنني إنشاء دالة مُسمّاة بالاسم نفسه كدالة برمجة تطبيقات مخصصة؟

لا، لا يمكنك إنشاء دالة مُسمّاة تحمل الاسم نفسه كدالة برمجة تطبيقات مخصصة حالية في ورقة البيانات. يمكنك إضافة دالة مخصصة إلى ورقة بيانات بحيث تحمل الاسم نفسه كدالة حالية مُسمّاة. ومع ذلك، ستحل الدالة المُسمّاة الحالية محلها.

تظهر لي رسالة خطأ نصها "تم الوصول إلى الحد الأقصى المسموح به للحساب أثناء محاولة حساب هذه الصيغة" للصيغة المتكررة. كيف يمكنني حلّها؟

يمكن أن يحدث ذلك في حالتَين:

  • تستغرق العملية الحسابية للصيغة وقتًا طويلاً جدًا.
  • تستهلك هذه العملية مساحة كبيرة جدًا من الذاكرة.

لحلّ المشكلة، يمكنك استخدام صيغة أبسط لخفض مستوى التعقيد.

إذا كان لكل من الدالة المُسمّاة والنطاق المُعنوَن الاسم نفسه، أيهما يُمنَح الأولوية؟

يُمنَح النطاق المُعنون الأولوية على الدالة المُسمّاة.

مراجع ذات صلة

قد تحتوي هذه الصفحة على محتوى تمت ترجمته باستخدام تكنولوجيا الذكاء الاصطناعي (AI). علمًا أنّ الترجمات المستندة إلى هذه التكنولوجيا قد تتضمن بعض الأخطاء.

هل تحتاج إلى مزيد من المساعدة؟

جرِّب الخطوات التالية:

true
الانتقال إلى "مركز التعلُّم"

هل تستخدم منتجات Google، مثل "مستندات Google"، في العمل أو في مؤسسة تعليمية؟ جرِّب النصائح والأدلة التعليمية والنماذج الفعّالة، وتعرَّف على كيفية العمل على ملفات Office بدون تثبيت Office، وإنشاء خطط مشاريع وتقاويم فِرق ديناميكية، وتنظيم بريدك الوارد تلقائيًا، وغير ذلك.

بحث
محو البحث
إغلاق البحث
القائمة الرئيسية
3438874249962005934
true
مركز مساعدة البحث
false
true
true
true
true
true
35
false
false
false
false
false