cisco Tạo Hướng dẫn Sử dụng Tác vụ Quy trình Công việc Tùy chỉnh

Cisco UCS Director Orchestrator cung cấp một danh sách các loại đầu vào được xác định rõ cho các tác vụ tùy chỉnh. Cisco UCS Director cũng cho phép bạn tạo đầu vào quy trình công việc tùy chỉnh cho một tác vụ quy trình công việc tùy chỉnh. Bạn có thể tạo một loại đầu vào mới bằng cách sao chép và sửa đổi một loại đầu vào hiện có.

Điều kiện tiên quyết

Trước khi viết các tác vụ tùy chỉnh, bạn phải đáp ứng các điều kiện tiên quyết sau:

Cisco UCS Director đã được cài đặt và chạy trên hệ thống của bạn. Để biết thêm thông tin về cách cài đặt Cisco UCS Director, hãy tham khảo Hướng dẫn cấu hình và cài đặt Cisco UCS Director.
Bạn có một đăng nhập với quyền quản trị viên. Bạn phải sử dụng thông tin đăng nhập này khi tạo và sửa đổi các tác vụ tùy chỉnh.

Bạn phải có quyền ghi CloupiaScript để viết tác vụ tùy chỉnh bằng CloupiaScript.
Bạn phải có quyền thực thi CloupiaScript để thực thi tác vụ tùy chỉnh được tạo bằng CloupiaScript.

Tạo đầu vào quy trình công việc tùy chỉnh

Bạn có thể tạo một đầu vào tùy chỉnh cho một nhiệm vụ dòng công việc tùy chỉnh. Đầu vào được hiển thị trong danh sách các loại đầu vào mà bạn có thể ánh xạ tới các đầu vào nhiệm vụ tùy chỉnh khi bạn tạo một nhiệm vụ dòng công việc tùy chỉnh.

Bước chân 1 Chọn Dàn nhạc.

Bước chân 2 Nhấp vào Đầu vào quy trình công việc tùy chỉnh.
Bước chân 3 Nhấp vào Thêm.

Bước chân 4 Trên màn hình Thêm Đầu vào Quy trình Công việc Tùy chỉnh, hãy hoàn tất các trường sau:
- Tên loại đầu vào tùy chỉnh—Một tên duy nhất cho loại đầu vào tùy chỉnh.
- Loại đầu vào—Kiểm tra loại đầu vào và nhấp vào Chọn. Dựa trên đầu vào đã chọn, các trường khác sẽ xuất hiện. Đối với người yêu cũample, khi bạn chọn Địa chỉ Email làm loại đầu vào, một danh sách các giá trị (LOV) sẽ xuất hiện. Sử dụng các trường mới để giới hạn giá trị của đầu vào tùy chỉnh.
Bước 5 Nhấp vào Gửi.

Đầu vào quy trình công việc tùy chỉnh được thêm vào Giám đốc Cisco UCS và có sẵn trong danh sách các loại đầu vào.

Xác thực đầu vào tùy chỉnh

Khách hàng có thể cần xác thực đầu vào quy trình làm việc bằng các tài nguyên bên ngoài. Ngoài hộp, Giám đốc Cisco UCS không thể đáp ứng mọi nhu cầu xác thực của khách hàng. Để lấp đầy khoảng trống này, Giám đốc Cisco UCS cung cấp một tùy chọn để xác thực bất kỳ đầu vào nào trong thời gian chạy bằng cách sử dụng tập lệnh do khách hàng cung cấp. Tập lệnh có thể gắn cờ lỗi trong đầu vào và có thể yêu cầu đầu vào hợp lệ trước khi chạy yêu cầu dịch vụ. Tập lệnh có thể được viết bằng bất kỳ ngôn ngữ nào, có thể truy cập vào bất kỳ tài nguyên bên ngoài nào và có quyền truy cập vào tất cả các giá trị đầu vào của quy trình công việc.
Bạn có thể viết tập lệnh xác thực tùy chỉnh bằng JavaScript, Python, tập lệnh bash shell hoặc bất kỳ ngôn ngữ tập lệnh nào khác.

Các ví dụ sau đâyamptập lệnh xác thực tập tin có thể được tìm thấy trong Giám đốc Cisco UCS trong Dàn nhạc > Đầu vào quy trình công việc tùy chỉnh:

Example-bash-script-xác nhận

Examptrình xác thực le-javascript
Examptrình xác thực le-python

Bạn có thể sao chép hoặc sao chép example đầu vào quy trình làm việc theo kịch bản để tạo đầu vào mới được xác thực. Bạn cũng có thể sử dụng example đầu vào quy trình làm việc theo kịch bản làm hướng dẫn để phát triển các tập lệnh của riêng bạn.

Bất kể ngôn ngữ tập lệnh là gì, các tính năng và quy tắc sau áp dụng cho xác thực đầu vào tùy chỉnh theo tập lệnh:

Tất cả xác thực theo tập lệnh được chạy trong một quy trình riêng biệt, do đó, quy trình xác thực không thành công sẽ không ảnh hưởng đến quy trình Giám đốc Cisco UCS.
Chỉ các kiểu nhập văn bản chung mới có thể được xác thực bằng tập lệnh.

Các tập lệnh xác thực được chạy lần lượt, theo thứ tự, theo cùng thứ tự mà đầu vào xuất hiện trong trang đầu vào của quy trình làm việc. Một quy trình riêng biệt được khởi chạy cho từng đầu vào đã được xác thực.
Giá trị trả về khác không từ tập lệnh cho biết xác thực không thành công. Theo tùy chọn, bạn có thể chuyển thông báo lỗi trở lại biểu mẫu nhập quy trình làm việc.

Tất cả đầu vào của quy trình công việc được chuyển đến tập lệnh xác thực theo hai cách:
- Làm đối số cho tập lệnh ở dạng “key”=”value”.
- Là các biến môi trường cho quy trình tập lệnh. Tên biến là nhãn đầu vào.
  Ví dụample, nếu quy trình công việc có đầu vào được gắn nhãn là Mã sản phẩm và giá trị đầu vào là AbC123, thì biến đó được chuyển đến tập lệnh trình xác thực là “Mã sản phẩm”=”AbC123”.
  Các biến đầu vào này có thể được sử dụng bởi tập lệnh nếu cần thiết để triển khai xác thực. Ngoại lệ: Giá trị bảng chỉ chứa số hàng của lựa chọn bảng và do đó có thể vô dụng.
Trang Chỉnh sửa Đầu vào Quy trình Công việc Tùy chỉnh làm cho tập lệnh có sẵn trong trình chỉnh sửa Tác vụ Tùy chỉnh. Cú pháp được đánh dấu cho tất cả các ngôn ngữ. Lỗi cú pháp chỉ được kiểm tra đối với trình xác thực JavaScript.

Nhân bản đầu vào quy trình công việc tùy chỉnh

Bạn có thể sử dụng đầu vào quy trình công việc tùy chỉnh hiện có trong Cisco UCS Director để tạo đầu vào quy trình công việc tùy chỉnh.

Trước khi bạn bắt đầu
Đầu vào quy trình làm việc tùy chỉnh phải có sẵn trong Cisco UCS Director.

Bước chân 1 Chọn Dàn nhạc.
Bước chân 2 Nhấp vào Đầu vào quy trình công việc tùy chỉnh.
Bước chân 3 Nhấp vào hàng có đầu vào quy trình công việc tùy chỉnh sẽ được sao chép.
Biểu tượng Bản sao xuất hiện ở đầu bảng đầu vào quy trình công việc tùy chỉnh.
Bước chân 4 Nhấp vào Sao chép.
Bước chân 5 Nhập tên loại đầu vào tùy chỉnh.
Bước chân 6 Sử dụng các điều khiển khác trong màn hình Đầu vào quy trình công việc tùy chỉnh sao chép để tùy chỉnh đầu vào mới.
Bước chân 7 Nhấp vào Gửi.
Đầu vào nhiệm vụ dòng công việc tùy chỉnh được sao chép sau khi xác nhận và có sẵn để sử dụng trong nhiệm vụ dòng công việc tùy chỉnh.

Tạo một nhiệm vụ tùy chỉnh

Để tạo một tác vụ tùy chỉnh, hãy làm như sau:

Bước chân 1 Chọn Dàn nhạc.
Bước chân 2 Nhấp vào Nhiệm vụ quy trình công việc tùy chỉnh.
Bước chân 3 Nhấp vào Thêm.
Bước chân 4 Trên màn hình Thêm tác vụ dòng công việc tùy chỉnh, hãy hoàn tất các trường sau:
- Trường Tên nhiệm vụ—Một tên duy nhất cho nhiệm vụ dòng công việc tùy chỉnh.
- Trường Nhãn nhiệm vụ—Nhãn để xác định nhiệm vụ dòng công việc tùy chỉnh.
- Trường Đăng ký theo Danh mục—Danh mục quy trình công việc mà nhiệm vụ quy trình công việc tùy chỉnh phải được đăng ký.
- Kích hoạt hộp kiểm Nhiệm vụ—Nếu được chọn, nhiệm vụ dòng công việc tùy chỉnh được đăng ký với Orchestrator và có thể sử dụng ngay trong dòng công việc.
- Trường Mô tả Tóm tắt—Mô tả về nhiệm vụ dòng công việc tùy chỉnh.
- Trường Mô tả chi tiết—Mô tả chi tiết về nhiệm vụ dòng công việc tùy chỉnh.

Bước chân 5 Nhấp vào Tiếp theo.
Màn hình Nhập tác vụ tùy chỉnh xuất hiện.
Bước chân 6 Nhấp vào Thêm.
Bước chân 7 Trên màn hình Add Entry to Inputs, hoàn thành các trường sau:
- Trường Tên trường nhập—Một tên duy nhất cho trường. Tên phải bắt đầu bằng ký tự anphabetic và không được chứa dấu cách hoặc ký tự đặc biệt.
- Trường nhãn trường nhập—Nhãn để xác định trường nhập.
- Danh sách thả xuống Loại trường đầu vào—Chọn loại dữ liệu của tham số đầu vào.
- Trường Ánh xạ tới Loại Đầu vào (Không Ánh xạ)—Chọn loại đầu vào mà trường này có thể được ánh xạ tới, nếu trường này có thể được ánh xạ từ một đầu ra tác vụ khác hoặc đầu vào quy trình công việc chung.
- Hộp kiểm bắt buộc— Nếu được chọn, người dùng phải cung cấp giá trị cho trường này.
- Trường RBID—Nhập chuỗi RBID cho trường.
- Danh sách thả xuống Kích thước trường đầu vào—Chọn kích thước trường cho đầu vào dạng văn bản và dạng bảng.
- Trường nhập liệu Trợ giúp—(Tùy chọn) Mô tả được hiển thị khi bạn di chuột qua trường này.
- Trường chú thích của trường nhập—(Tùy chọn) Văn bản gợi ý cho trường nhập.
- Trường Tên nhóm trường—Nếu được chỉ định, tất cả các trường có tên nhóm phù hợp sẽ được đưa vào nhóm trường.
- Khu vực THUỘC TÍNH TRƯỜNG VĂN BẢN—Hoàn thành các trường sau khi loại trường nhập là văn bản.
- Hộp kiểm Nhiều đầu vào—Nếu được chọn, trường đầu vào chấp nhận nhiều giá trị dựa trên loại trường đầu vào:
- Đối với LOV—Trường đầu vào chấp nhận nhiều giá trị đầu vào.
- Đối với trường văn bản—Trường nhập trở thành trường văn bản nhiều dòng.
- Độ dài tối đa của trường nhập—Chỉ định số lượng ký tự tối đa mà bạn có thể nhập vào trường nhập.
- Khu vực LOV ATTRIBUTES—Hoàn thành các trường sau khi loại đầu vào là Danh sách giá trị (LOV) hoặc LOV bằng các nút Radio.
- Trường danh sách giá trị—Danh sách giá trị được phân tách bằng dấu phẩy cho các LOV được nhúng.
  Trường Tên nhà cung cấp LOV—Tên của nhà cung cấp LOV cho các LOV không được nhúng.
- Khu vực THUỘC TÍNH BẢNG—Hoàn thành các trường sau khi loại trường nhập là Bảng, Bảng bật lên hoặc hộp kiểm Bảng có lựa chọn.
- Trường Tên bảng—Tên của báo cáo dạng bảng cho các loại trường bảng.
- Vùng XÁC THỰC ĐẦU VÀO TRƯỜNG—Một hoặc nhiều trường sau được hiển thị tùy thuộc vào loại dữ liệu bạn đã chọn. Hoàn thành các trường để chỉ định cách các trường đầu vào được xác thực.
- Danh sách thả xuống Trình xác thực đầu vào—Chọn một trình xác thực cho đầu vào của người dùng.
- Trường Biểu thức chính quy—Mẫu biểu thức chính quy để khớp với giá trị đầu vào.
- Trường Thông báo biểu thức chính quy—Một thông báo hiển thị khi xác thực biểu thức chính quy không thành công.
- Trường Giá trị tối thiểu—Một giá trị số tối thiểu.
- Trường Giá trị Tối đa—Một giá trị số tối đa.
- Khu vực ẨN TRÊN ĐIỀU KIỆN TRƯỜNG—Hoàn thành các trường sau để đặt điều kiện ẩn trường trong biểu mẫu.
- Ẩn trên trường Tên trường—Tên nội bộ của trường để chương trình xử lý biểu mẫu có thể xác định trường.
- Ẩn trường giá trị trên trường—Giá trị phải được gửi sau khi biểu mẫu được gửi.
- Danh sách thả xuống Ẩn Trên Điều kiện Trường—Chọn một điều kiện tại đó trường phải được ẩn.
- Trường trợ giúp HTML—Hướng dẫn trợ giúp cho trường ẩn.

Bước chân 8 Nhấp vào Gửi.
Mục nhập được thêm vào bảng.
Bước chân 9 Nhấp vào Thêm để thêm nhiều mục vào đầu vào.
Bước chân 10 Khi bạn hoàn tất việc thêm đầu vào, hãy nhấp vào Tiếp theo.
Màn hình Đầu ra Nhiệm vụ Dòng công việc Tùy chỉnh xuất hiện.

Bước chân 11 Nhấp vào Thêm.
Bước chân 12 Trên màn hình Add Entry to Outputs, hoàn thành các trường sau:
- Trường Tên trường đầu ra —Một tên duy nhất cho trường đầu ra. Nó phải bắt đầu bằng một ký tự chữ cái và không được chứa khoảng trắng hoặc ký tự đặc biệt.
- Trường đầu ra Trường mô tả —Mô tả của trường đầu ra.
- Trường Loại trường đầu ra—Kiểm tra loại đầu ra. Loại này xác định cách đầu ra có thể được ánh xạ tới các đầu vào tác vụ khác.
Bước chân 13 Nhấp vào Gửi.
Mục đầu ra được thêm vào bảng.

Bước chân 14 Nhấp vào Thêm để thêm mục vào đầu ra.
Bước chân 15 Nhấp vào Tiếp theo
Màn hình Bộ điều khiển xuất hiện
Bước chân 16 (Tùy chọn) Nhấp vào Thêm để thêm bộ điều khiển.

Bước chân 17 Trên màn hình Add Entry to Controller, hoàn thành các trường sau:
- Danh sách thả xuống phương pháp—Chọn phương pháp sắp xếp theo thứ tự hoặc không theo thứ tự để tùy chỉnh đầu vào và/hoặc đầu ra cho tác vụ quy trình công việc tùy chỉnh. Phương pháp này có thể là một trong những cách sau:
- Trước Marshall—Sử dụng phương pháp này để thêm hoặc đặt trường nhập và tự động tạo và đặt LOV trên một trang (biểu mẫu).
- After Marshall—Sử dụng phương pháp này để ẩn hoặc bỏ ẩn trường nhập liệu.
- Before Unmarshall—Sử dụng phương pháp này để chuyển đổi giá trị đầu vào từ dạng này sang dạng khác—ví dụ:ample, khi bạn muốn mã hóa mật khẩu trước khi gửi nó vào cơ sở dữ liệu.
- Sau Unmarshall—Sử dụng phương pháp này để xác thực thông tin nhập của người dùng và đặt thông báo lỗi trên trang.
  xem người yêu cũamplê: Sử dụng Bộ điều khiển, ở trang 14.
- Vùng văn bản tập lệnh—Đối với phương pháp bạn đã chọn từ danh sách thả xuống Phương pháp, hãy thêm mã cho tập lệnh tùy chỉnh GUI.
  Ghi chú Nhấp vào Thêm nếu bạn muốn thêm mã cho nhiều phương pháp hơn.
  Nếu có bất kỳ xác thực nào đối với mật khẩu đã nhập, hãy đảm bảo thay đổi xác thực của bộ điều khiển cho mật khẩu để bạn có thể chỉnh sửa các tác vụ tùy chỉnh trong quy trình công việc.
  Ghi chú
Bước chân 18 Nhấp vào Gửi.
Bộ điều khiển được thêm vào bảng.
Bước chân 19 Nhấp vào Tiếp theo.
Màn hình Tập lệnh xuất hiện.

Bước chân 20 Từ danh sách thả xuống Ngôn ngữ thực thi, hãy chọn một ngôn ngữ.
Bước chân 21 Trong trường Tập lệnh, hãy nhập mã CloupiaScript cho tác vụ quy trình công việc tùy chỉnh.
Mã Cloupia Script được xác thực khi bạn nhập mã. Nếu có bất kỳ lỗi nào trong mã, biểu tượng lỗi (chữ thập đỏ) sẽ hiển thị bên cạnh số dòng. Rê chuột lên biểu tượng lỗi để view thông báo lỗi và giải pháp
Bước chân 22 Nhấp vào Lưu tập lệnh.

Bước chân 23 Nhấp vào Gửi.
Nhiệm vụ dòng công việc tùy chỉnh được tạo và có sẵn để sử dụng trong dòng công việc

Nhiệm vụ và kho lưu trữ tùy chỉnh

Khi bạn tạo một tác vụ tùy chỉnh, thay vì nhập mã tác vụ tùy chỉnh vào cửa sổ tập lệnh hoặc cắt và dán mã từ trình soạn thảo văn bản, bạn có thể nhập mã từ một file được lưu trữ trong kho lưu trữ GitHub hoặc BitBucket. Để làm điều này, bạn:

Tạo một hoặc nhiều văn bản files trong kho lưu trữ GitHub hoặc BitBucket, trong github.com hoặc kho lưu trữ GitHub của doanh nghiệp tư nhân.
Lưu ý Giám đốc Cisco UCS chỉ hỗ trợ GitHub (github.com hoặc phiên bản GitHub dành cho doanh nghiệp) và hoặc BitBucket. Nó không hỗ trợ các dịch vụ lưu trữ Git khác bao gồm GitLab, Perforce hoặc Codebase.

Đăng ký kho lưu trữ trong Giám đốc Cisco UCS. Xem Thêm Kho lưu trữ GitHub hoặc BitBucket trong Giám đốc Cisco UCS, ở trang 7.
Chọn kho lưu trữ và chỉ định văn bản file có chứa tập lệnh tác vụ tùy chỉnh. Xem Tải xuống Mã tập lệnh tác vụ tùy chỉnh từ Kho lưu trữ GitHub hoặc BitBucket, ở trang 8.

Thêm Kho lưu trữ GitHub hoặc BitBucket trong Cisco UCS Director
Để đăng ký kho lưu trữ GitHub hoặc BitBucket trong Cisco UCS Director, hãy làm như sau:

Trước khi bạn bắt đầu
Tạo kho lưu trữ GitHub hoặc BitBucket. Kho lưu trữ có thể nằm trên bất kỳ máy chủ GitHub hoặc BitBucket nào, công khai hoặc riêng tư mà Giám đốc Cisco UCS của bạn có thể truy cập được.
Đăng ký một hoặc nhiều files chứa mã JavaScript cho các tác vụ tùy chỉnh của bạn vào kho lưu trữ của bạn.

Bước chân 1 Chọn Quản trị > Tích hợp.
Bước chân 2 Trên trang Tích hợp, nhấp vào Quản lý kho lưu trữ.

Bước chân 3 Nhấp vào Thêm.
Bước chân 4 Trên trang Thêm kho lưu trữ, hãy hoàn tất các trường bắt buộc, bao gồm các trường sau:
- Trong trường Tên hiệu kho lưu trữ, hãy nhập tên để xác định kho lưu trữ trong Giám đốc Cisco UCS.
- Trong kho lưu trữ URL lĩnh vực, nhập URL của kho lưu trữ GitHub hoặc BitBucket.
- Trong trường Tên nhánh, hãy nhập tên của nhánh kho lưu trữ mà bạn muốn sử dụng. Tên mặc định là nhánh chính.
- Trong trường Người dùng Kho lưu trữ, hãy nhập tên người dùng cho tài khoản GitHub hoặc BitBucket của bạn.
- Để thêm kho lưu trữ GitHub, trong trường Mật khẩu/Mã thông báo API, hãy nhập mã thông báo API đã tạo cho GitHub của bạn.
  Để tạo mã thông báo API bằng GitHub, nhấp vào Cài đặt và điều hướng đến Cài đặt dành cho nhà phát triển > Mã thông báo truy cập cá nhân và nhấp vào Tạo mã thông báo mới.
  Để Lưu ý thêm kho lưu trữ BitBucket, trong trường Mật khẩu/Mã thông báo API, hãy nhập mật khẩu cho BitBucket của bạn.
- Để đặt mặc định cho kho lưu trữ này khi bạn tạo tác vụ tùy chỉnh mới, hãy chọn Đặt kho lưu trữ này làm kho lưu trữ mặc định của tôi.
- Để kiểm tra xem Giám đốc Cisco UCS có thể truy cập vào kho lưu trữ hay không, hãy nhấp vào Kiểm tra kết nối.
  Trạng thái kết nối với kho lưu trữ được hiển thị trong biểu ngữ ở đầu trang.
  Nếu bạn không thể kết nối và liên lạc với kho lưu trữ GitHub hoặc BitBucket từ Cisco UCS
  Giám đốc, hãy cập nhật Giám đốc Cisco UCS để truy cập Internet thông qua máy chủ proxy. Xem Hướng dẫn Quản trị Giám đốc Cisco UCS.
  Ghi chú

Bước chân 5 Khi bạn hài lòng rằng thông tin kho lưu trữ là chính xác, hãy nhấp vào Gửi.

Tải xuống Mã tập lệnh tác vụ tùy chỉnh từ Kho lưu trữ GitHub hoặc BitBucket

Để tạo tác vụ tùy chỉnh mới bằng cách nhập văn bản từ kho lưu trữ GitHub hoặc BitBucket, hãy làm như sau:

Trước khi bạn bắt đầu
Tạo kho lưu trữ GitHub hoặc BitBucket và kiểm tra một hoặc nhiều văn bản files chứa mã JavaScript cho các tác vụ tùy chỉnh của bạn vào kho lưu trữ của bạn.

Thêm kho lưu trữ GitHub vào Giám đốc Cisco UCS. Xem Thêm Kho lưu trữ GitHub hoặc BitBucket trong Cisco UCS Director, trên trang

Bước chân 1 Trên trang Điều phối, nhấp vào Nhiệm vụ Quy trình Công việc Tùy chỉnh.

Bước chân 2 Nhấp vào Thêm.
Bước chân 3 Hoàn thành các trường bắt buộc trên trang Thông tin tác vụ tùy chỉnh. Xem Tạo tác vụ tùy chỉnh, ở trang 3.
Bước chân 4 Hoàn thành các trường bắt buộc trên trang Nhập tác vụ tùy chỉnh. Xem Tạo Tác vụ Tùy chỉnh, ở trang 3.

Bước chân 5 Hoàn thành các trường bắt buộc trên trang Kết quả tác vụ tùy chỉnh. Xem Tạo tác vụ tùy chỉnh, ở trang 3.
Bước chân 6 Hoàn thành các trường bắt buộc trên trang Bộ điều khiển. Xem Tạo tác vụ tùy chỉnh, ở trang 3.
Bước chân 7 Trên trang Tập lệnh, hoàn thành các trường bắt buộc:
- Từ danh sách thả xuống Ngôn ngữ thực thi, hãy chọn JavaScript.
- Kiểm tra Sử dụng Kho lưu trữ cho Tập lệnh để cho phép tác vụ tùy chỉnh sử dụng tập lệnh file từ một kho lưu trữ. Điều này cho phép bạn chọn kho lưu trữ và chỉ định tập lệnh file để sử dụng.
- Từ danh sách thả xuống Chọn Kho lưu trữ, chọn kho lưu trữ GitHub hoặc BitBucket chứa tập lệnh fileS. Để biết chi tiết về cách thêm kho lưu trữ, hãy xem Thêm Kho lưu trữ GitHub hoặc BitBucket trong Giám đốc Cisco UCS, trên trang 7.
- Nhập đường dẫn đầy đủ đến tập lệnh file trong kịch bản filetrường văn bản tên.
- Để tải xuống tập lệnh, hãy nhấp vào Tải tập lệnh.
  Văn bản từ file được sao chép trong khu vực chỉnh sửa văn bản Tập lệnh.
- Tùy chọn, thực hiện các thay đổi đối với tập lệnh đã tải xuống trong khu vực chỉnh sửa văn bản Tập lệnh.
- Để lưu tập lệnh khi nó xuất hiện trong khu vực chỉnh sửa văn bản Tập lệnh, hãy nhấp vào Lưu Tập lệnh.
  Khi bạn nhấn Lưu Tập lệnh, tập lệnh sẽ được lưu vào phiên làm việc hiện tại của bạn. Bạn phải nhấp vào Gửi để lưu tập lệnh vào tác vụ tùy chỉnh mà bạn đang chỉnh sửa.
  Ghi chú
Bước chân 8 Để lưu tác vụ tùy chỉnh, hãy nhấp vào Gửi.
Nếu bạn đã thực hiện các thay đổi đối với tập lệnh đã tải xuống trong khu vực chỉnh sửa văn bản Tập lệnh, các thay đổi sẽ được lưu vào tác vụ tùy chỉnh. Không có thay đổi nào được lưu vào kho lưu trữ GitHub hoặc BitBucket. Nếu bạn muốn loại bỏ tập lệnh đã tải và nhập tập lệnh của riêng mình, hãy nhấp vào Hủy bỏ tập lệnh để xóa cửa sổ tập lệnh.

Tiếp theo phải làm gì
Bạn có thể sử dụng tác vụ tùy chỉnh mới trong quy trình làm việc.

Nhập quy trình công việc, nhiệm vụ tùy chỉnh, mô-đun tập lệnh và hoạt động

Để nhập các tạo phẩm vào Giám đốc Cisco UCS, hãy làm như sau:

Ghi chú Các biến chung được liên kết với quy trình làm việc sẽ được nhập trong khi nhập quy trình làm việc nếu biến chung không có sẵn trong công cụ.

Bước chân 1 Chọn Dàn nhạc.

Bước chân 2 Trên trang Phối hợp, nhấp vào Quy trình công việc.
Bước chân 3 Nhấp vào Nhập.
Bước chân 4 Trên màn hình Nhập, nhấp vào Chọn một File.

Bước chân 5 Trên Chọn File đến màn hình Tải lên, chọn file được nhập khẩu. Giám đốc Cisco UCS nhập và xuất filecó một .wfdx file sự mở rộng.
Bước chân 6 Bấm Mở.
Khi file được tải lên, File Màn hình Tải lên/Xác thực hiển thị File sẵn sàng để sử dụng và Key.
Bước chân 7 Nhập khóa đã được nhập khi xuất tệp file.

Bước chân 8 Nhấp vào Tiếp theo.
Màn hình Chính sách nhập hiển thị danh sách các đối tượng Giám đốc Cisco UCS có trong tệp đã tải lên file.
Bước chân 9 (Tùy chọn) Trên màn hình Chính sách nhập, chỉ định cách xử lý các đối tượng nếu chúng trùng tên đã có trong thư mục quy trình làm việc. Trên màn hình Nhập, hoàn thành các trường sau

Tên	Sự miêu tả
Quy trình làm việc	Chọn từ các tùy chọn sau để chỉ định cách xử lý các quy trình công việc có tên giống hệt nhau: Thay thế—Thay thế quy trình công việc hiện tại bằng quy trình công việc đã nhập. Giữ cả hai—Nhập quy trình làm việc dưới dạng phiên bản mới. Nhảy—Không nhập quy trình làm việc.
Nhiệm vụ tùy chỉnh	Chọn từ các tùy chọn sau để chỉ định cách xử lý các tác vụ tùy chỉnh có tên giống hệt nhau: Thay thế Giữ cả hai Nhảy

Tên	Sự miêu tả
Mô-đun tập lệnh	Chọn từ các tùy chọn sau để chỉ định cách xử lý các mô-đun tập lệnh có tên giống hệt nhau: Thay thế Giữ cả hai Nhảy
Các hoạt động	Chọn từ các tùy chọn sau để chỉ định cách xử lý các hoạt động có tên giống hệt nhau: Thay thế Giữ cả hai Nhảy
Nhập quy trình làm việc vào thư mục	Check Nhập dòng công việc vào thư mục để nhập dòng công việc. Nếu bạn không chọn Nhập quy trình làm việc vào thư mục và nếu không có phiên bản quy trình làm việc hiện ców tồn tại, luồng công việc đó không được nhập.
Chọn thư mục	Chọn một thư mục để nhập quy trình làm việc. Nếu bạn chọn [Mới Thư mục..] trong danh sách thả xuống, Thư mục mới trường xuất hiện.
Thư mục mới	Nhập tên của thư mục mới để tạo làm thư mục nhập của bạn.

Bước chân 10 Nhấp vào Nhập.

Xuất quy trình công việc, nhiệm vụ tùy chỉnh, mô-đun tập lệnh và hoạt động

Để xuất các tạo phẩm từ Giám đốc Cisco UCS, hãy làm như sau:

Lưu ý Các biến toàn cầu được liên kết với quy trình làm việc sẽ được xuất tự động trong khi xuất quy trình làm việc.

Bước chân 1 Nhấp vào Xuất.
Bước chân 2 Trên màn hình Chọn quy trình công việc, hãy chọn quy trình công việc mà bạn muốn xuất.
Các quy trình công việc, tác vụ và tập lệnh tùy chỉnh được tạo trong Cisco UCS Director trước phiên bản 6.6 có thể không nhập được nếu chúng chứa dữ liệu XML.
Ghi chú
Bước chân 3 Nhấp vào Tiếp theo.
Bước chân 4 Trên màn hình Chọn tác vụ tùy chỉnh, hãy chọn tác vụ tùy chỉnh mà bạn muốn hiển thị
Lưu ý Tác vụ tùy chỉnh đã xuất chứa tất cả các đầu vào tùy chỉnh được sử dụng bởi tác vụ tùy chỉnh đó.
Bước chân 5 Nhấp vào Tiếp theo.
Bước chân 6 Trên màn hình Xuất: Chọn Mô-đun tập lệnh, chọn mô-đun tập lệnh mà bạn muốn xuất.
Bước chân 7 Nhấp vào Tiếp theo.
Bước chân 8 Trên màn hình Xuất: Chọn Hoạt động, chọn các hoạt động mà bạn muốn xuất.
Bước chân 9 Nhấp vào Tiếp theo.
Bước chân 10 Trên màn hình Xuất: Chọn Mở API, chọn API bạn muốn xuất.
Bước chân 11 Trên màn hình Xuất: Xác nhận, hãy điền vào các trường sau:

Tên	Sự miêu tả
Xuất bởi	Tên của bạn hoặc ghi chú về người chịu trách nhiệm xuất khẩu.
Bình luận	Nhận xét về xuất khẩu này.
Mã hóa xuất khẩu file	Kiểm tra Mã hóa tệp đã xuất file hộp kiểm để mã hóa file được xuất khẩu. Theo mặc định, hộp kiểm được chọn.
Chìa khóa	Nhập khóa để mã hóa file. Trường này chỉ được hiển thị khi Mã hóa tệp đã xuất file hộp kiểm được chọn. Giữ nguyên khóa khi cần trong khi nhập quy trình làm việc để giải mã.
Xác nhận khóa	Nhập lại khóa để xác nhận. Trường này chỉ được hiển thị khi Mã hóa tệp đã xuất file hộp kiểm được chọn.
Đã xuất khẩu File Tên	Tên của file trên hệ thống cục bộ của bạn. Chỉ nhập cơ sở filetên; các file phần mở rộng loại (.wfdx) được tự động thêm vào.

Bước chân 12 Nhấp vào Xuất.
Bạn được nhắc lưu file.

Nhân bản Nhiệm vụ Dòng công việc Tùy chỉnh từ Thư viện Tác vụ

Bạn có thể sao chép các nhiệm vụ trong thư viện nhiệm vụ để sử dụng trong việc tạo các nhiệm vụ tùy chỉnh. Bạn cũng có thể sao chép tác vụ tùy chỉnh để tạo tác vụ tùy chỉnh.

Tác vụ nhân bản là một khung có cùng đầu vào và đầu ra của tác vụ như tác vụ ban đầu. Tuy nhiên, tác vụ nhân bản chỉ là một khung. Điều này có nghĩa là bạn phải viết tất cả chức năng cho tác vụ mới trong CloupiaScript.

Cũng lưu ý rằng các giá trị lựa chọn cho đầu vào danh sách, chẳng hạn như danh sách thả xuống và danh sách giá trị, chỉ được chuyển sang tác vụ nhân bản nếu các giá trị danh sách không phụ thuộc vào hệ thống. Những thứ như tên và địa chỉ IP của các hệ thống hiện có phụ thuộc vào hệ thống; những thứ như tùy chọn cấu hình được Cisco UCS Director hỗ trợ thì không. Đối với người yêu cũampTập tin, nhóm người dùng, tên đám mây và nhóm cổng phụ thuộc vào hệ thống; vai trò người dùng, loại đám mây và loại nhóm cổng thì không.

Bước chân 1 Chọn Dàn nhạc.
Bước chân 2 Nhấp vào Nhiệm vụ quy trình công việc tùy chỉnh.
Bước chân 3 Nhấp vào Sao chép từ Thư viện tác vụ.
Bước chân 4 Trên màn hình Sao chép từ Thư viện tác vụ, hãy chọn hàng có tác vụ mà bạn muốn sao chép.
Bước chân 5 Nhấp vào Chọn.
Nhiệm vụ dòng công việc tùy chỉnh được tạo từ thư viện nhiệm vụ. Nhiệm vụ tùy chỉnh mới là nhiệm vụ tùy chỉnh cuối cùng trong báo cáo Nhiệm vụ quy trình làm việc tùy chỉnh. Tác vụ tùy chỉnh mới được đặt tên theo tác vụ được sao chép, với ngày được thêm vào.
Bước chân 6 Nhấp vào Gửi

Tiếp theo phải làm gì
Chỉnh sửa tác vụ dòng công việc tùy chỉnh để đảm bảo rằng tên và mô tả thích hợp được đặt đúng chỗ cho tác vụ nhân bản.

Nhân bản Nhiệm vụ Quy trình Công việc Tùy chỉnh

Bạn có thể sử dụng tác vụ quy trình công việc tùy chỉnh hiện có trong Cisco UCS Director để tạo tác vụ quy trình công việc tùy chỉnh.

Trước khi bạn bắt đầu
Nhiệm vụ quy trình công việc tùy chỉnh phải có sẵn trong Giám đốc Cisco UCS.

Bước chân 1 Chọn Dàn nhạc.
Bước chân 2 Nhấp vào Nhiệm vụ quy trình công việc tùy chỉnh.
Bước chân 3 Bấm vào hàng có nhiệm vụ dòng công việc tùy chỉnh mà bạn muốn sao chép.
Biểu tượng Bản sao xuất hiện ở đầu bảng nhiệm vụ dòng công việc tùy chỉnh.
Bước chân 4 Nhấp vào Sao chép.
Bước chân 5 Trên màn hình Tác vụ quy trình công việc tùy chỉnh sao chép, hãy cập nhật các trường bắt buộc.
Bước chân 6 Nhấp vào Tiếp theo.
Đầu vào được xác định cho các tác vụ quy trình công việc tùy chỉnh sẽ xuất hiện.
Bước chân 7 Nhấp vào hàng có đầu vào nhiệm vụ mà bạn muốn chỉnh sửa và nhấp vào Chỉnh sửa để chỉnh sửa đầu vào nhiệm vụ.
Bước chân 8 Nhấp vào Thêm để thêm mục nhập nhiệm vụ.
Bước chân 9 Nhấp vào Tiếp theo.
Chỉnh sửa kết quả đầu ra của nhiệm vụ.
Bước chân 10 Nhấp vào Thêm để thêm mục nhập đầu ra mới.
Bước chân 11 Nhấp vào Tiếp theo.
Bước chân 12 Chỉnh sửa tập lệnh điều khiển. Xem Kiểm soát đầu vào tác vụ quy trình công việc tùy chỉnh, ở trang 13.
Bước chân 13 Nhấp vào Tiếp theo.
Bước chân 14 Để tùy chỉnh tác vụ tùy chỉnh, hãy chỉnh sửa tập lệnh tác vụ.
Bước chân 15 Nhấp vào Gửi

Kiểm soát đầu vào nhiệm vụ quy trình công việc tùy chỉnh

Sử dụng bộ điều khiển
Bạn có thể sửa đổi giao diện và hành vi của đầu vào tác vụ tùy chỉnh bằng giao diện bộ điều khiển có sẵn trong Cisco UCS Director.

Khi nào nên sử dụng bộ điều khiển
Sử dụng bộ điều khiển trong các trường hợp sau:

Để thực hiện hành vi GUI hiển thị và ẩn phức tạp, bao gồm kiểm soát tốt hơn các danh sách giá trị, danh sách giá trị dạng bảng và các điều khiển đầu vào khác được hiển thị cho người dùng.
Để thực hiện logic xác thực đầu vào của người dùng phức tạp.

Với bộ điều khiển đầu vào, bạn có thể làm như sau:

Hiển thị hoặc ẩn các điều khiển GUI: Bạn có thể tự động hiển thị hoặc ẩn các trường GUI khác nhau, chẳng hạn như hộp kiểm, hộp văn bản, danh sách thả xuống và nút, dựa trên các điều kiện. Đối với người yêu cũample, nếu người dùng chọn UCSM từ danh sách thả xuống, bạn có thể nhắc nhập thông tin đăng nhập của người dùng cho Cisco UCS Manager hoặc thay đổi danh sách giá trị (LOV) trong danh sách thả xuống để chỉ hiển thị các cổng khả dụng trên máy chủ.
Xác thực trường biểu mẫu: Bạn có thể xác thực dữ liệu do người dùng nhập khi tạo hoặc chỉnh sửa quy trình công việc trong Trình thiết kế quy trình làm việc. Đối với dữ liệu không hợp lệ do người dùng nhập, lỗi có thể được hiển thị. Dữ liệu đầu vào của người dùng có thể được thay đổi trước khi nó được lưu trong cơ sở dữ liệu hoặc trước khi nó được lưu vào thiết bị.
Tự động truy xuất danh sách các giá trị: Bạn có thể tự động tìm nạp danh sách các giá trị từ các đối tượng Cisco UCS Director và sử dụng chúng để điền các đối tượng biểu mẫu GUI.

Sắp xếp lại và sắp xếp lại các đối tượng biểu mẫu GUI
Bộ điều khiển luôn được liên kết với một biểu mẫu trong giao diện đầu vào tác vụ của Trình thiết kế quy trình làm việc. Có một ánh xạ một-một giữa biểu mẫu và bộ điều khiển. Bộ điều khiển hoạt động trong hai giâytages, sắp xếp theo thứ tự và không sắp xếp. cả stages có hai phụtages, trước và sau. Để sử dụng bộ điều khiển, bạn sắp xếp lại (kiểm soát các trường biểu mẫu giao diện người dùng) và/hoặc không sắp xếp lại (xác thực đầu vào của người dùng) các đối tượng biểu mẫu GUI có liên quan bằng cách sử dụng tập lệnh của bộ điều khiển.

Bảng sau đây tóm tắt những stagnghĩa là

Stage	phụtage
sắp xếp — Được sử dụng để ẩn và bỏ ẩn các trường biểu mẫu và để kiểm soát nâng cao các LOV và LOV dạng bảng.	trước Marshall — Được sử dụng để thêm hoặc đặt trường nhập và tự động tạo và đặt LOV trên một trang (biểu mẫu). sau Marshall — Được sử dụng để ẩn hoặc bỏ ẩn một trường nhập liệu.

Stage	phụtage
sắp xếp lại – Được sử dụng để xác thực đầu vào của người dùng biểu mẫu.	trước Unmarshall — Được sử dụng để chuyển đổi giá trị đầu vào từ dạng này sang dạng khác, ví dụ:ample, để mã hóa mật khẩu trước khi gửi vào cơ sở dữ liệu. sau Unmarshall — Được sử dụng để xác thực đầu vào của người dùng và đặt thông báo lỗi trên trang.

Tập lệnh điều khiển xây dựng
Bộ điều khiển không yêu cầu nhập bất kỳ gói bổ sung nào.
Bạn không truyền tham số cho các phương thức của bộ điều khiển. Thay vào đó, khung Giám đốc UCS của Cisco cung cấp các tham số sau để sử dụng trong sắp xếp theo thứ tự và sắp xếp lại:

Tham số	Sự miêu tả	Example
Trang	Trang hoặc biểu mẫu chứa tất cả các đầu vào tác vụ. Bạn có thể sử dụng tham số này để làm như sau: Nhận hoặc đặt các giá trị đầu vào ở dạng GUI. Hiển thị hoặc ẩn các đầu vào ở dạng GUI.	page.setHidden(id + “.portList”, true); page.setValue(id + “.status”, “Không có cổng nào. Danh sách cổng bị ẩn”);
id	Mã định danh duy nhất của trường nhập biểu mẫu. Một id được tạo bởi khung và có thể được sử dụng với tên trường nhập biểu mẫu.	page.setValue(id + “.status”, “Không có cổng nào. Danh sách cổng bị ẩn”);// ở đây 'trạng thái' là tên của trường nhập liệu.
Pojo	POJO (đối tượng Java cũ đơn giản) là một hạt Java đại diện cho một biểu mẫu đầu vào. Mỗi trang GUI phải có một POJO tương ứng giữ các giá trị từ biểu mẫu. POJO được sử dụng để duy trì các giá trị cho cơ sở dữ liệu hoặc để gửi các giá trị đến một thiết bị bên ngoài.	pojo.setLunSize(asciiValue); // đặt giá trị của trường nhập 'lunSize'

xem người yêu cũamplê: Sử dụng Bộ điều khiển, ở trang 14 để biết mã đang hoạt độngample thể hiện chức năng của bộ điều khiển.

Example: Sử dụng Bộ điều khiển

Đoạn mã sau đâyampTập tin trình bày cách triển khai chức năng bộ điều khiển trong các tác vụ quy trình công việc tùy chỉnh bằng nhiều phương pháp — trước Marshall, sau Marshall, trước Unmarshall và sau Unmarshall.
/*

Mô tả phương pháp:
Trước Marshall: Sử dụng phương pháp này để thêm hoặc đặt trường nhập và tự động tạo và đặt LOV trên một trang (biểu mẫu).
Sau Marshall: Sử dụng phương pháp này để ẩn hoặc bỏ ẩn trường nhập liệu.
Trước UnMarshall: Sử dụng phương pháp này để chuyển đổi giá trị đầu vào từ một dạng này sang dạng khác,
ví dụample, khi bạn muốn mã hóa mật khẩu trước khi gửi nó vào cơ sở dữ liệu. Sau UnMarshall: Sử dụng phương pháp này để xác thực đầu vào của người dùng và đặt thông báo lỗi trên
trang.
*/
// Trước Marshall:
/*
Sử dụng phương thức beforeMarshall khi có thay đổi trong trường nhập liệu hoặc để tạo động các LOV và đặt trường nhập liệu mới trên biểu mẫu trước khi nó được tải.
Trong cũample bên dưới, một trường nhập mới 'portList' được thêm vào trang trước khi biểu mẫu được hiển thị trong trình duyệt.
*/
gói nhập khẩu (com.cloupia.model.cIM);
gói nhập khẩu (java.util);
gói nhập khẩu (java.lang);
var portList = new ArrayList();
var lovLabel = “eth0”;
var lovValue = “eth0”;
var portListLOV = new Array();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);//tạo trường nhập lov
// tham số 'trang' được sử dụng để đặt trường nhập liệu trên biểu mẫu
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// thiết lập trường nhập liệu trên biểu mẫu =========================== ================================================================= ================================
//Sau Marshall:
/*
Sử dụng phương pháp này để ẩn hoặc bỏ ẩn trường nhập liệu.
*/
page.setHidden(id + “.portList”, true); // ẩn trường nhập 'portList'.
page.setValue(id + “.status”, “Không có cổng nào. Danh sách cổng bị ẩn”);
page.setEditable(id + “.status”, sai);
================================================================= ================================================================= =========
// Trước Unmarshall :
/*
Sử dụng phương thức beforeUnMarshall để đọc đầu vào của người dùng và chuyển đổi nó sang dạng khác trước khi chèn vào cơ sở dữ liệu. Đối với người yêu cũample, bạn có thể đọc mật khẩu và lưu trữ mật khẩu trong cơ sở dữ liệu sau khi chuyển đổi thành mã hóa base64 hoặc đọc tên nhân viên và chuyển đổi thành Id nhân viên khi tên nhân viên được gửi đến cơ sở dữ liệu.
Trong mã cũample bên dưới kích thước lun được đọc và chuyển đổi thành giá trị ASCII.
*/
gói nhập khẩu (org.Apache.log4j);
gói nhập khẩu (java.lang);
gói nhập khẩu (java.util);
var size = page.getValue(id + “.lunSize”);
var logger = Logger.getLogger(“máy ghi nhật ký của tôi”);
if(size != null){
logger.info(“Giá trị kích thước “+kích thước);
if((new java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); // chuyển đổi kích thước lun và lấy mảng ký tự ASCII

var asciiValueBuilder = new StringBuilder();
for (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
giá trị"
//id + “.lunSize” là định danh của trường đầu vào
page.setValue(id + “.lunSize”,asciiValue); //thông số
'trang' được sử dụng để đặt giá trị trên trường nhập liệu.
pojo.setLunSize(asciiValue); // đặt giá trị trên pojo.
Pojo này sẽ được gửi tới DB hoặc thiết bị bên ngoài
}
================================================================= ================================================================= =========
// Sau unMarshall :
/*
Sử dụng phương pháp này để xác thực và đặt thông báo lỗi.
*/
gói nhập khẩu (org.Apache.log4j);
gói nhập khẩu (java.lang);
gói nhập khẩu (java.util);
//var size = pojo.getLunSize();
var size = page.get Value(id + “.lunSize”);
var logger = Logger .get Logger(“máy ghi nhật ký của tôi”);
logger.info(“Giá trị kích thước “+kích thước);
if (size > 50) { //xác thực kích thước
trang. đặt Error(id+”.lunSize”, “LUN Size can not be more than 50MB “); //bộ
thông báo lỗi trên trang
page .set Thông báo trang(“Kích thước LUN không được lớn hơn 50MB”);
//trang. đặt Trạng thái trang (2);
}

Sử dụng đầu ra của một nhiệm vụ trước đó trong một quy trình làm việc

Bạn có thể sử dụng đầu ra của một tác vụ trước đó làm đầu vào cho một tác vụ khác trong luồng công việc trực tiếp từ tập lệnh của tác vụ tùy chỉnh và tác vụ Execute Cloupia Script của thư viện tác vụ.
Để truy cập đầu ra này, bạn có thể sử dụng một trong các cách sau:

Truy xuất biến từ ngữ cảnh quy trình công việc bằng phương thức get Input().
Tham khảo đầu ra bằng cách sử dụng ký hiệu biến hệ thống.

Để truy xuất một đầu ra bằng phương thức getInput() ngữ cảnh, hãy sử dụng:
tên var = ctxt.getInput(“PreviousTaskName.outputFieldName”);

Ví dụamplê:
var name = ctxt.getInput(“custom_task1_1684.NAME”); // NAME là tên của đầu ra task1
trường mà bạn muốn truy cập
Để truy xuất một đầu ra bằng cách sử dụng ký hiệu biến hệ thống, hãy sử dụng:
var name = “${Tên tác vụ trước đó. Tên trường đầu ra}”;

Ví dụamplê:
var name = “${custom_task1_1684.NAME}”; // NAME là tên của trường đầu ra task1 mà bạn muốn truy cập

Example: Tạo và Chạy Tác vụ Tùy chỉnh