إنشاء المفردات وإدارتها لاستخدامها مع مجموعات القواعد باستخدام Microsoft Rules Composer

ينطبق على: Azure Logic Apps (قياسي)

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

يوضح هذا الدليل كيفية إنشاء المفردات التي يتم وضعها في مخزن القواعد المشتركة وتحديدها باستخدام Microsoft Rules Composer. يمكنك تحديد مصادر البيانات لاستخدامها، وإنشاء مفردات جديدة، وإضافة تعريفات المفردات. يمكنك حفظ إصدار من المفردات الخاصة بك إلى مخزن القواعد.

المتطلبات الأساسية

• قم بتنزيل Microsoft Rules Composer وتثبيته.

• ملف XML الذي يحتوي على مخزن القواعد حيث تريد إضافة مفردات.

كيف تسهل المفردات قراءة القواعد وفهمها؟

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

كمثال آخر، قد يشير متغير لحالة الموافقة إلى قيمة معينة في مخطط XML. بدلا من إدراج هذا التمثيل المعقد في قاعدة، يمكنك بدلا من ذلك إنشاء تعريف مفردات مقترن بهذه القيمة المتغيرة، واستخدام "الحالة" كاسم مألوف. يمكنك بعد ذلك استخدام "الحالة" في أي عدد من القواعد. تقع البيانات الاصطناعية التكنولوجية، مثل عناصر XML ومستندات XML، التي تنفذ شروط القاعدة وإجراءات القاعدة ضمن هذه المصطلحات الخاصة بالمجال. ومع ذلك، يمكن لمحرك القواعد استرداد البيانات المقابلة من الجدول الذي يخزن تلك البيانات.

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

إنشاء مفردات

1. افتح Microsoft Rules Composer. من قائمة مخزن القواعد، حدد تحميل.

2. ابحث عن ملف XML الذي يحتوي على مخزن القواعد الذي تريد العمل عليه وحدده.

3. في نافذة مستكشف الحقائق، حدد علامة التبويب المفردات .

4. في علامة التبويب المفردات ، ابحث عن مجلد المفردات .

5. افتح القائمة المختصرة للمجلد، وحدد إضافة مفردات جديدة.

   ينشئ Microsoft Rules Composer مفردات فارغة جديدة مع إصدار مفردات رقمي 1.0 كإصدار افتراضي.

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

يصف الجدول التالي أوامر الاختصار الأخرى التي يمكنك استخدامها للعمل مع المفردات:

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

يصف الجدول التالي أوامر الاختصار الأخرى التي يمكنك استخدامها للعمل مع إصدارات المفردات:

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

يصف الجدول التالي أوامر الاختصار الأخرى التي يمكنك استخدامها للعمل مع إصدارات المفردات:

الأمر "اختصار"	مهمة
تعديل	قم بتشغيل معالج تعريف المفردات لتغيير التعريف المحدد.
الانتقال إلى حقيقة المصدر	لتعريف المفردات المحددة، انتقل إلى حقيقة المصدر المقابلة في تجميع .NET أو مخطط XML.

الأمر "اختصار"	مهمة
حدد العقدة الجذر	من مخطط XML الذي يحتوي على عقد جذر متعددة، حدد عقدة جذر لتحميلها.

توفر الأقسام التالية المزيد من المعلومات حول هذه المهام.

نسخ إصدار مفردات

عندما تريد إجراء تغييرات في المفردات، قم بإنشاء إصدار مفردات جديد ليعكس التغييرات. يمكنك إنشاء نسخة من إصدار مفردات موجود ولكن برقم إصدار مختلف.

1. في نافذة مستكشف الحقائق، افتح القائمة المختصرة لإصدار المفردات، وحدد نسخ.

2. افتح القائمة المختصرة للمفردات، وحدد لصق إصدار مجموعة القواعد.

   ينشئ Microsoft Rules Composer إصدار مفردات جديد بنفس التعريفات مثل الإصدار المنسخ ولكن برقم مختلف.

هام

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

إنشاء إصدار مفردات فارغ

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

1. في نافذة مستكشف الحقائق، حدد علامة التبويب المفردات .

2. في علامة التبويب المفردات ، ابحث عن المفردات التي يمكن من خلالها إنشاء إصدار جديد.

3. افتح القائمة المختصرة للمفردات، وحدد إضافة إصدار جديد.

   ينشئ Microsoft Rules Composer إصدار مفردات فارغ جديد برقم مختلف.

4. افتح القائمة المختصرة لإصدار المفردات الجديد، وحدد حفظ.

يمكنك الآن نسخ تعريفات المفردات من إصدارات المفردات الأخرى، ولصقها في الإصدار الجديد.

إعادة تسمية مفردات

قبل أن تتمكن من إعادة تسمية مفردات أو مجموعة قواعد، يجب حفظ كل شيء، ما يعني جميع إصدارات تعريفات المفردات.

1. في نافذة مستكشف الحقائق، حدد علامة التبويب المفردات .

2. في علامة التبويب المفردات ، في مجلد المفردات ، ابحث عن المفردات التي تريد إعادة تسميتها.

3. حدد المفردات، وفي نافذة Properties، قم بتحرير الاسم.

إنشاء تعريف مفردات

يمكنك إنشاء تعريف مفردات كقيمة ثابتة أو نطاق من القيم أو مجموعة من القيم أو عناصر من تجميع .NET أو مستند XML. لإنشاء تعريف مفردات، يمكنك استخدام معالج تعريف المفردات.

بدلا من ذلك، يمكنك إنشاء تعريف مفردات جديد عن طريق تحديد حقيقة من علامة التبويب فئات .NET أو علامة التبويب مخططات XML، مثل أو عضو في فئة .NET- سحب الحقيقة إلى علامة التبويب المفردات .

—على سبيل المثال، عقدة XML،

إذا قمت بتحديد متغير عام، فلا تزال خيارات Get و Set متوفرة، تماما كما هو الحال في معالج تعريف XML.

إضافة قيمة ثابتة كتعريف مفردات

1. في علامة التبويب المفردات ، في مجلد المفردات .

2. في مجلد المفردات ، افتح القائمة المختصرة لإصدار المفردات الذي تريده.

3. من القائمة المختصرة لإصدار المفردات، حدد إضافة تعريف جديد.

   يمكنك أيضا سحب العناصر من علامة التبويب فئات .NET وعلامة التبويب مخططات XML.

   يتم تشغيل معالج تعريف المفردات لمساعدتك في إنشاء التعريف.

4. في المعالج، حدد القيمة الثابتة أو نطاق القيم أو مجموعة القيم، ثم حدد التالي.

5. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   اسم التعريف	اسم التعريف.
   الوصف	وصف التعريف.
   نوع التعريف	لهذه المهمة، حدد قيمة ثابتة.

6. عندما تصبح مستعداً، حدد "Next".

7. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   نوع التعريف	حدد نوع بيانات النظام للتعريف.
   ‏‫اسم العرض‬	أدخل اسما لا يتجاوز 512 حرفا.
   القيمة	أدخل قيمة للثابت.

8. عند الانتهاء، حدد إنهاء.

إضافة نطاق قيمة كتعريف مفردات

1. في علامة التبويب المفردات ، في مجلد المفردات .

2. في مجلد المفردات ، افتح القائمة المختصرة لإصدار المفردات الذي تريده.

3. من القائمة المختصرة لإصدار المفردات، حدد إضافة تعريف جديد.

   يمكنك أيضا سحب العناصر من علامة التبويب فئات .NET وعلامة التبويب مخططات XML.

   يتم تشغيل معالج تعريف المفردات لمساعدتك في إنشاء التعريف.

4. في المعالج، حدد القيمة الثابتة أو نطاق القيم أو مجموعة القيم، ثم حدد التالي.

5. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   اسم التعريف	اسم التعريف.
   الوصف	وصف التعريف.
   نوع التعريف	لهذه المهمة، حدد نطاق القيم.

6. عندما تصبح مستعداً، حدد "Next".

7. من قائمة نوع التعريف، حدد نوع بيانات النظام للتعريف.

8. ضمن الخطوة 1 - حدد اسم العرض/القيمة للنطاق المنخفض والنطاق العالي، في الجدول، حدد النطاق منخفض، ثم حدد تحرير.

   في المربع تعريف المعلمة الذي يفتح، يتوفر الخيار استخدام قيمة ثابتة فقط.

9. أدخل قيمة ثابتة لتحديد النطاق السفلي، وحدد موافق.

10. كرر الخطوات السابقة ل Range High، والتي يجب أن تتجاوز قيمة Range Low .

11. ضمن الخطوة 2 - حدد سلسلة تنسيق العرض للنطاق، في خاصية سلسلة تنسيق العرض، أدخل سلسلة تنسيق العرض. للعودة إلى سلسلة تنسيق العرض الافتراضية، حدد افتراضي.

    إشعار

    تأكد من أن سلسلة التنسيق تتضمن فهارس معلمات باستخدام أقواس متعرجة، على سبيل المثال، استخدم {0} و {1} لتكون بمثابة عناصر نائبة لمعلمات النطاق العالي والمنخفض.

    يوضح المثال التالي نموذج تعريف مفردات لمجموعة من القيم:

    

12. عندما تكون مستعداً، حدد "Finish".

إضافة مجموعة من القيم كتعريف مفردات

1. في علامة التبويب المفردات ، في مجلد المفردات .

2. في مجلد المفردات ، افتح القائمة المختصرة لإصدار المفردات الذي تريده.

3. من القائمة المختصرة لإصدار المفردات، حدد إضافة تعريف جديد.

   يمكنك أيضا سحب العناصر من علامة التبويب فئات .NET وعلامة التبويب مخططات XML.

   يتم تشغيل معالج تعريف المفردات لمساعدتك في إنشاء التعريف.

4. في المعالج، حدد القيمة الثابتة أو نطاق القيم أو مجموعة القيم، ثم حدد التالي.

5. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   اسم التعريف	اسم التعريف.
   الوصف	وصف التعريف.
   نوع التعريف	لهذه المهمة، حدد مجموعة القيم.

6. عندما تصبح مستعداً، حدد "Next".

7. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   نوع التعريف	حدد نوع بيانات النظام للتعريف.
   ‏‫اسم العرض‬	أدخل اسما لا يتجاوز 512 حرفا.

   ضمن تعريف القيم، يتوفر الخيار استخدام قيمة ثابتة فقط.

8. لإضافة عضو إلى المجموعة، أدخل قيمة ثابتة، وحدد إضافة.

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

   يوضح المثال التالي قيما متعددة في المجموعة:

   

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

11. لإزالة عضو من المجموعة، في المربع القيم ، حدد القيمة، وحدد إزالة.

12. عند إكمال المجموعة، حدد إنهاء.

إضافة فئة .NET أو عضو فئة كتعريف مفردات

قبل البدء، تأكد من وضع تجميعات .NET في دليل محلي إلى Microsoft Rules Composer. إذا قمت بتحديث تجميع .NET، فتأكد من تحديث مراجع إصدار مجموعة القواعد إلى هذا التجميع. لمزيد من المعلومات، راجع تحديث مراجع تجميع .NET.

1. في علامة التبويب المفردات ، في مجلد المفردات .

2. في مجلد المفردات ، افتح القائمة المختصرة لإصدار المفردات الذي تريده.

3. من القائمة المختصرة لإصدار المفردات، حدد إضافة تعريف جديد.

   يمكنك أيضا سحب فئة .NET أو عضو فئة من علامة التبويب فئات .NET.

   يتم تشغيل معالج تعريف المفردات لمساعدتك في إنشاء التعريف.

4. في المعالج، حدد .NET Class أو Class Member، ثم حدد Next.

5. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   اسم التعريف	اسم التعريف.
   الوصف	وصف التعريف.

6. في قسم معلومات عضو الفئة، حدد استعراض.

7. ابحث عن التجميع الذي تريده وحدده، ثم حدد فتح.

8. في المربع تحديد الربط ، قم بتوسيع عقدة التجميع.

9. حدد فئة، أو قم بتوسيع فئة وحدد أحد أعضاء الفئة، ثم حدد موافق.

10. اختر إحدى الخطوات التالية:

    • إذا حددت فئة، بالنسبة إلى اسم العرض، أدخل اسما لا يتجاوز 512 حرفا، وحدد إنهاء.

      لقد انتهيت الآن من هذا القسم.

    • إذا قمت بتحديد عضو فئة يحتوي على معلمات، فحدد التالي.

      تظهر صفحة تحديد اسم العرض - فئة .NET أو تعريف عضو الفئة لتوفير قيمة وسلسلة تنسيق العرض لكل معلمة.

      1. ضمن الخطوة 1 - حدد اسم العرض/القيمة لكل معلمة، في المربع معلمات ، حدد معلمة، ثم حدد تحرير.

      2. بالنسبة لقيمة المعلمة، يتوفر الخيار استخدام قيمة ثابتة فقط، لذا أدخل قيمة ثابتة.

      3. ضمن الخطوة 2 - حدد سلسلة تنسيق العرض، في خاصية سلسلة تنسيق العرض، أدخل سلسلة تنسيق العرض. للعودة إلى سلسلة تنسيق العرض الافتراضية، حدد افتراضي.

         إشعار

         تأكد من أن سلسلة التنسيق تتضمن فهارس معلمات باستخدام أقواس متعرجة، على سبيل المثال، استخدم {0} و {1} لتكون بمثابة عناصر نائبة للمعلمات.

      4. كرر الخطوات السابقة لكل معلمة في عضو الفئة.

         يوضح المثال التالي معلمات متعددة في عضو الفئة:

         

إنشاء تعريف مفردات من تجميع .NET

يمكنك إنشاء تعريفات المفردات من الفئات أو أعضاء الفئة في تجميع .NET لتحديد المسندات والوسيطات والإجراءات. قبل البدء، تأكد من وضع تجميعات .NET في دليل محلي إلى Microsoft Rules Composer. إذا قمت بتحديث تجميع .NET، فتأكد من تحديث مراجع إصدار مجموعة القواعد إلى هذا التجميع. لمزيد من المعلومات، راجع تحديث مراجع تجميع .NET.

1. في نافذة مستكشف الحقائق، حدد علامة التبويب فئات .NET.

2. من ضمن تجميعات .NET، اسحب عضو فئة أو فئة إلى تعريف مفردات موجود، والذي يظهر في علامة التبويب المفردات .

إنشاء تعريف مفردات من عنصر مستند XML أو سمة

يمكنك إنشاء تعريفات المفردات من عناصر وسمات XML من خلال الاستعراض عبر مخططات XSD وسحب العناصر إلى محرر الشروط أو محرر الإجراءات لتحديد المسندات والوسيطات والإجراءات.

1. في علامة التبويب المفردات ، في مجلد المفردات .

2. في مجلد المفردات ، افتح القائمة المختصرة لإصدار المفردات الذي تريده.

3. من القائمة المختصرة لإصدار المفردات، حدد إضافة تعريف جديد.

   يتم تشغيل معالج تعريف المفردات لمساعدتك في إنشاء التعريف.

4. في المعالج، حدد XML Document Element أو Attribute، ثم حدد Next.

5. وفر المعلومات التالية:

   الخاصية	‏‏الوصف
   اسم التعريف	اسم التعريف.
   الوصف	وصف التعريف.

6. في قسم معلومات مستند XML، حدد استعراض.

7. ابحث عن ملف مخطط (.xsd) وحدده، وحدد عنصر مستند أو سمة.

8. من قائمة النوع، حدد نوعا متوافقا مع نوع العنصر أو السمة المحددة من المخطط.

   إشعار

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

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

9. في قسم تحديد العملية ، حدد نوع العملية الذي يشير إلى ما إذا كنت تخطط للحصول على قيمة العنصر أو السمة أو تعيين القيمة.

10. إذا اخترت تعيين القيمة، فحدد التالي، وحدد تنسيق العرض.

    تظهر صفحة تحديد اسم العرض - عنصر مستند XML أو السمة لتوفير قيمة وعرض سلسلة تنسيق لاستخدامها.

    1. ضمن الخطوة 1 - حدد اسم العرض/القيمة لكل معلمة، في المربع معلمات ، حدد معلمة، ثم حدد تحرير.

    2. بالنسبة لقيمة المعلمة، يتوفر الخيار استخدام قيمة ثابتة فقط، لذا أدخل قيمة ثابتة.

    3. ضمن الخطوة 2 - حدد سلسلة تنسيق العرض، في خاصية سلسلة تنسيق العرض، أدخل سلسلة تنسيق العرض. للعودة إلى سلسلة تنسيق العرض الافتراضية، حدد افتراضي.

       إشعار

       تأكد من أن سلسلة التنسيق تتضمن فهارس معلمات باستخدام أقواس متعرجة، على سبيل المثال، استخدم {0} و {1} لتكون بمثابة عناصر نائبة للمعلمات.

11. عند الانتهاء، حدد إنهاء.

    يوضح المثال التالي تفاصيل تعريف المفردات استنادا إلى عنصر مستند XML أو سمة:

    

    عند إنشاء تعريفات المفردات لعقد XML، فإن تعبيرات XPath للروابط لها قيم افتراضية مماثلة، استنادا إلى القواعد الموضحة سابقا. ومع ذلك، يمكنك تحرير هذه القيم في معالج تعريف المفردات. يتم وضع التغييرات على التعبيرات في تعريف المفردات وتنعكس في أي وسيطات قاعدة تقوم ببناءها من تعريفات المفردات.

المحتوى ذو الصلة

• إنشاء قواعد باستخدام Microsoft Rules Composer
• اختبار مجموعات القواعد الخاصة بك
• إنشاء مشروع Azure Logic Apps Rules Engine