راهنمای کاربر ایجاد وظایف گردش کار سفارشی سیسکو

Cisco UCS Director Orchestrator لیستی از انواع ورودی به خوبی تعریف شده برای کارهای سفارشی ارائه می دهد. Cisco UCS Director همچنین شما را قادر می سازد تا یک ورودی گردش کار سفارشی شده برای یک کار گردش کار سفارشی ایجاد کنید. می‌توانید با شبیه‌سازی و تغییر نوع ورودی موجود، یک نوع ورودی جدید ایجاد کنید.

پیش نیازها

قبل از نوشتن کارهای سفارشی، باید پیش نیازهای زیر را داشته باشید:

Cisco UCS Director بر روی سیستم شما نصب و اجرا می شود. برای اطلاعات بیشتر در مورد نحوه نصب Cisco UCS Director، به راهنمای نصب و پیکربندی Cisco UCS Director مراجعه کنید.
شما یک لاگین با حقوق مدیر دارید. هنگام ایجاد و تغییر وظایف سفارشی باید از این ورود استفاده کنید.

برای نوشتن یک کار سفارشی با استفاده از CloupiaScript باید مجوز نوشتن CloupiaScript را داشته باشید.
برای اجرای یک کار سفارشی ایجاد شده با استفاده از کلوپیا اسکریپت، باید مجوز اجرای کلوپیا اسکریپت را داشته باشید.

ایجاد یک ورودی گردش کار سفارشی

می توانید یک ورودی سفارشی برای یک کار گردش کار سفارشی ایجاد کنید. ورودی در لیست انواع ورودی نمایش داده می‌شود که می‌توانید هنگام ایجاد یک کار گردش کار سفارشی، به ورودی‌های کار سفارشی نگاشت کنید.

مرحله 1 ارکستراسیون را انتخاب کنید.

مرحله 2 روی Custom Workflow Inputs کلیک کنید.
مرحله 3 روی Add کلیک کنید.

مرحله 4 در صفحه افزودن ورودی CustomWorkflow، فیلدهای زیر را تکمیل کنید:
- نام نوع ورودی سفارشی - یک نام منحصر به فرد برای نوع ورودی سفارشی.
- نوع ورودی - یک نوع ورودی را بررسی کرده و روی Select کلیک کنید. بر اساس ورودی انتخاب شده، فیلدهای دیگری ظاهر می شوند. برای مثالampهنگامی که آدرس ایمیل را به عنوان نوع ورودی انتخاب می کنید، لیستی از مقادیر (LOV) ظاهر می شود. از فیلدهای جدید برای محدود کردن مقادیر ورودی سفارشی استفاده کنید.
مرحله 5 روی Submit کلیک کنید.

ورودی گردش کار سفارشی به Cisco UCS Director اضافه شده و در لیست انواع ورودی موجود است.

اعتبار سنجی ورودی سفارشی

مشتریان ممکن است نیاز به اعتبارسنجی ورودی های گردش کار با استفاده از منابع خارجی داشته باشند. خارج از جعبه، Cisco UCS Director نمی تواند نیازهای اعتبارسنجی هر مشتری را برآورده کند. برای پر کردن این شکاف، Cisco UCS Director گزینه ای برای اعتبارسنجی هر ورودی در زمان اجرا با استفاده از یک اسکریپت ارائه شده توسط مشتری فراهم می کند. اسکریپت می‌تواند خطاها را در ورودی علامت‌گذاری کند و می‌تواند قبل از اجرای درخواست سرویس، به ورودی معتبر نیاز داشته باشد. اسکریپت می تواند به هر زبانی نوشته شود، می تواند به هر منبع خارجی دسترسی داشته باشد و به تمام مقادیر ورودی گردش کار دسترسی دارد.
شما می توانید اسکریپت های اعتبار سنجی سفارشی را با استفاده از جاوا اسکریپت، پایتون، اسکریپت پوسته bash یا هر زبان برنامه نویسی دیگری بنویسید.

سابق زیرampاسکریپت های اعتبار سنجی را می توان در Cisco UCS Director در Orchestration > Custom Workflow Inputs پیدا کرد:

Example-bash-script-validator

Example-javascript-validator
Example-python-validator

شما می توانید نسخه قبلی را کپی یا کلون کنیدampورودی های گردش کار را اسکریپت کنید تا یک ورودی معتبر جدید ایجاد کنید. شما همچنین می توانید از حالت قبلی استفاده کنیدampورودی های گردش کار اسکریپت شده را به عنوان راهنمایی برای توسعه اسکریپت های خود بنویسید.

صرف نظر از زبان برنامه نویسی، ویژگی ها و قوانین زیر برای اعتبارسنجی ورودی سفارشی اسکریپت اعمال می شود:

تمام اعتبار سنجی اسکریپت شده در یک فرآیند جداگانه اجرا می شود، به طوری که یک فرآیند اعتبار سنجی ناموفق بر فرآیند Cisco UCS Director تأثیر نمی گذارد.
فقط ورودی های متن عمومی را می توان با استفاده از اسکریپت ها تأیید کرد.

اسکریپت های اعتبار سنجی یک به یک، به ترتیب، به همان ترتیبی که ورودی ها در صفحه ورودی های گردش کار ظاهر می شوند، اجرا می شوند. یک فرآیند جداگانه برای هر ورودی معتبر راه اندازی می شود.
مقدار برگشتی غیر صفر از اسکریپت نشان دهنده اعتبار سنجی ناموفق است. در صورت تمایل، می توانید یک پیام خطا را به فرم ورودی گردش کار ارسال کنید.

تمام ورودی های گردش کار به دو روش به اسکریپت اعتبار سنجی ارسال می شود:
- به عنوان آرگومان های اسکریپت به شکل “key”=”value”.
- به عنوان متغیرهای محیطی برای فرآیند اسکریپت. نام متغیرها برچسب های ورودی هستند.
  برای مثالampاگر گردش کار دارای ورودی با عنوان Product-Code باشد و مقدار ورودی AbC123 باشد، متغیر به صورت "Product-Code"="AbC123" به اسکریپت اعتبارسنجی ارسال می شود.
  این متغیرهای ورودی را می توان در صورت لزوم توسط اسکریپت برای اجرای اعتبار سنجی استفاده کرد. استثنا: مقادیر جدول فقط شامل شماره ردیف انتخاب جدول هستند و بنابراین احتمالاً بی فایده هستند.
صفحه Edit Custom Workflow Input اسکریپت را در ویرایشگر کار سفارشی در دسترس قرار می دهد. نحو برای همه زبان ها برجسته شده است. خطاهای نحوی فقط برای اعتبار سنجی جاوا اسکریپت بررسی می شوند.

شبیه سازی ورودی گردش کار سفارشی

می توانید از ورودی گردش کار سفارشی موجود در Cisco UCS Director برای ایجاد یک ورودی گردش کار سفارشی استفاده کنید.

قبل از شروع
یک ورودی گردش کار سفارشی باید در Cisco UCS Director موجود باشد.

مرحله 1 ارکستراسیون را انتخاب کنید.
مرحله 2 روی Custom Workflow Inputs کلیک کنید.
مرحله 3 روی ردیف با ورودی گردش کار سفارشی برای کلون کردن کلیک کنید.
نماد Clone در بالای جدول ورودی های گردش کار سفارشی ظاهر می شود.
مرحله 4 روی Clone کلیک کنید.
مرحله 5 نام نوع ورودی سفارشی را وارد کنید.
مرحله 6 برای سفارشی کردن ورودی جدید از سایر کنترل ها در صفحه ورودی گردش کار سفارشی Clone استفاده کنید.
مرحله 7 روی ارسال کلیک کنید.
ورودی وظیفه گردش کار سفارشی پس از تأیید کلون شده و برای استفاده در کار گردش کار سفارشی در دسترس است.

ایجاد یک کار سفارشی

برای ایجاد یک کار سفارشی، موارد زیر را انجام دهید:

مرحله 1 ارکستراسیون را انتخاب کنید.
مرحله 2 روی Custom Workflow Tasks کلیک کنید.
مرحله 3 روی Add کلیک کنید.
مرحله 4 در صفحه Add Custom Workflow Task، فیلدهای زیر را تکمیل کنید:
- فیلد Task Name - یک نام منحصر به فرد برای وظیفه گردش کار سفارشی.
- فیلد برچسب وظیفه - برچسبی برای شناسایی وظیفه گردش کار سفارشی.
- فیلد Register Under Category - دسته گردش کار که وظیفه گردش کار سفارشی باید تحت آن ثبت شود.
- فعال کردن کادر بررسی وظیفه — اگر علامت زده شود، وظیفه گردش کار سفارشی در Orchestrator ثبت می شود و بلافاصله در گردش کار قابل استفاده است.
- فیلد شرح مختصر - شرح وظایف گردش کار سفارشی.
- فیلد توضیحات تفصیلی - شرح مفصلی از وظیفه گردش کار سفارشی.

مرحله 5 روی Next کلیک کنید.
صفحه ورودی های وظیفه سفارشی ظاهر می شود.
مرحله 6 روی Add کلیک کنید.
مرحله 7 در صفحه افزودن ورودی به ورودی ها، فیلدهای زیر را تکمیل کنید:
- فیلد نام فیلد ورودی - یک نام منحصر به فرد برای فیلد. نام باید با حروف الفبایی شروع شود و نباید دارای فاصله یا نویسه های خاص باشد.
- فیلد برچسب فیلد ورودی - برچسبی برای شناسایی فیلد ورودی.
- لیست کشویی نوع فیلد ورودی - نوع داده پارامتر ورودی را انتخاب کنید.
- فیلد Map to Input Type (No Mapping)—نوعی از ورودی را انتخاب کنید که این فیلد به آن نگاشت شود، در صورتی که این فیلد می تواند از خروجی کار دیگر یا ورودی گردش کار جهانی نگاشت شود.
- چک باکس اجباری - اگر علامت زده شود، کاربر باید مقداری برای این فیلد ارائه دهد.
- فیلد RBID — رشته RBID را برای فیلد وارد کنید.
- فهرست کشویی اندازه فیلد ورودی - اندازه فیلد را برای ورودی های متن و جدولی انتخاب کنید.
- فیلد راهنما فیلد ورودی—(اختیاری) توضیحاتی که وقتی ماوس را روی فیلد می برید نشان داده می شود.
- فیلد حاشیه نویسی فیلد ورودی — (اختیاری) متن راهنمایی برای فیلد ورودی.
- فیلد نام گروه فیلد - اگر مشخص شده باشد، تمام فیلدهایی که نام گروهی منطبق دارند در گروه فیلد قرار می گیرند.
- ناحیه ویژگی های فیلد متنی — وقتی نوع فیلد ورودی متن است، فیلدهای زیر را تکمیل کنید.
- چک باکس ورودی چندگانه—اگر علامت زده شود، فیلد ورودی چندین مقدار را بر اساس نوع فیلد ورودی می پذیرد:
- برای یک LOV - فیلد ورودی چندین مقدار ورودی را می پذیرد.
- برای یک فیلد متنی - فیلد ورودی به فیلد متنی چند خطی تبدیل می شود.
- حداکثر طول فیلد ورودی — حداکثر تعداد کاراکترهایی را که می توانید در فیلد ورودی وارد کنید، مشخص کنید.
- ناحیه LOV ATTRIBUTES — وقتی نوع ورودی لیست مقادیر (LOV) یا LOV با دکمه های رادیویی است، فیلدهای زیر را تکمیل کنید.
- قسمت List of Values - فهرستی از مقادیر جدا شده با کاما برای LOV های تعبیه شده.
  فیلد نام ارائه‌دهنده LOV - نام ارائه‌دهنده LOV برای LOV‌های غیر تعبیه‌شده.
- ناحیه ویژگی های جدول — وقتی نوع فیلد ورودی Table، Popup Table یا Table with selection است، فیلدهای زیر را تکمیل کنید.
- فیلد نام جدول - نام گزارش جدولی برای انواع فیلد جدول.
- FIELD INPUT VALIDATION ناحیه — یک یا چند فیلد زیر بسته به نوع داده انتخابی شما نمایش داده می شود. فیلدها را تکمیل کنید تا مشخص کنید که چگونه فیلدهای ورودی اعتبارسنجی می شوند.
- فهرست کشویی Input Validator—یک اعتبارسنجی برای ورودی کاربر انتخاب کنید.
- فیلد بیان منظم - یک الگوی عبارت منظم برای مطابقت با مقدار ورودی.
- فیلد پیام عبارت منظم - پیامی که زمانی نمایش داده می شود که اعتبار سنجی عبارت معمولی ناموفق باشد.
- فیلد حداقل مقدار - حداقل مقدار عددی.
- قسمت حداکثر مقدار - حداکثر مقدار عددی.
- ناحیه HIDE ON FIELD CONDITION — فیلدهای زیر را تکمیل کنید تا شرایط مخفی کردن فیلد را در یک فرم تنظیم کنید.
- فیلد Hide On Field Name - یک نام داخلی برای فیلد تا برنامه ای که فرم را مدیریت می کند بتواند فیلد را شناسایی کند.
- فیلد Hide On Field Value - مقداری که باید پس از ارسال فرم ارسال شود.
- لیست کشویی Hide On Field Condition—شرطی را انتخاب کنید که در آن فیلد باید پنهان شود.
- فیلد راهنمای HTML - دستورالعمل های کمکی برای فیلد پنهان.

مرحله 8 روی ارسال کلیک کنید.
ورودی ورودی به جدول اضافه می شود.
مرحله 9 برای افزودن ورودی بیشتر به ورودی ها، روی Add کلیک کنید.
مرحله 10 وقتی افزودن ورودی ها تمام شد، روی Next کلیک کنید.
صفحه Custom Workflow Tasks Outputs ظاهر می شود.

مرحله 11 روی Add کلیک کنید.
مرحله 12 در صفحه افزودن ورودی به خروجی ها، فیلدهای زیر را تکمیل کنید:
- فیلد نام فیلد خروجی - یک نام منحصر به فرد برای فیلد خروجی. باید با یک نویسه الفبایی شروع شود و نباید دارای فاصله یا کاراکترهای خاص باشد.
- فیلد توضیحات فیلد خروجی - شرح فیلد خروجی.
- فیلد نوع فیلد خروجی - نوع خروجی را بررسی کنید. این نوع تعیین می کند که چگونه خروجی می تواند به ورودی های وظیفه دیگر نگاشت شود.
مرحله 13 روی ارسال کلیک کنید.
ورودی خروجی به جدول اضافه می شود.

مرحله 14 برای افزودن ورودی بیشتر به خروجی ها روی Add کلیک کنید.
مرحله 15 روی Next کلیک کنید
صفحه کنترلر ظاهر می شود
مرحله 16 (اختیاری) برای افزودن یک کنترلر روی Add کلیک کنید.

مرحله 17 در صفحه افزودن ورودی به کنترلر، فیلدهای زیر را تکمیل کنید:
- فهرست کشویی روش - برای سفارشی کردن ورودی‌ها و/یا خروجی‌ها برای کار گردش کار سفارشی، یک روش marshalling یا unmarshalling را انتخاب کنید. روش می تواند یکی از موارد زیر باشد:
- قبل از مارشال—از این روش برای افزودن یا تنظیم یک فیلد ورودی و ایجاد و تنظیم پویا LOV در یک صفحه (فرم) استفاده کنید.
- After Marshall—از این روش برای مخفی کردن یا پنهان کردن یک فیلد ورودی استفاده کنید.
- قبل از Unmarshall - از این روش برای تبدیل یک مقدار ورودی از یک فرم به فرم دیگر استفاده کنید - برای مثالample، زمانی که می خواهید رمز عبور را قبل از ارسال به پایگاه داده رمزگذاری کنید.
- After Unmarshall—از این روش برای تأیید اعتبار ورودی کاربر و تنظیم پیام خطا در صفحه استفاده کنید.
  رجوع کنید به Exampدر: با استفاده از کنترلرها، در صفحه 14.
- ناحیه متن اسکریپت — برای روشی که از لیست کشویی Method انتخاب کرده اید، کد اسکریپت سفارشی سازی GUI را اضافه کنید.
  توجه داشته باشید اگر می‌خواهید برای روش‌های بیشتر کد اضافه کنید، روی Add کلیک کنید.
  در صورت وجود اعتبارسنجی برای گذرواژه‌های وارد شده، اطمینان حاصل کنید که اعتبار کنترلر برای گذرواژه‌ها را تغییر دهید تا بتوانید وظایف سفارشی را در گردش‌های کاری ویرایش کنید.
  توجه داشته باشید
مرحله 18 روی ارسال کلیک کنید.
کنترلر به جدول اضافه می شود.
مرحله 19 روی Next کلیک کنید.
صفحه اسکریپت ظاهر می شود.

مرحله 20 از لیست کشویی Execution Language، یک زبان را انتخاب کنید.
مرحله 21 در قسمت Script، کد CloupiaScript را برای وظیفه گردش کار سفارشی وارد کنید.
کد کلوپیا اسکریپت زمانی که کد را وارد می‌کنید تأیید می‌شود. در صورت وجود هر گونه خطایی در کد، نماد خطا (صلیب قرمز) در کنار شماره خط نمایش داده می شود. ماوس را روی نماد خطا قرار دهید تا view پیام خطا و راه حل
مرحله 22 روی Save Script کلیک کنید.

مرحله 23 روی ارسال کلیک کنید.
وظیفه گردش کار سفارشی ایجاد شده و برای استفاده در گردش کار در دسترس است

وظایف و مخازن سفارشی

هنگامی که یک کار سفارشی ایجاد می کنید، به جای تایپ کد کار سفارشی در پنجره اسکریپت یا برش و چسباندن کد از یک ویرایشگر متن، می توانید کد را از یک ویرایشگر متن وارد کنید. file در یک مخزن GitHub یا BitBucket ذخیره می شود. برای انجام این کار، شما:

یک یا چند متن ایجاد کنید fileدر یک مخزن GitHub یا BitBucket، چه در github.com یا یک مخزن GitHub شرکت خصوصی.
توجه داشته باشید Cisco UCS Director فقط از GitHub (github.com یا یک نمونه GitHub سازمانی) و یا BitBucket پشتیبانی می کند. از دیگر خدمات میزبانی Git از جمله GitLab، Perforce یا Codebase پشتیبانی نمی کند.

مخزن را در Cisco UCS Director ثبت کنید. به افزودن یک مخزن GitHub یا BitBucket در Cisco UCS Director، در صفحه 7 مراجعه کنید.
مخزن را انتخاب کرده و متن را مشخص کنید file که حاوی اسکریپت وظیفه سفارشی است. دانلود کد اسکریپت وظیفه سفارشی از یک مخزن GitHub یا BitBucket، در صفحه 8 را ببینید.

افزودن یک مخزن GitHub یا BitBucket در Cisco UCS Director
برای ثبت یک مخزن GitHub یا BitBucket در Cisco UCS Director، موارد زیر را انجام دهید:

قبل از شروع
یک مخزن GitHub یا BitBucket ایجاد کنید. مخزن می تواند در هر سرور GitHub یا BitBucket، عمومی یا خصوصی باشد که از Cisco UCS Director شما قابل دسترسی است.
یک یا چند مورد را بررسی کنید fileحاوی کد جاوا اسکریپت برای کارهای سفارشی شما در مخزن شما.

مرحله 1 Administration > Integration را انتخاب کنید.
مرحله 2 در صفحه ادغام، روی Manage Repositories کلیک کنید.

مرحله 3 روی Add کلیک کنید.
مرحله 4 در صفحه افزودن مخزن، فیلدهای مورد نیاز از جمله موارد زیر را تکمیل کنید:
- در قسمت Repository Nickname، نامی را برای شناسایی مخزن در Cisco UCS Director وارد کنید.
- در مخزن URL فیلد را وارد کنید URL از مخزن GitHub یا BitBucket.
- در قسمت Branch Name، نام شعبه مخزن مورد نظر خود را وارد کنید. نام پیش فرض شعبه اصلی است.
- در قسمت Repository User، نام کاربری حساب GitHub یا BitBucket خود را وارد کنید.
- برای افزودن مخزن GitHub، در قسمت Password/API Token، توکن API ایجاد شده برای GitHub خود را وارد کنید.
  برای تولید توکن API با استفاده از GitHub، روی تنظیمات کلیک کنید و به تنظیمات توسعه‌دهنده > نشانه‌های دسترسی شخصی بروید و روی Generate new token کلیک کنید.
  برای یادداشت، مخزن BitBucket را اضافه کنید، در قسمت Password/API Token، رمز عبور BitBucket خود را وارد کنید.
- برای پیش‌فرض این مخزن هنگام ایجاد یک کار سفارشی جدید، گزینه Make this my default repository را علامت بزنید.
- برای آزمایش اینکه آیا Cisco UCS Director می تواند به مخزن دسترسی داشته باشد یا خیر، روی Test Connectivity کلیک کنید.
  وضعیت اتصال با مخزن در یک بنر در بالای صفحه نمایش داده می شود.
  اگر قادر به اتصال و ارتباط با مخزن GitHub یا BitBucket از Cisco UCS نیستید.
  مدیر، Cisco UCS Director را برای دسترسی به اینترنت از طریق یک سرور پروکسی به روز کنید. Cisco UCS Director Administration Guide را ببینید.
  توجه داشته باشید

مرحله 5 وقتی از صحت اطلاعات مخزن راضی شدید، روی ارسال کلیک کنید.

دانلود کد سفارشی Task Script از یک مخزن GitHub یا BitBucket

برای ایجاد یک کار سفارشی جدید با وارد کردن متن از یک مخزن GitHub یا BitBucket، موارد زیر را انجام دهید:

قبل از شروع
یک مخزن GitHub یا BitBucket ایجاد کنید و یک یا چند متن را بررسی کنید fileحاوی کد جاوا اسکریپت برای کارهای سفارشی شما در مخزن شما.

مخزن GitHub را به Cisco UCS Director اضافه کنید. به افزودن یک مخزن GitHub یا BitBucket در Cisco UCS Director، در صفحه مراجعه کنید.

مرحله 1 در صفحه Orchestration، روی Custom Workflow Tasks کلیک کنید.

مرحله 2 روی Add کلیک کنید.
مرحله 3 فیلدهای مورد نیاز را در صفحه اطلاعات وظیفه سفارشی تکمیل کنید. به ایجاد یک کار سفارشی در صفحه 3 مراجعه کنید.
مرحله 4 فیلدهای مورد نیاز را در صفحه ورودی های وظیفه سفارشی تکمیل کنید. به ایجاد یک کار سفارشی در صفحه 3 مراجعه کنید.

مرحله 5 فیلدهای مورد نیاز را در صفحه خروجی های وظیفه سفارشی تکمیل کنید. به ایجاد یک کار سفارشی در صفحه 3 مراجعه کنید.
مرحله 6 فیلدهای مورد نیاز را در صفحه Controller تکمیل کنید. به ایجاد یک کار سفارشی در صفحه 3 مراجعه کنید.
مرحله 7 در صفحه اسکریپت، فیلدهای لازم را تکمیل کنید:
- از لیست کشویی Execution Language، جاوا اسکریپت را انتخاب کنید.
- برای فعال کردن کار سفارشی برای استفاده از یک اسکریپت، Use Repository for Scripts را علامت بزنید file از یک مخزن این به شما امکان می دهد مخزن را انتخاب کرده و اسکریپت را مشخص کنید file برای استفاده.
- از لیست کشویی Select Repository، مخزن GitHub یا BitBucket حاوی اسکریپت را انتخاب کنید. fileس برای جزئیات بیشتر در مورد نحوه افزودن مخازن، به افزودن مخزن GitHub یا BitBucket در Cisco UCS Director، در صفحه 7 مراجعه کنید.
- مسیر کامل اسکریپت را وارد کنید file در اسکریپت fileفیلد متنی نام
- برای دانلود اسکریپت روی Load Script کلیک کنید.
  متن از file در قسمت ویرایش متن اسکریپت کپی می شود.
- در صورت تمایل، تغییراتی را در اسکریپت دانلود شده در قسمت ویرایش متن Script ایجاد کنید.
- برای ذخیره اسکریپت همانطور که در قسمت ویرایش متن اسکریپت ظاهر می شود، روی Save Script کلیک کنید.
  وقتی Save Script را فشار می دهید، اسکریپت در جلسه کاری فعلی شما ذخیره می شود. برای ذخیره اسکریپت در کار سفارشی که در حال ویرایش هستید، باید روی ارسال کلیک کنید.
  توجه داشته باشید
مرحله 8 برای ذخیره کار سفارشی، روی ارسال کلیک کنید.
اگر در قسمت ویرایش متن اسکریپت تغییراتی در اسکریپت دانلود شده ایجاد کردید، تغییرات در کار سفارشی ذخیره می‌شوند. هیچ تغییری در مخزن GitHub یا BitBucket ذخیره نمی شود. اگر می‌خواهید اسکریپت بارگیری شده را کنار بگذارید و اسکریپت خود را وارد کنید، روی گزینه Discard Script کلیک کنید تا پنجره اسکریپت پاک شود.

بعد چه باید کرد
می توانید از وظیفه سفارشی جدید در یک گردش کار استفاده کنید.

وارد کردن گردش کار، وظایف سفارشی، ماژول‌های اسکریپت و فعالیت‌ها

برای وارد کردن مصنوعات به Cisco UCS Director، موارد زیر را انجام دهید:

توجه داشته باشید در صورتی که متغیر جهانی در دستگاه موجود نباشد، متغیرهای کلی مرتبط با یک گردش کار هنگام وارد کردن گردش کار وارد می‌شوند.

مرحله 1 ارکستراسیون را انتخاب کنید.

مرحله 2 در صفحه Orchestration، روی Workflows کلیک کنید.
مرحله 3 روی Import کلیک کنید.
مرحله 4 در صفحه Import، روی Select a کلیک کنید File.

مرحله 5 در انتخاب File برای صفحه آپلود، را انتخاب کنید file وارد شود. Cisco UCS Director واردات و صادرات fileدارای wfdx file پسوند.
مرحله 6 روی Open کلیک کنید.
زمانی که file آپلود شده است، File صفحه نمایش آپلود/ اعتبارسنجی File آماده برای استفاده و کلید.
مرحله 7 کلیدی را که هنگام صادرات وارد شده است وارد کنید file.

مرحله 8 روی Next کلیک کنید.
صفحه Import Policies فهرستی از اشیاء Cisco UCS Director موجود در آپلود شده را نشان می دهد file.
مرحله 9 (اختیاری) در صفحه Import Policies، نحوه مدیریت اشیاء را در صورتی که نام‌هایی را از قبل در پوشه گردش کار تکرار می‌کنند، مشخص کنید. در صفحه واردات، فیلدهای زیر را تکمیل کنید

نام	توضیحات
گردش کار	از میان گزینه‌های زیر، نحوه مدیریت گردش‌های کاری با نام یکسان را انتخاب کنید: جایگزین کنید- گردش کار موجود را با گردش کار وارداتی جایگزین کنید. هر دو را نگه دار- گردش کار را به عنوان یک نسخه جدید وارد کنید. پرش کنید- گردش کار را وارد نکنید.
وظایف سفارشی	از میان گزینه های زیر انتخاب کنید تا مشخص کنید چگونه وظایف سفارشی با نام یکسان انجام می شود: جایگزین کنید هر دو را نگه دار پرش کنید

نام	توضیحات
ماژول های اسکریپت	از میان گزینه های زیر برای تعیین نحوه مدیریت ماژول های اسکریپت با نام یکسان انتخاب کنید: جایگزین کنید هر دو را نگه دار پرش کنید
فعالیت ها	از میان گزینه‌های زیر انتخاب کنید تا مشخص کنید چگونه فعالیت‌هایی با نام یکسان انجام می‌شوند: جایگزین کنید هر دو را نگه دار پرش کنید
وارد کردن گردش کار به پوشه	Check Import Workflows to Folder برای وارد کردن گردش کار. اگر Import Workflows to Folder را علامت نزنید و اگر نسخه موجود یک workflow وجود نداردw وجود دارد، آن گردش کار وارد نشده است.
پوشه را انتخاب کنید	پوشه ای را انتخاب کنید که در آن گردش کار وارد شود. اگر شما انتخاب کردید [جدید پوشه..] در لیست کشویی، پوشه جدید فیلد ظاهر می شود.
پوشه جدید	نام پوشه جدید را برای ایجاد به عنوان پوشه واردات خود وارد کنید.

مرحله 10 روی Import کلیک کنید.

صادرات گردش کار، وظایف سفارشی، ماژول های اسکریپت، و فعالیت ها

برای صادرات مصنوعات از Cisco UCS Director، موارد زیر را انجام دهید:

توجه داشته باشید متغیرهای جهانی مرتبط با یک گردش کار به طور خودکار هنگام صادرات یک گردش کار صادر می شوند.

مرحله 1 بر روی Export کلیک کنید.
مرحله 2 در صفحه Select Workflows، گردش کاری را که می خواهید صادر کنید انتخاب کنید.
گردش‌های کاری سفارشی، وظایف و اسکریپت‌های ایجاد شده در Cisco UCS Director قبل از نسخه 6.6 اگر حاوی داده‌های XML باشند، ممکن است وارد شوند.
توجه داشته باشید
مرحله 3 روی Next کلیک کنید.
مرحله 4 در صفحه Select Custom Tasks، وظایف سفارشی را که می خواهید نمایش دهید انتخاب کنید
توجه: وظیفه سفارشی صادر شده شامل تمام ورودی های سفارشی است که توسط آن کار سفارشی استفاده می شود.
مرحله 5 روی Next کلیک کنید.
مرحله 6 در صادرات: صفحه ماژول های اسکریپت را انتخاب کنید، ماژول های اسکریپتی را که می خواهید صادر کنید انتخاب کنید.
مرحله 7 روی Next کلیک کنید.
مرحله 8 در صادرات: صفحه فعالیت ها را انتخاب کنید، فعالیت هایی را که می خواهید صادر کنید انتخاب کنید.
مرحله 9 روی Next کلیک کنید.
مرحله 10 در صادرات: صفحه Open APIs را انتخاب کنید، API هایی را که می خواهید صادر کنید انتخاب کنید.
مرحله 11 در صفحه Export: Confirmation، فیلدهای زیر را تکمیل کنید:

نام	توضیحات
صادر شده توسط	نام شما یا یادداشتی مبنی بر اینکه چه کسی مسئول صادرات است.
نظرات	نظرات در مورد این صادرات
صادر شده را رمزگذاری کنید file	گزینه Encrypt the exported را بررسی کنید file کادر را علامت بزنید تا رمزگذاری شود file صادر شود. به طور پیش فرض، چک باکس علامت زده می شود.
کلید	کلید رمزگذاری را وارد کنید file. این فیلد فقط زمانی نمایش داده می شود که رمزگذاری صادر شده باشد file چک باکس علامت زده شده است. هنگام وارد کردن گردش کار برای رمزگشایی، کلید را همانطور که لازم است حفظ کنید.
تأیید کلید	برای تایید دوباره کلید را وارد کنید. این فیلد فقط زمانی نمایش داده می شود که رمزگذاری صادر شده باشد file چک باکس علامت زده شده است.
صادر شد File نام	نام از file در سیستم محلی شما فقط پایه را تایپ کنید fileنام؛ را file پسوند نوع (wfdx.) به طور خودکار اضافه می شود.

مرحله 12 بر روی Export کلیک کنید.
از شما خواسته می شود که ذخیره کنید file.

شبیه سازی یک وظیفه گردش کار سفارشی از Task Library

می توانید وظایف را در کتابخانه وظیفه کلون کنید تا در ایجاد وظایف سفارشی از آنها استفاده کنید. همچنین می توانید یک کار سفارشی را برای ایجاد یک کار سفارشی کلون کنید.

وظیفه کلون شده چارچوبی با ورودی ها و خروجی های وظیفه مشابه با وظیفه اصلی است. با این حال، وظیفه شبیه سازی شده فقط یک چارچوب است. این بدان معنی است که شما باید تمام عملکردهای کار جدید را در CloupiaScript بنویسید.

همچنین توجه داشته باشید که مقادیر انتخابی برای ورودی‌های فهرست، مانند لیست‌های کشویی و فهرست‌های مقادیر، تنها در صورتی به کار شبیه‌سازی شده منتقل می‌شوند که مقادیر فهرست وابسته به سیستم نباشند. مواردی مانند نام و آدرس IP سیستم های موجود وابسته به سیستم هستند. مواردی مانند گزینه های پیکربندی که توسط Cisco UCS Director پشتیبانی می شوند، نیستند. برای مثالample، گروه های کاربر، نام های ابری، و گروه های پورت وابسته به سیستم هستند. نقش های کاربر، انواع ابر و انواع گروه پورت وجود ندارد.

مرحله 1 ارکستراسیون را انتخاب کنید.
مرحله 2 روی Custom Workflow Tasks کلیک کنید.
مرحله 3 روی Clone From Task Library کلیک کنید.
مرحله 4 در صفحه Clone from Task Library، ردیف کاری را که می خواهید شبیه سازی کنید بررسی کنید.
مرحله 5 روی انتخاب کلیک کنید.
یک وظیفه گردش کار سفارشی از کتابخانه وظیفه ایجاد می شود. وظیفه سفارشی جدید آخرین کار سفارشی در گزارش وظایف گردش کار سفارشی است. وظیفه سفارشی جدید پس از کار شبیه سازی شده با تاریخ ضمیمه نامگذاری شده است.
مرحله 6 روی ارسال کلیک کنید

بعد چه باید کرد
وظیفه گردش کار سفارشی را ویرایش کنید تا مطمئن شوید که نام و توضیحات مناسب برای کار شبیه سازی شده وجود دارد.

شبیه سازی یک وظیفه گردش کار سفارشی

می توانید از یک وظیفه گردش کار سفارشی موجود در Cisco UCS Director برای ایجاد یک کار گردش کار سفارشی استفاده کنید.

قبل از شروع
یک وظیفه گردش کار سفارشی باید در Cisco UCS Director موجود باشد.

مرحله 1 ارکستراسیون را انتخاب کنید.
مرحله 2 روی Custom Workflow Tasks کلیک کنید.
مرحله 3 روی ردیف با وظیفه گردش کار سفارشی که می‌خواهید شبیه‌سازی کنید، کلیک کنید.
نماد Clone در بالای جدول وظایف گردش کار سفارشی ظاهر می شود.
مرحله 4 روی Clone کلیک کنید.
مرحله 5 در صفحه Clone Custom Workflow Task، فیلدهای مورد نیاز را به روز کنید.
مرحله 6 روی Next کلیک کنید.
ورودی های تعریف شده برای وظایف گردش کار سفارشی ظاهر می شوند.
مرحله 7 روی ردیف با ورودی وظیفه ای که می خواهید ویرایش کنید کلیک کنید و برای ویرایش ورودی های کار روی Edit کلیک کنید.
مرحله 8 برای افزودن یک ورودی کار روی Add کلیک کنید.
مرحله 9 روی Next کلیک کنید.
خروجی های کار را ویرایش کنید.
مرحله 10 برای افزودن یک ورودی خروجی جدید روی Add کلیک کنید.
مرحله 11 روی Next کلیک کنید.
مرحله 12 اسکریپت های کنترلر را ویرایش کنید. به کنترل ورودی های وظیفه سفارشی گردش کار، در صفحه 13 مراجعه کنید.
مرحله 13 روی Next کلیک کنید.
مرحله 14 برای سفارشی کردن کار سفارشی، اسکریپت کار را ویرایش کنید.
مرحله 15 روی ارسال کلیک کنید

کنترل ورودی های وظیفه سفارشی گردش کار

استفاده از کنترلرها
می‌توانید ظاهر و رفتار ورودی‌های وظیفه سفارشی را با استفاده از رابط کنترل‌کننده موجود در Cisco UCS Director تغییر دهید.

زمان استفاده از کنترلرها
از کنترلرها در سناریوهای زیر استفاده کنید:

برای پیاده‌سازی رفتار پیچیده نمایش و پنهان کردن رابط کاربری گرافیکی، از جمله کنترل دقیق‌تر فهرست‌های مقادیر، فهرست‌های جدولی مقادیر، و سایر کنترل‌های ورودی نمایش داده شده به کاربر.
برای پیاده سازی منطق اعتبار سنجی ورودی کاربر پیچیده.

با کنترلرهای ورودی می توانید کارهای زیر را انجام دهید:

نمایش یا مخفی کردن کنترل‌های رابط کاربری گرافیکی: می‌توانید بر اساس شرایط، فیلدهای رابط کاربری گرافیکی مختلف مانند جعبه‌های انتخاب، جعبه‌های متن، فهرست‌های کشویی و دکمه‌ها را به صورت پویا نشان دهید یا پنهان کنید. برای مثالampاگر کاربر UCSM را از یک لیست کشویی انتخاب کند، می‌توانید اعتبار کاربری را برای Cisco UCS Manager درخواست کنید یا لیست مقادیر (LOVs) را در لیست کشویی تغییر دهید تا فقط پورت‌های موجود در سرور نشان داده شود.
اعتبار سنجی فیلد فرم: می توانید داده های وارد شده توسط کاربر را هنگام ایجاد یا ویرایش گردش کار در Workflow Designer تأیید کنید. برای داده های نامعتبر وارد شده توسط کاربر، می توان خطاها را نشان داد. داده های ورودی کاربر را می توان قبل از ماندگاری در پایگاه داده یا قبل از تداوم آن در دستگاه تغییر داد.
بازیابی پویا لیستی از مقادیر: می توانید به صورت پویا لیستی از مقادیر را از اشیاء Cisco UCS Director واکشی کنید و از آنها برای پر کردن اشیاء فرم GUI استفاده کنید.

Marshalling و Unmarshalling اشیاء فرم GUI
کنترلرها همیشه با یک فرم در رابط ورودی وظیفه طراح گردش کار مرتبط هستند. یک نگاشت یک به یک بین فرم و کنترلر وجود دارد. کنترلرها در دو ثانیه کار می کنندtages، marshalling و unmarshalling. هر دو سtages دو زیرمجموعه داردtages، قبل و بعد. برای استفاده از یک کنترل‌کننده، اشیاء فرم رابط کاربری گرافیکی مرتبط را با استفاده از اسکریپت‌های کنترل‌کننده، مارشال (کنترل فیلدهای فرم رابط کاربری) و/یا لغو مارشال (اعتبارسنجی ورودی‌های کاربر) می‌کنید.

جدول زیر به طور خلاصه این موارد را نشان می دهدtages

Stage	فرعی هاtage
مارشال کردن - برای مخفی کردن و آشکار کردن فیلدهای فرم و برای کنترل پیشرفته LOV ها و LOV های جدولی استفاده می شود.	قبل از مارشال — برای افزودن یا تنظیم یک فیلد ورودی و ایجاد و تنظیم پویا LOV در یک صفحه (فرم) استفاده می شود. بعد از مارشال - برای مخفی کردن یا آشکار کردن یک فیلد ورودی استفاده می شود.

Stage

فرعی هاtage

از بین بردن - برای اعتبار سنجی ورودی کاربر فرم استفاده می شود.

قبل از Unmarshall - برای تبدیل یک مقدار ورودی از یک فرم به فرم دیگر، برای مثال استفاده می شودample، برای رمزگذاری رمز عبور قبل از ارسال آن به پایگاه داده.

بعد از Unmarshall — برای تأیید اعتبار ورودی کاربر و تنظیم پیام خطا در صفحه استفاده می شود.

اسکریپت های کنترل کننده ساختمان
کنترلرها نیازی به وارد کردن بسته های اضافی ندارند.
شما پارامترها را به متدهای کنترلر منتقل نمی کنید. در عوض، فریم ورک Cisco UCS Director پارامترهای زیر را برای استفاده در مارشال کردن و حذف کردن در دسترس قرار می دهد:

پارامتر	توضیحات	Example
صفحه	صفحه یا فرمی که شامل تمام ورودی های وظیفه است. برای انجام کارهای زیر می توانید از این پارامتر استفاده کنید: مقادیر ورودی را در فرم GUI دریافت یا تنظیم کنید. نمایش یا پنهان کردن ورودی ها در یک فرم رابط کاربری گرافیکی.	page.setHidden(id + "portList"، true); page.setValue(id + ".status", "No Port is up. List Port Hidden");
id	شناسه منحصر به فرد فیلد ورودی فرم. یک شناسه توسط چارچوب تولید می شود و می تواند با نام فیلد ورودی فرم استفاده شود.	page.setValue(id + ".status", "No Port is up. Port is Hidden");// در اینجا 'status' نام فیلد ورودی است.
پوجو	POJO (شیء قدیمی جاوا) یک دانه جاوا است که یک فرم ورودی را نشان می دهد. هر صفحه رابط کاربری گرافیکی باید دارای یک POJO مربوطه باشد که مقادیر فرم را نگه می دارد. POJO برای حفظ مقادیر در پایگاه داده یا ارسال مقادیر به یک دستگاه خارجی استفاده می شود.	pojo.setLunSize(asciiValue); //مقدار فیلد ورودی 'lunSize' را تنظیم کنید

رجوع کنید به Exampدر: با استفاده از کنترلرها، در صفحه 14 برای کد کار sample که عملکرد کنترلر را نشان می دهد.

Example: استفاده از کنترلرها

کد زیر به عنوان مثالample نشان می دهد که چگونه می توان عملکرد کنترلر را در وظایف گردش کار سفارشی با استفاده از روش های مختلف - قبل از مارشال، بعد از مارشال، قبل از Unmarshall و بعد از Unmarshall پیاده سازی کرد.
/*

توضیحات روش:
قبل از مارشال: از این روش برای افزودن یا تنظیم یک فیلد ورودی و ایجاد پویا و تنظیم LOV در یک صفحه (فرم) استفاده کنید.
After Marshall: از این روش برای مخفی کردن یا عدم نمایش یک فیلد ورودی استفاده کنید.
قبل از UnMarshall: از این روش برای تبدیل مقدار ورودی از یک فرم به فرم دیگر استفاده کنید.
برای سابقample، زمانی که می خواهید رمز عبور را قبل از ارسال به پایگاه داده رمزگذاری کنید. After UnMarshall: از این روش برای تأیید اعتبار ورودی کاربر استفاده کنید و پیام خطا را روی آن تنظیم کنید
صفحه
*/
//قبل از مارشال:
/*
هنگامی که تغییری در فیلد ورودی ایجاد می شود یا برای ایجاد پویا LOV و تنظیم فیلد ورودی جدید در فرم قبل از بارگیری، از روش BeforeMarshall استفاده کنید.
در سابقampدر زیر، یک فیلد ورودی جدید "portList" قبل از نمایش فرم در مرورگر به صفحه اضافه می شود.
*/
importPackage(com.cloupia.model.cIM);
importPackage (java.util);
importPackage (java.lang)؛
var portList = new ArrayList();
var lovLabel = “eth0”;
var lovValue = “eth0”;
var portListLOV = new Array();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);//فیلد ورودی lov را ایجاد کنید
//پارامتر 'page' برای تنظیم فیلد ورودی در فرم استفاده می شود
page.setEmbeddedLOVs(id + ".portList", portListLOV);// فیلد ورودی را در فرم تنظیم کنید =========================== ================================================== ================================
//بعد از مارشال:
/*
از این روش برای مخفی کردن یا عدم نمایش یک فیلد ورودی استفاده کنید.
*/
page.setHidden(id + "portList"، true); //پنهان کردن فیلد ورودی 'portList'.
page.setValue(id + ".status", "No Port is up. List Port Hidden");
page.setEditable(id + ".status", false);
================================================== ================================================== =========
//قبل از Unmarshall:
/*
از روش BeforeUnMarshall برای خواندن ورودی کاربر و تبدیل آن به فرم دیگری قبل از درج در پایگاه داده استفاده کنید. برای مثالample، می‌توانید پسورد را بخوانید و پس از تبدیل آن به کدگذاری base64 در پایگاه داده ذخیره کنید، یا نام کارمند را بخوانید و زمانی که نام کارمند به پایگاه داده ارسال شد، آن را به شناسه کارمند تبدیل کنید.
در کد example زیر اندازه lun خوانده شده و به مقدار ASCII تبدیل می شود.
*/
importPackage(org.apache.log4j);
importPackage (java.lang)؛
importPackage (java.util);
var size = page.getValue(id + ".lunSize");
var logger = Logger.getLogger ("من لاگر");
if(size != null){
logger.info ("مقدار اندازه "+size);
if((new java.lang.String(size)). matches("\\d+")){ var byteValue = size.getBytes("US-ASCII"); // اندازه lun را تبدیل کنید و آرایه کاراکتر ASCII را دریافت کنید

var asciiValueBuilder = new StringBuilder();
برای (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
ارزش"
//id + ".lunSize" شناسه فیلد ورودی است
page.setValue(id + “.lunSize”,asciiValue); //پارامتر
"page" برای تنظیم مقدار در فیلد ورودی استفاده می شود.
pojo.setLunSize(asciiValue); //مقدار را روی pojo تنظیم کنید.
این pojo به DB یا دستگاه خارجی ارسال می شود
}
================================================== ================================================== =========
// بعد از unMarshall:
/*
از این روش برای تأیید اعتبار و تنظیم یک پیام خطا استفاده کنید.
*/
importPackage(org.apache.log4j);
importPackage (java.lang)؛
importPackage (java.util);
//var size = pojo.getLunSize();
var size = page.get Value(id + “.lunSize”);
var logger = Logger .get Logger("my logger");
logger.info ("مقدار اندازه "+size);
if (اندازه > 50) { //اندازه را تأیید کنید
صفحه تنظیم خطا(id+.lunSize)، "اندازه LUN نمی تواند بیش از 50 مگابایت باشد"؛ //تنظیم
پیغام خطا در صفحه
page .set Page Message ("اندازه LUN نمی تواند بیش از 50 مگابایت باشد");
//صفحه. تنظیم وضعیت صفحه (2);
}

استفاده از خروجی یک کار قبلی در یک گردش کار

می توانید از خروجی یک کار قبلی به عنوان ورودی برای یک کار دیگر در یک گردش کار مستقیماً از اسکریپت یک کار سفارشی و یک کار اسکریپت کلوپیا در کتابخانه وظیفه استفاده کنید.
برای دسترسی به این خروجی می توانید از یکی از راه های زیر استفاده کنید:

با استفاده از متد get Input() متغیر را از زمینه گردش کار بازیابی کنید.
به خروجی با استفاده از نماد متغیر سیستم مراجعه کنید.

برای بازیابی یک خروجی با استفاده از متد getInput() context، از:
var name = ctxt.getInput ("PreviousTaskName.outputFieldName");

برای مثالampدر:
var name = ctxt.getInput("custom_task1_1684.NAME"); // NAME نام خروجی task1 است
زمینه ای که می خواهید به آن دسترسی داشته باشید
برای بازیابی خروجی با استفاده از نماد متغیر سیستم، از:
var name = «${نام وظیفه قبلی. نام فیلد خروجی}";

برای مثالampدر:
var name = "${custom_task1_1684.NAME}"; // NAME نام فیلد خروجی task1 است که می‌خواهید به آن دسترسی داشته باشید

Example: ایجاد و اجرای یک کار سفارشی