إنشاء دالة مخصصة واستدعاؤها

فيما يلي مثال بسيط على دالة مخصصة تتبع تقليد برمجة طويل الأمد.

1. لإنشاء استعلام فارغ:
   
   حدد Excel    البيانات > الحصول على البيانات > من مصادر أخرى > استعلام فارغ.
   
   Power Query    انقر بزر الماوس الأيمن فوق نقطة فارغة في جزء الاستعلامات على اليسار، ثم حدد استعلام جديد > مصادر أخرى > استعلام فارغ.

2. في جزء Queries على اليسار، انقر نقرا مزدوجا فوق الاسم، ثم أعد تسمية الاستعلام الفارغ الجديد إلى "HelloWorld".

3. حدد الاستعلام الجديد ثم حدد Home > Advanced المحرر.

4. استبدل التعليمات البرمجية لبدء القالب بالتعليمات البرمجية التالية:

   let
        HelloWorld = () => ("Hello World")
   in
        HelloWorld

5. حدد تم.

6. لقد قمت بتغيير الاستعلام ، "HelloWorld"، إلى دالة مخصصة. لاحظ أيقونة الدالة إلى يسارها.

7. لاستدعاء الدالة، حددها، ثم حدد Invoke في Data Preview.
   
   

8. يتم عرض نتائج الدالة في معاينة البيانات وإضافتها إلى جزء الاستعلامات كاستعلام بالاسم الافتراضي، الدالة التي تم استدعاؤها. قد ترغب في إعادة تسميته إلى شيء أكثر معنى، مثل "HelloWorldResult".

9. حدد هذا الاستعلام، ثم حدد الصفحة الرئيسية > إغلاق & تحميل لمشاهدة النتائج في ورقة عمل.

النتائج 

يوضح المثال التالي كيفية تمرير معلمة إلى دالة مخصصة لتحويل رقم عشري إلى رقم سداسي عشري.

1. لإنشاء استعلام فارغ:
   
   حدد Excel    البيانات > الحصول على البيانات > من مصادر أخرى > استعلام فارغ.
   
   Power Query    انقر بزر الماوس الأيمن فوق نقطة فارغة في جزء الاستعلامات على اليسار، ثم حدد استعلام جديد > مصادر أخرى > استعلام فارغ.

2. في جزء Queries على اليسار، أعد تسمية الاستعلام الفارغ الجديد إلى "MyHex".

3. حدد الاستعلام الجديد ثم حدد Home > Advanced المحرر.

4. استبدل التعليمات البرمجية لبدء القالب بالتعليمات البرمجية التالية:

   let
        MyHex = (parameter1) => Number.ToText(parameter1,"X")
   in
        MyHex

5. حدد تم.

6. لقد قمت بتغيير الاستعلام، "MyHex"، إلى دالة مخصصة. لاحظ أيقونة الدالة إلى يسارها.

7. لاستدعاء الدالة، حددها، ثم في معاينة البيانات، أدخل رقما في مربع parameter1 ، وحدد Invoke.

   

8. يتم عرض نتائج الدالة في معاينة البيانات وإضافتها إلى جزء الاستعلامات كاستعلام بالاسم الافتراضي، الدالة التي تم استدعاؤها. قد ترغب في إعادة تسميته إلى شيء أكثر معنى، مثل "MyHexResult".

9. حدد هذا الاستعلام، ثم حدد الصفحة الرئيسية > إغلاق & تحميل لمشاهدة النتائج في ورقة عمل.

النتائج 

إذا قمت بإنشاء دالة بمعلمة واحدة على الأقل، يمكنك استدعاؤها كدالة مخصصة لإنشاء عمود جديد وقيمة جديدة لكل صف في جدول.

1. لفتح استعلام، حدد موقع استعلام تم تحميله مسبقا من محرر Power Query، وحدد خلية في البيانات، ثم حدد استعلام > تحرير. لمزيد من المعلومات، راجع إنشاء استعلام وتحريره وتحميله في Excel (Power Query).
   
   ملاحظه    على سبيل المثال، يحتاج الاستعلام إلى عمود واحد على الأقل من نوع بيانات "الرقم الكامل ".

2. قم بإنشاء الدالة المخصصة "MyHex" كما هو موضح في القسم إنشاء دالة مخصصة لها معلمة مع المحرر المتقدمة واستدعائها.

3. في الاستعلام، حدد Add Column > Invoke Custom Function. يظهر مربع الحوار Invoke Custom Function .

4. أدخل اسم العمود الجديد، مثل "HexConvert"، في المربع اسم العمود الجديد .

5. حدد اسم دالة مخصصة محددة مسبقا من القائمة المنسدلة استعلام الدالة. في هذا المثال، حدد "MyHex".

6. نظرا لأن الدالة المخصصة تشير إلى معلمة، يتم عرض المعلمة الآن.

7. حدد عمودا من نوع بيانات "رقم كامل " كمعلمة للدالة.
   
   

8. حدّد موافق.

النتيجة

يتم إنشاء عمود جديد يعرض القيمة السداسية العشرية للعمود "رقم كامل" الذي أدخلته كمعلمة.