سيسكو إنشاء مهام سير العمل المخصصة

حول مدخلات سير العمل المخصصة

يقدم Cisco UCS Director Orchestrator قائمة بأنواع الإدخال المحددة جيدًا للمهام المخصصة. يمكّنك Cisco UCS Director أيضًا من إنشاء إدخال سير عمل مخصص لمهمة سير عمل مخصصة. يمكنك إنشاء نوع إدخال جديد عن طريق استنساخ نوع إدخال موجود وتعديله.

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

قبل كتابة المهام المخصصة، يجب أن تستوفي المتطلبات الأساسية التالية:

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

إنشاء إدخال سير عمل مخصص

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

• خطوة 1 اختر التنسيق.
• خطوة 2 انقر فوق مدخلات سير العمل المخصصة.
• خطوة 3 انقر فوق إضافة.
• خطوة 4 في شاشة إضافة إدخال CustomWorkflow، أكمل الحقول التالية:
  • اسم نوع الإدخال المخصص - اسم فريد لنوع الإدخال المخصص.
  • نوع الإدخال - حدد نوع الإدخال وانقر فوق تحديد. بناءً على الإدخال المحدد، تظهر الحقول الأخرى. على سبيل المثالample، عندما تختار عنوان البريد الإلكتروني كنوع الإدخال، تظهر قائمة القيم (LOV). استخدم الحقول الجديدة لتحديد قيم الإدخال المخصص.
• الخطوة 5 انقر فوق إرسال.
• تتم إضافة إدخال سير العمل المخصص إلى Cisco UCS Director ويكون متاحًا في قائمة أنواع الإدخال.

التحقق من صحة الإدخال المخصص

قد يحتاج العملاء إلى التحقق من صحة مدخلات سير العمل باستخدام موارد خارجية. خارج الصندوق، لا يستطيع Cisco UCS Director تلبية احتياجات التحقق من صحة كل عميل. لسد هذه الفجوة، يوفر Cisco UCS Director خيارًا للتحقق من صحة أي إدخال في وقت التشغيل باستخدام برنامج نصي يقدمه العميل. يمكن للبرنامج النصي الإبلاغ عن الأخطاء في الإدخال ويمكن أن يتطلب إدخالاً صالحًا قبل تشغيل طلب الخدمة. يمكن كتابة البرنامج النصي بأي لغة، ويمكنه الوصول إلى أي مورد خارجي، كما يمكنه الوصول إلى جميع قيم إدخال سير العمل.
يمكنك كتابة برامج نصية مخصصة للتحقق باستخدام JavaScript، أو Python، أو برنامج bash Shell النصي، أو أي لغة برمجة نصية أخرى.

المثال التاليampيمكن العثور على البرامج النصية للتحقق من الصحة في Cisco UCS Director في Orchestration > Custom Workflow Inputs:

• Example-bash-script-validator
• Example-javascript-validator
• Example-python-validator

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

بغض النظر عن لغة البرمجة النصية، تنطبق الميزات والقواعد التالية على التحقق من صحة الإدخال المخصص المكتوب:

• يتم تشغيل كافة عمليات التحقق المكتوبة في عملية منفصلة، ​​بحيث لا تؤثر عملية التحقق الفاشلة على عملية Cisco UCS Director.
• يمكن التحقق من صحة مدخلات النص العامة فقط باستخدام البرامج النصية.
• يتم تشغيل البرامج النصية للتحقق من الصحة واحدًا تلو الآخر، بالتسلسل، وبنفس الترتيب الذي تظهر به المدخلات في صفحة مدخلات سير العمل. يتم إطلاق عملية منفصلة لكل إدخال تم التحقق من صحته.
• تشير قيمة الإرجاع غير الصفرية من البرنامج النصي إلى فشل التحقق من الصحة. اختياريًا، يمكنك تمرير رسالة خطأ مرة أخرى إلى نموذج إدخال سير العمل.
• يتم تمرير كافة مدخلات سير العمل إلى البرنامج النصي للتحقق بطريقتين:
  • كوسائط للبرنامج النصي في شكل "مفتاح" = "قيمة".
  • كمتغيرات البيئة لعملية البرنامج النصي. أسماء المتغيرات هي تسميات الإدخال.
    على سبيل المثالample، إذا كان سير العمل يحتوي على إدخال يسمى رمز المنتج وكانت قيمة الإدخال هي AbC123، فسيتم تمرير المتغير إلى البرنامج النصي لأداة التحقق باسم "رمز المنتج" = "AbC123".
    يمكن استخدام متغيرات الإدخال هذه بواسطة البرنامج النصي إذا لزم الأمر لتنفيذ التحقق من الصحة. الاستثناء: تحتوي قيم الجدول فقط على رقم الصف الخاص بتحديد الجدول، وبالتالي من المحتمل أن تكون غير مفيدة.
• تجعل صفحة تحرير إدخال سير العمل المخصص البرنامج النصي متاحًا في محرر المهام المخصصة. يتم تمييز بناء الجملة لجميع اللغات. يتم التحقق من أخطاء بناء الجملة فقط لمدققي JavaScript.

استنساخ إدخال سير العمل المخصص

يمكنك استخدام إدخال سير عمل مخصص موجود في Cisco UCS Director لإنشاء إدخال سير عمل مخصص.

قبل أن تبدأ
يجب أن يكون إدخال سير العمل المخصص متاحًا في Cisco UCS Director.

• خطوة 1 اختر التنسيق.
• خطوة 2 انقر فوق مدخلات سير العمل المخصصة.
• خطوة 3 انقر فوق الصف الذي يحتوي على إدخال سير العمل المخصص المراد استنساخه.
  يظهر رمز الاستنساخ أعلى جدول إدخالات سير العمل المخصص.
• خطوة 4 انقر فوق استنساخ.
• خطوة 5 أدخل اسم نوع الإدخال المخصص.
• خطوة 6 استخدم عناصر التحكم الأخرى في شاشة Clone Custom Workflow Input لتخصيص الإدخال الجديد.
• خطوة 7 انقر فوق إرسال.
  يتم استنساخ إدخال مهمة سير العمل المخصص بعد التأكيد ويكون متاحًا للاستخدام في مهمة سير العمل المخصصة.

إنشاء مهمة مخصصة

لإنشاء مهمة مخصصة، قم بما يلي:

• خطوة 1 اختر التنسيق.
• خطوة 2 انقر فوق مهام سير العمل المخصصة.
• خطوة 3 انقر فوق إضافة.
• خطوة 4 في شاشة إضافة مهمة سير عمل مخصصة، أكمل الحقول التالية:
  • حقل اسم المهمة - اسم فريد لمهمة سير العمل المخصصة.
  • حقل تسمية المهمة - تسمية لتحديد مهمة سير العمل المخصصة.
  • حقل التسجيل ضمن الفئة - فئة سير العمل التي يجب تسجيل مهمة سير العمل المخصصة ضمنها.
  • خانة الاختيار تنشيط المهمة - إذا تم تحديدها، فسيتم تسجيل مهمة سير العمل المخصصة في Orchestrator ويمكن استخدامها على الفور في مهام سير العمل.
  • حقل الوصف الموجز - وصف لمهمة سير العمل المخصصة.
  • حقل الوصف التفصيلي - وصف تفصيلي لمهمة سير العمل المخصصة.
• خطوة 5 انقر فوق التالي.
  تظهر شاشة إدخالات المهام المخصصة.
• خطوة 6 انقر فوق إضافة.
• خطوة 7 في شاشة إضافة إدخال إلى المدخلات، أكمل الحقول التالية:
  • حقل اسم حقل الإدخال - اسم فريد للحقل. يجب أن يبدأ الاسم بحرف أبجدي ويجب ألا يحتوي على مسافات أو أحرف خاصة.
  • حقل تسمية حقل الإدخال - تسمية لتحديد حقل الإدخال.
  • القائمة المنسدلة لنوع حقل الإدخال - اختر نوع بيانات معلمة الإدخال.
  • حقل التعيين إلى نوع الإدخال (بدون تعيين) - اختر نوع الإدخال الذي يمكن تعيين هذا الحقل إليه، إذا كان هذا الحقل يمكن تعيينه من مخرجات مهمة أخرى أو إدخال سير العمل العام.
  • خانة الاختيار الإلزامية — في حالة تحديدها، يجب على المستخدم توفير قيمة لهذا الحقل.
  • حقل RBID - أدخل سلسلة RBID للحقل.
  • القائمة المنسدلة لحجم حقل الإدخال - اختر حجم الحقل للمدخلات النصية والجدولية.
  • حقل تعليمات حقل الإدخال - (اختياري) وصف يظهر عند تحريك الماوس فوق الحقل.
  • حقل التعليق التوضيحي لحقل الإدخال - (اختياري) نص تلميح لحقل الإدخال.
  • حقل اسم مجموعة الحقول - إذا تم تحديده، فسيتم وضع كافة الحقول ذات أسماء المجموعات المتطابقة في مجموعة الحقول.
  • منطقة سمات حقل النص - أكمل الحقول التالية عندما يكون نوع حقل الإدخال نصًا.
  • خانة اختيار الإدخال المتعدد - إذا تم تحديدها، فإن حقل الإدخال يقبل قيمًا متعددة بناءً على نوع حقل الإدخال:
  • بالنسبة لقائمة القيم - يقبل حقل الإدخال قيم إدخال متعددة.
  • بالنسبة لحقل النص - يصبح حقل الإدخال حقل نص متعدد الأسطر.
  • الحد الأقصى لطول حقل الإدخال - حدد الحد الأقصى لعدد الأحرف التي يمكنك إدخالها في حقل الإدخال.
  • منطقة سمات قائمة القيم - أكمل الحقول التالية عندما يكون نوع الإدخال هو قائمة القيم (LOV) أو قائمة القيم مع أزرار الاختيار.
  • حقل قائمة القيم - قائمة قيم مفصولة بفواصل لقوائم القيم المضمنة.
    حقل اسم موفر قائمة القيم - اسم موفر قائمة القيم لقوائم القيم غير المضمنة.
  • منطقة سمات الجدول - أكمل الحقول التالية عندما يكون نوع حقل الإدخال هو جدول، أو جدول منبثق، أو جدول مع خانة الاختيار.
  • حقل اسم الجدول - اسم التقرير الجدولي لأنواع حقول الجدول.
  • منطقة التحقق من صحة إدخال الحقل - يتم عرض واحد أو أكثر من الحقول التالية وفقًا لنوع البيانات المحدد. أكمل الحقول لتحديد كيفية التحقق من صحة حقول الإدخال.
  • القائمة المنسدلة لمدقق الإدخال - اختر أداة التحقق من صحة إدخال المستخدم.
  • حقل التعبير العادي - نمط تعبير عادي لمطابقة القيمة المدخلة معه.
  • حقل رسالة التعبير العادي - رسالة يتم عرضها عند فشل التحقق من صحة التعبير العادي.
  • حقل الحد الأدنى للقيمة - الحد الأدنى للقيمة الرقمية.
  • حقل القيمة القصوى - الحد الأقصى للقيمة الرقمية.
  • إخفاء منطقة حالة الحقل - أكمل الحقول التالية لتعيين الشرط لإخفاء الحقل في النموذج.
  • إخفاء حقل اسم الحقل - اسم داخلي للحقل حتى يتمكن البرنامج الذي يتعامل مع النموذج من تعريف الحقل.
  • إخفاء حقل قيمة الحقل - القيمة التي يجب إرسالها بمجرد إرسال النموذج.
  • إخفاء القائمة المنسدلة لحالة الحقل - اختر الشرط الذي يجب إخفاء الحقل عنده.
  • حقل تعليمات HTML - تعليمات التعليمات الخاصة بالحقل المخفي.
• خطوة 8 انقر فوق إرسال.
  تتم إضافة إدخال الإدخال إلى الجدول.
• خطوة 9 انقر فوق "إضافة" لإضافة المزيد من الإدخالات إلى المدخلات.
• خطوة 10 عند الانتهاء من إضافة المدخلات، انقر فوق التالي.
  تظهر شاشة مخرجات مهام سير العمل المخصصة.
• خطوة 11 انقر فوق إضافة.
• خطوة 12 في شاشة إضافة إدخال إلى المخرجات، أكمل الحقول التالية:
  • حقل اسم حقل الإخراج - اسم فريد لحقل الإخراج. ويجب أن يبدأ بحرف أبجدي ويجب ألا يحتوي على مسافات أو أحرف خاصة.
  • حقل وصف حقل الإخراج - وصف لحقل الإخراج.
  • حقل نوع حقل الإخراج - التحقق من نوع الإخراج. يحدد هذا النوع كيفية تعيين المخرجات لمدخلات المهام الأخرى.
• خطوة 13 انقر فوق إرسال.
  تتم إضافة إدخال الإخراج إلى الجدول.
• خطوة 14 انقر فوق "إضافة" لإضافة المزيد من الإدخال إلى المخرجات.
• خطوة 15 انقر فوق التالي
  تظهر شاشة وحدة التحكم
• خطوة 16 (اختياري) انقر فوق "إضافة" لإضافة وحدة تحكم.
• خطوة 17 في شاشة إضافة إدخال إلى وحدة التحكم، أكمل الحقول التالية:
  • القائمة المنسدلة للطريقة - اختر إما طريقة التنظيم أو إلغاء التنظيم لتخصيص المدخلات و/أو المخرجات لمهمة سير العمل المخصصة. يمكن أن تكون الطريقة واحدة مما يلي:
  • قبل Marshall - استخدم هذه الطريقة لإضافة حقل إدخال أو تعيينه وإنشاء قائمة القيم وتعيينها ديناميكيًا على صفحة (نموذج).
  • بعد مارشال - استخدم هذه الطريقة لإخفاء حقل الإدخال أو إظهاره.
  • قبل Unmarshall - استخدم هذه الطريقة لتحويل قيمة إدخال من نموذج إلى نموذج آخر - على سبيل المثالample، عندما تريد تشفير كلمة المرور قبل إرسالها إلى قاعدة البيانات.
  • بعد Unmarshall - استخدم هذه الطريقة للتحقق من صحة إدخال المستخدم وتعيين رسالة الخطأ على الصفحة.
    انظر على سبيل المثالampعلى: استخدام وحدات التحكم، في الصفحة 14.
  • منطقة نص البرنامج النصي - بالنسبة للطريقة التي اخترتها من القائمة المنسدلة "الطريقة"، قم بإضافة التعليمات البرمجية الخاصة بالبرنامج النصي لتخصيص واجهة المستخدم الرسومية.
    ملحوظة انقر فوق "إضافة" إذا كنت تريد إضافة رمز لمزيد من الطرق.
    إذا كانت هناك أي عمليات تحقق من صحة كلمات المرور التي تم إدخالها، فتأكد من تغيير التحقق من صحة وحدة التحكم لكلمات المرور حتى تتمكن من تحرير المهام المخصصة في سير العمل.
    ملحوظة
• خطوة 18 انقر فوق إرسال.
  تتم إضافة وحدة التحكم إلى الجدول.
• خطوة 19 انقر فوق التالي.
  تظهر شاشة البرنامج النصي.
• خطوة 20 من القائمة المنسدلة لغة التنفيذ، اختر لغة.
• خطوة 21 في حقل البرنامج النصي، أدخل رمز CloupiaScript لمهمة سير العمل المخصصة.
  يتم التحقق من صحة رمز Cloupia Script عند إدخال الرمز. إذا كان هناك أي خطأ في الكود، فسيتم عرض أيقونة خطأ (علامة حمراء) بجوار رقم السطر. قم بتمرير الماوس فوق رمز الخطأ إلى view رسالة الخطأ والحل
• خطوة 22 انقر فوق "حفظ البرنامج النصي".
• خطوة 23 انقر فوق إرسال.
  يتم إنشاء مهمة سير العمل المخصصة وتكون متاحة للاستخدام في سير العمل

المهام والمستودعات المخصصة

عندما تقوم بإنشاء مهمة مخصصة، بدلاً من كتابة رمز المهمة المخصص في نافذة البرنامج النصي أو قص التعليمات البرمجية ولصقها من محرر نص، يمكنك استيراد التعليمات البرمجية من ملف file المخزنة في مستودع GitHub أو BitBucket. للقيام بذلك، عليك:

1. قم بإنشاء نص واحد أو أكثر fileموجود في مستودع GitHub أو BitBucket، إما في github.com أو مستودع GitHub لمؤسسة خاصة.
   ملاحظة: يدعم Cisco UCS Director GitHub فقط (github.com أو مثيل GitHub للمؤسسة) و/أو BitBucket. ولا يدعم خدمات استضافة Git الأخرى بما في ذلك GitLab أو Perforce أو Codebase.
2. قم بتسجيل المستودع في Cisco UCS Director. راجع إضافة مستودع GitHub أو BitBucket في Cisco UCS Director، في الصفحة 7.
3. حدد المستودع وحدد النص file الذي يحتوي على البرنامج النصي للمهمة المخصصة. راجع تنزيل رمز البرنامج النصي للمهام المخصصة من مستودع GitHub أو BitBucket، في الصفحة 8.

إضافة مستودع GitHub أو BitBucket في مدير Cisco UCS
لتسجيل مستودع GitHub أو BitBucket في Cisco UCS Director، قم بما يلي:

قبل أن تبدأ
قم بإنشاء مستودع GitHub أو BitBucket. يمكن أن يكون المستودع موجودًا على أي خادم GitHub أو BitBucket، سواء كان عامًا أو خاصًا، ويمكن الوصول إليه من مدير Cisco UCS الخاص بك.
تحقق في واحد أو أكثر fileتحتوي على تعليمات برمجية JavaScript لمهامك المخصصة في مستودعك.

• خطوة 1 اختر الإدارة > التكامل.
• خطوة 2 في صفحة التكامل، انقر فوق إدارة المستودعات.
• خطوة 3 انقر فوق إضافة.
• خطوة 4. في صفحة إضافة مستودع، أكمل الحقول المطلوبة، بما في ذلك ما يلي:
  • في الحقل "الاسم المستعار للمستودع"، أدخل اسمًا لتعريف المستودع داخل Cisco UCS Director.
  • في المستودع URL أدخل الحقل URL من مستودع GitHub أو BitBucket.
  • في حقل اسم الفرع، أدخل اسم فرع المستودع الذي تريد استخدامه. الاسم الافتراضي هو الفرع الرئيسي.
  • في حقل مستخدم المستودع، أدخل اسم المستخدم لحساب GitHub أو BitBucket الخاص بك.
  • لإضافة مستودع GitHub، في حقل كلمة المرور/رمز واجهة برمجة التطبيقات (API Token)، أدخل رمز واجهة برمجة التطبيقات (API) الذي تم إنشاؤه لـ GitHub الخاص بك.
    لإنشاء رمز API المميز باستخدام GitHub، انقر فوق الإعدادات وانتقل إلى إعداد المطور > رموز الوصول الشخصية، وانقر فوق إنشاء رمز مميز جديد.
    لملاحظة إضافة مستودع BitBucket، في حقل كلمة المرور/رمز API، أدخل كلمة المرور الخاصة بـ BitBucket.
  • لتعيين هذا المستودع بشكل افتراضي عند إنشاء مهمة مخصصة جديدة، حدد جعل هذا المستودع هو المستودع الافتراضي.
  • لاختبار ما إذا كان بإمكان Cisco UCS Director الوصول إلى المستودع، انقر فوق اختبار الاتصال.
    يتم عرض حالة الاتصال بالمستودع في لافتة أعلى الصفحة.
    إذا لم تتمكن من الاتصال والتواصل مع مستودع GitHub أو BitBucket من Cisco UCS
    أيها المدير، قم بتحديث Cisco UCS Director للوصول إلى الإنترنت من خلال خادم وكيل. راجع دليل إدارة مدير Cisco UCS.
    ملحوظة
• خطوة 5 عندما تقتنع بصحة معلومات المستودع، انقر فوق إرسال.

تنزيل رمز البرنامج النصي للمهام المخصصة من مستودع GitHub أو BitBucket

لإنشاء مهمة مخصصة جديدة عن طريق استيراد نص من مستودع GitHub أو BitBucket، قم بما يلي:

قبل أن تبدأ
قم بإنشاء مستودع GitHub أو BitBucket وتحقق من نص واحد أو أكثر fileتحتوي على كود JavaScript لمهامك المخصصة في مستودعك.

أضف مستودع GitHub إلى Cisco UCS Director. راجع إضافة مستودع GitHub أو BitBucket في Cisco UCS Director، على الصفحة

• خطوة 1 في صفحة التزامن، انقر فوق مهام سير العمل المخصصة.
• خطوة 2 انقر فوق إضافة.
• خطوة 3 أكمل الحقول المطلوبة في صفحة معلومات المهمة المخصصة. راجع إنشاء مهمة مخصصة، في الصفحة 3.
• خطوة 4 أكمل الحقول المطلوبة في صفحة "مدخلات المهام المخصصة". راجع إنشاء مهمة مخصصة، في الصفحة 3.
• خطوة 5 أكمل الحقول المطلوبة في صفحة "مخرجات المهام المخصصة". راجع إنشاء مهمة مخصصة، في الصفحة 3.
• خطوة 6 أكمل الحقول المطلوبة في صفحة وحدة التحكم. راجع إنشاء مهمة مخصصة، في الصفحة 3.
• خطوة 7 في صفحة البرنامج النصي، أكمل الحقول المطلوبة:
  • من القائمة المنسدلة لغة التنفيذ، حدد JavaScript.
  • حدد استخدام المستودع للبرامج النصية لتمكين المهمة المخصصة لاستخدام البرنامج النصي file من مستودع. يمكّنك هذا من تحديد المستودع وتحديد البرنامج النصي file للاستخدام.
  • من القائمة المنسدلة تحديد المستودع، حدد مستودع GitHub أو BitBucket الذي يحتوي على البرنامج النصي fileس. للحصول على تفاصيل حول كيفية إضافة المستودعات، راجع إضافة مستودع GitHub أو BitBucket في Cisco UCS Director، في الصفحة 7.
  • أدخل المسار الكامل للبرنامج النصي file في البرنامج النصي fileحقل نص الاسم.
  • لتنزيل البرنامج النصي، انقر فوق تحميل البرنامج النصي.
    النص من file يتم نسخه في منطقة تحرير نص البرنامج النصي.
  • اختياريًا، قم بإجراء تغييرات على البرنامج النصي الذي تم تنزيله في منطقة تحرير نص البرنامج النصي.
  • لحفظ البرنامج النصي كما يظهر في منطقة تحرير نص البرنامج النصي، انقر فوق Save Script.
    عند الضغط على Save Script، يتم حفظ البرنامج النصي في جلسة العمل الحالية. يجب عليك النقر فوق "إرسال" لحفظ البرنامج النصي في المهمة المخصصة التي تقوم بتحريرها.
    ملحوظة
• خطوة 8 لحفظ المهمة المخصصة، انقر فوق إرسال.
  إذا قمت بإجراء تغييرات على البرنامج النصي الذي تم تنزيله في منطقة تحرير نص البرنامج النصي، فسيتم حفظ التغييرات في المهمة المخصصة. لا يتم حفظ أي تغييرات في مستودع GitHub أو BitBucket. إذا كنت ترغب في تجاهل البرنامج النصي الذي تم تحميله وإدخال البرنامج النصي الخاص بك، فانقر فوق تجاهل البرنامج النصي لمسح نافذة البرنامج النصي.

ماذا تفعل بعد ذلك
يمكنك استخدام المهمة المخصصة الجديدة في سير العمل.

استيراد مهام سير العمل والمهام المخصصة ووحدات البرنامج النصي والأنشطة

لاستيراد العناصر إلى Cisco UCS Director، قم بما يلي:

ملحوظة سيتم استيراد المتغيرات العامة المرتبطة بسير العمل أثناء استيراد سير العمل إذا لم يكن المتغير العام متوفرًا في الجهاز.

• خطوة 1 اختر التنسيق.
• خطوة 2 في صفحة التنسيق، انقر فوق مسارات العمل.
• خطوة 3 انقر فوق استيراد.
• خطوة 4 في شاشة الاستيراد، انقر فوق تحديد أ File.
• خطوة 5 على الاختيار File لتحميل الشاشة، اختر file ليتم استيرادها. مدير الاستيراد والتصدير في Cisco UCS fileلديك ملف .wfdx file امتداد.
• خطوة 6 انقر فوق فتح.
  عندما file تم تحميلها، File تظهر شاشة التحميل/التحقق File جاهزة للاستخدام والمفتاح.
• خطوة 7 أدخل المفتاح الذي تم إدخاله عند تصدير الملف file.
• خطوة 8 انقر فوق التالي.
  تعرض شاشة سياسات الاستيراد قائمة بكائنات Cisco UCS Director الموجودة في الملف الذي تم تحميله file.
• خطوة 9 (اختياري) في شاشة سياسات الاستيراد، حدد كيفية التعامل مع الكائنات إذا كانت أسماء مكررة موجودة بالفعل في مجلد سير العمل. في شاشة الاستيراد، أكمل الحقول التالية

• خطوة 10 انقر فوق استيراد.

تصدير سير العمل والمهام المخصصة ووحدات البرنامج النصي والأنشطة

لتصدير العناصر من Cisco UCS Director، قم بما يلي:

ملاحظة: سيتم تصدير المتغيرات العامة المرتبطة بسير العمل تلقائيًا أثناء تصدير سير العمل.

• خطوة 1 انقر فوق تصدير.
• خطوة 2 في شاشة تحديد مهام سير العمل، اختر مهام سير العمل التي تريد تصديرها.
  قد يفشل استيراد مسارات العمل والمهام والبرامج النصية المخصصة التي تم إنشاؤها في Cisco UCS Director قبل الإصدار 6.6 إذا كانت تحتوي على بيانات XML.
  ملحوظة
• خطوة 3 انقر فوق التالي.
• خطوة 4 في شاشة تحديد المهام المخصصة، اختر المهام المخصصة التي تريد عرضها
  ملاحظة: تحتوي المهمة المخصصة التي تم تصديرها على كافة المدخلات المخصصة التي تستخدمها هذه المهمة المخصصة.
• خطوة 5 انقر فوق التالي.
• خطوة 6 في شاشة التصدير: تحديد وحدات البرامج النصية، اختر وحدات البرامج النصية التي تريد تصديرها.
• خطوة 7 انقر فوق التالي.
• خطوة 8 في شاشة التصدير: تحديد الأنشطة، اختر الأنشطة التي تريد تصديرها.
• خطوة 9 انقر فوق التالي.
• خطوة 10 في شاشة التصدير: حدد فتح واجهات برمجة التطبيقات، واختر واجهات برمجة التطبيقات التي تريد تصديرها.
• خطوة 11 في شاشة التصدير: التأكيد، أكمل الحقول التالية:

• خطوة 12 انقر فوق تصدير.
  تتم مطالبتك بحفظ file.

استنساخ مهمة سير عمل مخصصة من مكتبة المهام

يمكنك استنساخ المهام في مكتبة المهام لاستخدامها في إنشاء مهام مخصصة. يمكنك أيضًا استنساخ مهمة مخصصة لإنشاء مهمة مخصصة.

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

لاحظ أيضًا أن قيم التحديد لمدخلات القائمة، مثل القوائم المنسدلة وقوائم القيم، يتم ترحيلها إلى المهمة المستنسخة فقط إذا كانت قيم القائمة لا تعتمد على النظام. أشياء مثل الأسماء وعناوين IP للأنظمة الحالية تعتمد على النظام؛ أشياء مثل خيارات التكوين التي يدعمها Cisco UCS Director ليست كذلك. على سبيل المثالampتعتمد مجموعات المستخدمين وأسماء السحابة ومجموعات المنافذ على النظام؛ أدوار المستخدم وأنواع السحابة وأنواع مجموعة المنافذ ليست كذلك.

• خطوة 1 اختر التنسيق.
• خطوة 2 انقر فوق مهام سير العمل المخصصة.
• خطوة 3 انقر فوق "استنساخ من مكتبة المهام".
• خطوة 4 في شاشة "الاستنساخ من مكتبة المهام"، حدد الصف الذي يحتوي على المهمة التي تريد استنساخها.
• خطوة 5 انقر فوق تحديد.
  يتم إنشاء مهمة سير عمل مخصصة من مكتبة المهام. المهمة المخصصة الجديدة هي المهمة المخصصة الأخيرة في تقرير مهام سير العمل المخصصة. تتم تسمية المهمة المخصصة الجديدة على اسم المهمة المستنسخة، مع إلحاق التاريخ.
• خطوة 6 انقر فوق إرسال

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

استنساخ مهمة سير عمل مخصصة

يمكنك استخدام مهمة سير عمل مخصصة موجودة في Cisco UCS Director لإنشاء مهمة سير عمل مخصصة.

قبل أن تبدأ
يجب أن تكون مهمة سير العمل المخصصة متاحة في Cisco UCS Director.

• خطوة 1 اختر التنسيق.
• خطوة 2 انقر فوق مهام سير العمل المخصصة.
• خطوة 3 انقر فوق الصف الذي يحتوي على مهمة سير العمل المخصصة التي تريد استنساخها.
  يظهر رمز الاستنساخ أعلى جدول مهام سير العمل المخصص.
• خطوة 4 انقر فوق استنساخ.
• خطوة 5 في شاشة Clone Custom Workflow Task، قم بتحديث الحقول المطلوبة.
• خطوة 6 انقر فوق التالي.
  تظهر المدخلات المحددة لمهام سير العمل المخصصة.
• خطوة 7 انقر فوق الصف الذي يحتوي على إدخال المهمة الذي تريد تحريره ثم انقر فوق "تحرير" لتحرير مدخلات المهمة.
• خطوة 8 انقر فوق "إضافة" لإضافة إدخال إدخال مهمة.
• خطوة 9 انقر فوق التالي.
  تحرير مخرجات المهمة.
• خطوة 10 انقر فوق "إضافة" لإضافة إدخال إخراج جديد.
• خطوة 11 انقر فوق التالي.
• خطوة 12 قم بتحرير البرامج النصية لوحدة التحكم. راجع التحكم في مدخلات مهام سير العمل المخصصة، في الصفحة 13.
• خطوة 13 انقر فوق التالي.
• خطوة 14 لتخصيص المهمة المخصصة، قم بتحرير البرنامج النصي للمهمة.
• خطوة 15 انقر فوق إرسال

التحكم في مدخلات مهمة سير العمل المخصصة

باستخدام وحدات التحكم
يمكنك تعديل مظهر وسلوك مدخلات المهام المخصصة باستخدام واجهة وحدة التحكم المتوفرة في Cisco UCS Director.

متى تستخدم وحدات التحكم
استخدم وحدات التحكم في السيناريوهات التالية:

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

باستخدام وحدات تحكم الإدخال، يمكنك القيام بما يلي:

• إظهار أو إخفاء عناصر تحكم واجهة المستخدم الرسومية: يمكنك إظهار أو إخفاء حقول واجهة المستخدم الرسومية المتنوعة ديناميكيًا مثل مربعات الاختيار ومربعات النص والقوائم المنسدلة والأزرار، بناءً على الشروط. على سبيل المثالampإذا قام المستخدم بتحديد UCSM من القائمة المنسدلة، فيمكنك المطالبة ببيانات اعتماد المستخدم لـ Cisco UCS Manager أو تغيير قائمة القيم (LOVs) في القائمة المنسدلة لإظهار المنافذ المتاحة فقط على الخادم.
• التحقق من صحة حقل النموذج: يمكنك التحقق من صحة البيانات التي أدخلها المستخدم عند إنشاء مهام سير العمل أو تحريرها في مصمم سير العمل. بالنسبة للبيانات غير الصالحة التي أدخلها المستخدم، يمكن أن تظهر الأخطاء. يمكن تغيير بيانات إدخال المستخدم قبل استمرارها في قاعدة البيانات أو قبل استمرارها على الجهاز.
• استرداد قائمة القيم ديناميكيًا: يمكنك جلب قائمة القيم ديناميكيًا من كائنات Cisco UCS Director واستخدامها لملء كائنات نموذج واجهة المستخدم الرسومية.

تنظيم وإلغاء تنظيم كائنات نموذج واجهة المستخدم الرسومية
ترتبط وحدات التحكم دائمًا بنموذج في واجهة إدخالات مهمة مصمم سير العمل. يوجد تعيين واحد لواحد بين النموذج ووحدة التحكم. تعمل وحدات التحكم في اثنتينtagو، التنظيم وإلغاء التنظيم. كلا سtages لديها اثنين من الغواصاتtagإ، قبل وبعد. لاستخدام وحدة تحكم، يمكنك تنظيم (التحكم في حقول نموذج واجهة المستخدم) و/أو إلغاء تنظيم (التحقق من صحة مدخلات المستخدم) كائنات نموذج واجهة المستخدم الرسومية ذات الصلة باستخدام البرامج النصية لوحدة التحكم.

ويلخص الجدول التالي هذهtagإِسْ

بناء البرامج النصية للتحكم
لا تتطلب وحدات التحكم استيراد أي حزم إضافية.
لا يمكنك تمرير المعلمات إلى أساليب وحدة التحكم. بدلاً من ذلك، يجعل إطار عمل Cisco UCS Director المعلمات التالية متاحة للاستخدام في التنظيم وإلغاء التنظيم:

انظر على سبيل المثالampعلى: استخدام وحدات التحكم، في الصفحة 14 للحصول على رموز العملample الذي يوضح وظيفة وحدة التحكم.

Exampلو: استخدام وحدات التحكم

الكود التالي على سبيل المثالampيوضح كيفية تنفيذ وظيفة وحدة التحكم في مهام سير العمل المخصصة باستخدام الطرق المختلفة - قبل Marshall، وبعد Marshall، وقبل Unmarshall، وبعد Unmarshall.
/*

أوصاف الطريقة:
قبل مارشال: استخدم هذه الطريقة لإضافة أو تعيين حقل إدخال وإنشاء قائمة القيم وتعيينها ديناميكيًا على صفحة (نموذج).
بعد مارشال: استخدم هذه الطريقة لإخفاء أو إظهار حقل الإدخال.
قبل UnMarshall: استخدم هذه الطريقة لتحويل قيمة إدخال من نموذج إلى نموذج آخر،
على سبيل المثالample، عندما تريد تشفير كلمة المرور قبل إرسالها إلى قاعدة البيانات. بعد UnMarshall: استخدم هذه الطريقة للتحقق من صحة إدخال المستخدم وتعيين رسالة الخطأ على
صفحة.
*/
// قبل مارشال:
/*
استخدم طريقة beforeMarshall عندما يكون هناك تغيير في حقل الإدخال أو لإنشاء قوائم القيم ديناميكيًا وتعيين حقل الإدخال الجديد في النموذج قبل تحميله.
في السابقampأدناه، تتم إضافة حقل إدخال جديد "portList" على الصفحة قبل عرض النموذج في المتصفح.
*/
importPackage(com.cloupia.model.cIM);
importPackage(java.util);
importPackage(java.lang);
var portList = new ArrayList();
فار lovLabel = "eth0";
فار lovValue = "eth0";
var portListLOV = new Array();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);// أنشئ حقل إدخال lov
// يتم استخدام المعلمة "صفحة" لتعيين حقل الإدخال في النموذج
page.setEmbeddedLOVs(id + ".portList"، portListLOV)؛// قم بتعيين حقل الإدخال في النموذج ===================== ================================================================================================== ===========================================================================
// بعد مارشال :
/*
استخدم هذه الطريقة لإخفاء أو إظهار حقل الإدخال.
*/
page.setHidden(id + ".portList"، true); // إخفاء حقل الإدخال "portList".
page.setValue(id + ".status"، "لا يوجد منفذ مفتوح. قائمة المنافذ مخفية");
page.setEditable(id + ".status"، false);
================================================== ================================================== =========
// قبل إلغاء المارشال :
/*
استخدم طريقة beforeUnMarshall لقراءة مدخلات المستخدم وتحويلها إلى نموذج آخر قبل إدراجها في قاعدة البيانات. على سبيل المثالample، يمكنك قراءة كلمة المرور وتخزينها في قاعدة البيانات بعد تحويلها إلى تشفير base64، أو قراءة اسم الموظف وتحويله إلى معرف الموظف عند إرسال اسم الموظف إلى قاعدة البيانات.
في الكود السابقampتتم قراءة الحجم الموجود أسفل حجم القمر وتحويله إلى قيمة ASCII.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
حجم فار = page.getValue(id + ".lunSize");
var logger = Logger.getLogger("المسجل الخاص بي");
إذا (الحجم != فارغ){
logger.info("قيمة الحجم"+size);
if((new java.lang.String(size)).matches("\\d+")){ var byteValue = size.getBytes("US-ASCII"); // قم بتحويل حجم اللون واحصل على مصفوفة أحرف ASCII

var asciiValueBuilder = new StringBuilder();
لـ (var i = 0; i < byteValue. length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
فار asciiValue = asciiValueBuilder.toString()+" - Ascii
قيمة"
//id + ".lunSize" هو معرف حقل الإدخال
page.setValue(id + ".lunSize"،asciiValue); // المعلمة
يتم استخدام "الصفحة" لتعيين القيمة في حقل الإدخال.
pojo.setLunSize(asciiValue); // قم بتعيين القيمة على pojo.
سيتم إرسال هذا pojo إلى قاعدة البيانات أو جهاز خارجي
}
================================================== ================================================== =========
// بعد إلغاء مارشال :
/*
استخدم هذه الطريقة للتحقق من صحة وتعيين رسالة خطأ.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
// حجم فار = pojo.getLunSize();
حجم فار = page.get Value(id + ".lunSize");
var logger = Logger .get Logger("المسجل الخاص بي");
logger.info("قيمة الحجم"+size);
إذا (الحجم > 50) {//التحقق من الحجم
صفحة. قم بتعيين الخطأ (id+).lunSize"، "لا يمكن أن يزيد حجم LUN عن 50 ميجابايت")؛ //تعيين
رسالة الخطأ على الصفحة
page .set Page message("لا يمكن أن يزيد حجم LUN عن 50 ميجابايت");
//صفحة. تعيين حالة الصفحة (2)؛
}

استخدام مخرجات مهمة سابقة في سير العمل

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

• قم باسترجاع المتغير من سياق سير العمل باستخدام طريقة get Input().
• الرجوع إلى الإخراج باستخدام تدوين متغير النظام.

لاسترداد مخرجات باستخدام طريقة getInput() الخاصة بالسياق، استخدم:
اسم فار = ctxt.getInput("PreviousTaskName.outputFieldName");

على سبيل المثالampعلى:
اسم فار = ctxt.getInput("custom_task1_1684.NAME"); // الاسم هو اسم إخراج المهمة 1
الحقل الذي تريد الوصول إليه
لاسترداد مخرجات باستخدام تدوين متغير النظام، استخدم:
اسم فار = "${اسم المهمة السابقة. اسم حقل الإخراج}"؛

على سبيل المثالampعلى:
اسم فار = "${custom_task1_1684.NAME}"; // الاسم هو اسم حقل إخراج المهمة 1 الذي تريد الوصول إليه

Example: إنشاء مهمة مخصصة وتشغيلها

لإنشاء مهمة مخصصة، قم بما يلي:

• خطوة 1 اختر التنسيق.
• خطوة 2 انقر فوق مهام سير العمل المخصصة.
• خطوة 3 انقر فوق "إضافة" وأدخل معلومات المهمة المخصصة.
• خطوة 4 انقر فوق التالي.
• خطوة 5 انقر فوق + وأضف تفاصيل الإدخال.
• خطوة 6 انقر فوق إرسال.
• خطوة 7 انقر فوق التالي.
  يتم عرض شاشة مخرجات المهام المخصصة.
• خطوة 8 انقر فوق + وأضف تفاصيل الإخراج للمهمة المخصصة.
• خطوة 9 انقر فوق التالي.
  يتم عرض شاشة وحدة التحكم.
• خطوة 10 انقر فوق + وأضف تفاصيل وحدة التحكم للمهمة المخصصة.
• خطوة 11 انقر فوق التالي.
  يتم عرض شاشة البرنامج النصي.
• خطوة 12 حدد JavaScript كلغة التنفيذ وأدخل البرنامج النصي التالي للتنفيذ.
  logger.addInfo("مرحبا بالعالم!");
  logger.addInfo("الرسالة"+input.message);
  حيث الرسالة هي اسم حقل الإدخال.
• خطوة 13 انقر فوق "حفظ البرنامج النصي".
• خطوة 14 انقر فوق إرسال.
  يتم تعريف المهمة المخصصة وإضافتها إلى قائمة المهام المخصصة.
• خطوة 15 في صفحة التنسيق، انقر فوق مسارات العمل.
• خطوة 16 انقر فوق "إضافة" لتحديد سير العمل، وتحديد مدخلات ومخرجات سير العمل.
  بمجرد تحديد مدخلات ومخرجات سير العمل، استخدم مصمم سير العمل لإضافة مهمة سير عمل إلى سير العمل.
• خطوة 17 انقر نقرًا مزدوجًا فوق سير العمل لفتح سير العمل في شاشة "مصمم سير العمل".
• خطوة 18 على الجانب الأيسر من مصمم سير العمل، قم بتوسيع المجلدات واختيار مهمة مخصصة (على سبيل المثالample، "مرحبًا بالمهمة المخصصة للعالم").
• خطوة 19 قم بسحب وإسقاط المهمة المختارة إلى مصمم سير العمل.
• خطوة 20 أكمل الحقول في إضافة مهمة ( ) شاشة.
• خطوة 21 ربط المهمة بسير العمل. راجع دليل تنسيق مدير Cisco UCS.
• خطوة 22 انقر فوق التحقق من صحة سير العمل.
• خطوة 23 انقر فوق "تنفيذ الآن" ثم انقر فوق "إرسال".
• خطوة 24 راجع رسائل السجل في نافذة سجل طلب الخدمة.

المستندات / الموارد

سيسكو إنشاء مهام سير العمل المخصصة [بي دي اف] دليل المستخدم إنشاء مهام سير العمل المخصصة، مهام سير العمل المخصصة، إنشاء مهام سير العمل، مهام سير العمل، المهام

مراجع

• دليل المستخدم