المقدمة
يوضح هذا المستند كيفية إستخدام وحدات الماكرو لإرجاع البيانات من نظام بتنسيقات مختلفة. وهي لا تقوم فقط باختبار الشروط وتعيين البيانات من إدخال واجهة المستخدم الرسومية (GUI) أو أداة التحميل المجمعة إلى عناصر مختلفة في النظام (بالاقتران مع قوالب التكوين) ولكنها تستخدم أيضا للوصول إلى البيانات في خطوات سير العمل والمعالج.
المتطلبات الأساسية
المتطلبات
لا توجد متطلبات خاصة لهذا المستند.
المكونات المستخدمة
تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:
- Cisco Unified Communications Domain Manager (Unified CDM) 10.6.x
- مديرو الاتصالات الموحدة من Cisco (CUCM) 10.5.2 أو إصدار أحدث
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك مباشرة، فتأكد من فهمك للتأثير المحتمل لأي أمر.
ما هو النموذج الذي يدعم وحدات الماكرو؟
بصفة عامة، تستخدم جميع نماذج آلية التنمية النظيفة الموحدة من Cisco وحدات ماكرو ضمن مسارات عملها. يمكن تغيير أي قالب تكوين (CFT) أو سياسة عرض الميزات (FDP)، وما إلى ذلك والمتوفرة بالفعل في حساب مسؤول حل التعاون المستضاف (HCS) أو مسؤول الموفر في نظام الإنتاج، وهذا يتضمن إستخدام وحدات الماكرو في FDP/CFT هذه. يمكن نسخ عمليات النسخ الاحتياطي للأشرطة (CFTs) من sys إلى sys.hcs.provider وتعديلها للوفاء بمتطلبات العميل.يتم فقد أية تغييرات تم إجراؤها دون إنشاء النسخ في تسلسل هيكلي أقل أثناء الترقية.
لا يقبل كل نموذج إدخال وحدات الماكرو من خلال API/ أوراق التحميل المجمعة إلا إذا تم تحديد قيمة CFT على أنها fn.evaluation، حيث تقوم CFT بعد ذلك بتقييم الماكرو واستخدام القيمة. علاوة على ذلك، يمكن للعميل تنفيذ ماكرو بالتقييم أو بدونه لتلبية متطلبات العميل
مثال التكوين: حقل CFT بدون تقييم ماكرو الحقل
- تسجيل الدخول كمستخدم hcsadmin
- قطع الخبز إلى التسلسل الهرمي لموفرك
- كما هو موضح في الصورة، انتقل إلى مدير الدور > قالب التكوين ثم ابحث عن قالب CFT الذي يحتاج إلى تخصيص
- كما هو موضح في الصورة، حدد CFT وانسخ ذلك حتى يظهر في مستوى الموفر
- فتح CFT الجديد
- الآن كما هو موضح في الصورة، أضف ماكرو دون تقييم. في المثال، يتم تطبيق ماكرو في اسم دليل LDAP
في هذا السيناريو، يتم تقييم الحقل ببساطة على أساس محتويات الماكرو. على سبيل المثال، اسم دليل LDAP في قالب مستخدم Cisco Unified Communications Manager (CUCM) CFT: {{ macro.HcsDpCustomerName }}-LDAP، فإنه يأخذ حقل CustomerName من مجموعة BaseCustomerDAT المناسبة (HcsDpCustomerName) ويضبط -LDAP عليه بغض النظر عما يتم تمريره في سياق الإدخال (من API/Bulk) لهذا الحقل.
مثال التكوين: حقل CFT مع تقييم ماكرو الحقل
يتم إدخال تقييم الماكرو من خلال أوراق تحميل API/ الكميات الكبيرة، ويتم دعمه من قبل حقول معينة ضمن معظم CFT. وعلاوة على ذلك، لا يتم دعم هذا التقييم إلا إذا تضمنت سمة CFT fn.evaluation المضمنة في سياق الإدخال.
على سبيل المثال، يدعم حقل الوصف ل HcsCucPartitionCFT من قائمة XLS المحولة برمجيا تقييم الأمر fn.evaluation يتم تمريره في إختبار الإدخال.
في هذه الحالة، يقوم مستدعي API بملء هذا الحقل بماكرو مضمن مثل: وصف {{ input.PartitionItem.description }}؛ مما ينتج عنه قيمة وصف ل ThisExamplePartitionItem بافتراض PartitionItem.description == "ThisExamplePartitionName".
بدون fn.evaluation المضمنة (الجزء المهم في دعم وحدات الماكرو المضمنة)، يتم حل حقل القيمة ببساطة كما هو موضح في الأصل — وصف {{ input.PartitionItem.description }}.
في المثال السابق، إذا كان المرء يريد تمكين التقييم في حقل "الاسم"، سيكون من الضروري تعديل الماكرو في {{ fn.evaluation input.PartitionName.Data }}.
تعرض هذه الصورة قائمة (قوائم) CFT وسماتها مع ماكرو التقييم الذي تم تمكينه بالفعل.
كيف يتم التحقق من وظيفة الماكرو بشكل صحيح؟
- تسجيل الدخول ك sysadmin
- تشغيل تقييم الماكرو
يمكن إستخدام تقييم الماكرو لتقييم وحدات الماكرو أثناء تنفيذ الماكرو إلى التدرج الهرمي الصحيح. على سبيل المثال، يظهر ماكرو الهاتف على مستوى الموقع الهواتف المزودة في الموقع، كما هو موضح في الصورة.