cisco Membuat Tugas Alur Kerja Kustom
Tentang Input Alur Kerja Kustom
Cisco UCS Director Orchestrator menawarkan daftar tipe input yang terdefinisi dengan baik untuk tugas-tugas kustom. Cisco UCS Director juga memungkinkan Anda membuat input alur kerja yang disesuaikan untuk tugas alur kerja khusus. Anda dapat membuat tipe input baru dengan mengkloning dan memodifikasi tipe input yang ada.
Prasyarat
Sebelum menulis tugas khusus, Anda harus memenuhi prasyarat berikut:
- Direktur Cisco UCS diinstal dan dijalankan di sistem Anda. Untuk informasi lebih lanjut tentang cara menginstal Cisco UCS Director, lihat Panduan Instalasi dan Konfigurasi Cisco UCS Director.
- Anda memiliki login dengan hak administrator. Anda harus menggunakan info masuk ini saat membuat dan mengubah tugas kustom.
- Anda harus memiliki izin tulis CloupiaScript untuk menulis tugas khusus menggunakan CloupiaScript.
- Anda harus memiliki izin eksekusi CloupiaScript untuk menjalankan tugas khusus yang dibuat menggunakan CloupiaScript.
Membuat Input Alur Kerja Kustom
Anda dapat membuat masukan khusus untuk tugas alur kerja khusus. Input ditampilkan dalam daftar jenis input yang dapat Anda petakan ke input tugas kustom saat Anda membuat tugas alur kerja kustom.
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Klik Input Alur Kerja Kustom.
- Melangkah 3 Klik Tambah.
- Melangkah 4 Pada layar Add CustomWorkflow Input, lengkapi kolom berikut:
- Nama Jenis Masukan Khusus—Nama unik untuk jenis masukan khusus.
- Jenis Masukan—Periksa jenis masukan dan klik Pilih. Berdasarkan input yang dipilih, kolom lain akan muncul. Untuk mantanample, saat Anda memilih Alamat Email sebagai jenis input, daftar nilai (LOV) akan muncul. Gunakan bidang baru untuk membatasi nilai masukan khusus.
- Langkah 5 Klik Kirim.
- Input alur kerja kustom ditambahkan ke Cisco UCS Director dan tersedia dalam daftar jenis input.
Validasi Masukan Khusus
Pelanggan mungkin perlu memvalidasi input alur kerja menggunakan sumber daya eksternal. Di luar kotak, Direktur Cisco UCS tidak dapat memenuhi kebutuhan validasi setiap pelanggan. Untuk mengisi celah ini, Cisco UCS Director menyediakan opsi untuk memvalidasi input apa pun saat runtime menggunakan skrip yang disediakan pelanggan. Skrip dapat menandai kesalahan dalam input dan dapat meminta input yang valid sebelum menjalankan permintaan layanan. Skrip dapat ditulis dalam bahasa apa pun, dapat mengakses sumber daya eksternal apa pun, dan memiliki akses ke semua nilai masukan alur kerja.
Anda dapat menulis skrip validasi khusus menggunakan JavaScript, Python, skrip bash shell, atau bahasa skrip lainnya.
Berikut ini contohnyaampskrip validasi file dapat ditemukan di Cisco UCS Director di Orchestration > Custom Workflow Inputs:
- Example-bash-script-validator
- Example-javascript-validator
- Example-python-validator
Anda dapat menyalin atau mengkloning mantanampfile input alur kerja yang ditulis untuk membuat input baru yang divalidasi. Anda juga dapat menggunakan mantanampinput alur kerja yang dituliskan sebagai panduan untuk mengembangkan skrip Anda sendiri.
Apa pun bahasa skripnya, fitur dan aturan berikut ini berlaku untuk validasi masukan kustom bernaskah:
- Semua validasi skrip dijalankan dalam proses terpisah, sehingga proses validasi yang gagal tidak memengaruhi proses Cisco UCS Director.
- Hanya input teks umum yang dapat divalidasi menggunakan skrip.
- Skrip validasi dijalankan satu per satu, secara berurutan, dalam urutan yang sama dengan input yang muncul di halaman input alur kerja. Proses terpisah diluncurkan untuk setiap input yang divalidasi.
- Nilai pengembalian bukan nol dari skrip menunjukkan validasi yang gagal. Secara opsional, Anda bisa meneruskan pesan kesalahan kembali ke formulir input alur kerja.
- Semua input alur kerja diteruskan ke skrip validasi dengan dua cara:
- Sebagai argumen untuk skrip dalam bentuk "key"="value".
- Sebagai variabel lingkungan untuk proses skrip. Nama variabel adalah label input.
Misalnyaample, jika alur kerja memiliki input berlabel Product-Code dan nilai inputnya adalah AbC123, variabel akan diteruskan ke skrip validator sebagai “Product-Code”=”AbC123”.
Variabel masukan ini dapat digunakan oleh skrip jika diperlukan untuk mengimplementasikan validasi. Pengecualian: Nilai tabel hanya berisi nomor baris dari pemilihan tabel, dan karena itu mungkin tidak berguna.
- Halaman Edit Input Alur Kerja Kustom membuat skrip tersedia di editor Tugas Kustom. Sintaks disorot untuk semua bahasa. Kesalahan sintaks diperiksa hanya untuk validator JavaScript.
Mengkloning Input Alur Kerja Kustom
Anda dapat menggunakan input alur kerja kustom yang ada di Cisco UCS Director untuk membuat input alur kerja kustom.
Sebelum Anda memulai
Input alur kerja khusus harus tersedia di Cisco UCS Director.
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Klik Input Alur Kerja Kustom.
- Melangkah 3 Klik baris dengan input alur kerja kustom yang akan digandakan.
Ikon Klon muncul di bagian atas tabel input alur kerja kustom. - Melangkah 4 Klik Kloning.
- Melangkah 5 Masukkan nama jenis input kustom.
- Melangkah 6 Gunakan kontrol lain di layar Input Alur Kerja Kustom Klon untuk menyesuaikan input baru.
- Melangkah 7 Klik Kirim.
Input tugas alur kerja kustom digandakan setelah konfirmasi dan tersedia untuk digunakan dalam tugas alur kerja kustom.
Membuat Tugas Kustom
Untuk membuat tugas kustom, lakukan hal berikut:
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Klik Tugas Alur Kerja Khusus.
- Melangkah 3 Klik Tambah.
- Melangkah 4 Pada layar Add Custom Workflow Task, lengkapi kolom berikut:
- Bidang Nama Tugas—Nama unik untuk tugas alur kerja kustom.
- Bidang Label Tugas—Label untuk mengidentifikasi tugas alur kerja khusus.
- Bidang Daftar Di Bawah Kategori—Kategori alur kerja tempat tugas alur kerja kustom harus didaftarkan.
- Kotak centang Aktifkan Tugas—Jika dicentang, tugas alur kerja kustom didaftarkan ke Orchestrator dan dapat segera digunakan dalam alur kerja.
- Bidang Deskripsi Singkat—Deskripsi tugas alur kerja kustom.
- Bidang Deskripsi Terperinci—Deskripsi mendetail tentang tugas alur kerja kustom.
- Melangkah 5 Klik Berikutnya.
Layar Input Tugas Khusus muncul. - Melangkah 6 Klik Tambah.
- Melangkah 7 Pada layar Add Entry to Inputs, lengkapi bidang-bidang berikut:
- Kolom Nama Kolom Input—Nama unik untuk kolom tersebut. Nama harus dimulai dengan karakter analfabetik dan tidak boleh mengandung spasi atau karakter khusus.
- Bidang Label Bidang Masukan—Label untuk mengidentifikasi bidang masukan.
- Daftar tarik-turun Jenis Bidang Masukan—Pilih jenis data dari parameter masukan.
- Bidang Petakan ke Jenis Masukan (Tanpa Pemetaan)—Pilih jenis masukan yang dapat dipetakan bidang ini, jika bidang ini dapat dipetakan dari keluaran tugas lain atau masukan alur kerja global.
- Kotak centang wajib— Jika dicentang, pengguna harus memberikan nilai untuk bidang ini.
- Bidang RBID—Masukkan string RBID untuk bidang tersebut.
- Daftar drop-down Input Field Size—Memilih ukuran kolom untuk input teks dan tabular.
- Kolom Bantuan Bidang Input—(Opsional) Deskripsi yang ditampilkan saat Anda mengarahkan mouse ke atas bidang.
- Kolom Anotasi Kolom Input—(Opsional) Teks petunjuk untuk kolom input.
- Bidang Nama Grup Bidang—Jika ditentukan, semua bidang dengan nama grup yang cocok dimasukkan ke dalam grup bidang.
- TEXT FIELD ATTRIBUTES area—Lengkapi kolom berikut jika jenis kolom input adalah teks.
- Kotak centang Multiple Input—Jika dicentang, kolom input menerima beberapa nilai berdasarkan jenis kolom input:
- Untuk LOV—Kolom input menerima beberapa nilai input.
- Untuk kolom teks—Kolom input menjadi kolom teks multibaris.
- Panjang Maksimum Bidang Input—Menentukan jumlah maksimum karakter yang dapat Anda masukkan di bidang input.
- Area LOV ATTRIBUTES—Lengkapi bidang berikut jika jenis inputnya adalah Daftar Nilai (LOV) atau LOV dengan tombol Radio.
- Bidang Daftar Nilai—Daftar nilai yang dipisahkan koma untuk LOV tersemat.
Bidang Nama Penyedia LOV—Nama penyedia LOV untuk LOV yang tidak disematkan. - Area ATRIBUT TABEL—Lengkapi bidang berikut jika jenis bidang input adalah Tabel, Tabel Popup, atau Tabel dengan kotak centang pilihan.
- Bidang Nama Tabel—Nama laporan tabular untuk jenis bidang tabel.
- Area VALIDASI INPUT KOLOM—Satu atau beberapa kolom berikut ditampilkan tergantung pada jenis data yang Anda pilih. Lengkapi bidang untuk menentukan bagaimana bidang masukan divalidasi.
- Daftar drop-down Input Validator—Pilih validator untuk input pengguna.
- Bidang Ekspresi Reguler—Pola ekspresi reguler untuk mencocokkan nilai masukan.
- Bidang Pesan Ekspresi Reguler—Pesan yang ditampilkan saat validasi ekspresi reguler gagal.
- Kolom Nilai Minimum—Nilai numerik minimum.
- Bidang Nilai Maksimum—Nilai numerik maksimum.
- Area HIDE ON FIELD CONDITION—Lengkapi bidang berikut untuk menyetel kondisi guna menyembunyikan bidang dalam formulir.
- Bidang Hide On Field Name—Nama internal untuk bidang sehingga program yang menangani formulir dapat mengidentifikasi bidang.
- Bidang Hide On Field Value—Nilai yang harus dikirim setelah formulir dikirim.
- Daftar tarik-turun Hide On Field Condition—Pilih kondisi yang membuat bidang harus disembunyikan.
- Kolom Bantuan HTML—Petunjuk bantuan untuk kolom tersembunyi.
- Melangkah 8 Klik Kirim.
Entri input ditambahkan ke tabel. - Melangkah 9 Klik Add untuk menambahkan lebih banyak entri ke input.
- Melangkah 10 Setelah selesai menambahkan input, klik Next.
Layar Keluaran Tugas Alur Kerja Khusus muncul. - Melangkah 11 Klik Tambah.
- Melangkah 12 Pada layar Add Entry to Outputs, lengkapi bidang-bidang berikut:
- Bidang Nama Bidang Keluaran —Nama unik untuk bidang keluaran. Itu harus dimulai dengan karakter alfabet dan tidak boleh mengandung spasi atau karakter khusus.
- Bidang Deskripsi Bidang Keluaran —Deskripsi bidang keluaran.
- Bidang Jenis Bidang Keluaran—Memeriksa jenis keluaran. Tipe ini menentukan bagaimana output dapat dipetakan ke input tugas lainnya.
- Melangkah 13 Klik Kirim.
Entri keluaran ditambahkan ke tabel. - Melangkah 14 Klik Add untuk menambahkan lebih banyak entri ke output.
- Melangkah 15 Klik Berikutnya
Layar Pengontrol muncul - Melangkah 16 (Opsional) Klik Tambah untuk menambahkan pengontrol.
- Melangkah 17 Pada layar Add Entry to Controller, lengkapi kolom berikut:
- Daftar drop-down metode—Pilih salah satu metode marshalling atau unmarshalling untuk menyesuaikan input dan/atau output untuk tugas alur kerja kustom. Metode tersebut dapat berupa salah satu dari berikut ini:
- Sebelum Marshall—Gunakan metode ini untuk menambah atau menyetel kolom input dan secara dinamis membuat dan menyetel LOV pada halaman (formulir).
- Setelah Marshall—Gunakan metode ini untuk menyembunyikan atau menampilkan kolom masukan.
- Before Unmarshall—Gunakan metode ini untuk mengonversi nilai masukan dari satu bentuk ke bentuk lain—misalnyaample, ketika Anda ingin mengenkripsi kata sandi sebelum mengirimnya ke database.
- After Unmarshall—Gunakan metode ini untuk memvalidasi input pengguna dan menyetel pesan error di halaman.
Lihat Kelampsaya: Menggunakan Pengontrol, di halaman 14. - Area teks skrip—Untuk metode yang Anda pilih dari daftar drop-down Metode, tambahkan kode untuk skrip kustomisasi GUI.
Catatan Klik Tambah jika Anda ingin menambahkan kode untuk metode lainnya.
Jika ada validasi untuk kata sandi yang dimasukkan, pastikan untuk mengubah validasi pengontrol untuk kata sandi sehingga Anda dapat mengedit tugas kustom dalam alur kerja.
Catatan
- Melangkah 18 Klik Kirim.
Pengontrol ditambahkan ke tabel. - Melangkah 19 Klik Berikutnya.
Layar Skrip muncul. - Melangkah 20 Dari daftar drop-down Bahasa Eksekusi, pilih bahasa.
- Melangkah 21 Di bidang Script, masukkan kode CloupiaScript untuk tugas alur kerja kustom.
Kode Cloupia Script divalidasi saat Anda memasukkan kode. Jika ada kesalahan dalam kode, ikon kesalahan (palang merah) ditampilkan di sebelah nomor baris. Arahkan mouse ke ikon kesalahan untuk view pesan kesalahan dan solusinya - Melangkah 22 Klik Simpan Skrip.
- Melangkah 23 Klik Kirim.
Tugas alur kerja kustom dibuat dan tersedia untuk digunakan dalam alur kerja
Tugas dan Repositori Kustom
Saat Anda membuat tugas khusus, daripada mengetikkan kode tugas khusus ke dalam jendela skrip atau memotong dan menempelkan kode dari editor teks, Anda dapat mengimpor kode dari file disimpan dalam repositori GitHub atau BitBucket. Untuk melakukannya, Anda:
- Buat satu atau lebih teks files di repositori GitHub atau BitBucket, baik di github.com atau repositori GitHub perusahaan swasta.
Catatan Cisco UCS Director hanya mendukung GitHub (github.com atau perusahaan GitHub instance) dan atau BitBucket. Itu tidak mendukung layanan hosting Git lainnya termasuk GitLab, Perforce, atau Codebase. - Daftarkan repositori di Cisco UCS Director. Lihat Menambahkan Repositori GitHub atau BitBucket di Cisco UCS Director, di halaman 7.
- Pilih repositori dan tentukan teksnya file yang berisi skrip tugas khusus. Lihat Mengunduh Kode Skrip Tugas Khusus dari Repositori GitHub atau BitBucket, di halaman 8.
Menambahkan Repositori GitHub atau BitBucket di Cisco UCS Director
Untuk mendaftarkan repositori GitHub atau BitBucket di Cisco UCS Director, lakukan hal berikut:
Sebelum Anda memulai
Buat repositori GitHub atau BitBucket. Repositori dapat berada di server GitHub atau BitBucket apa pun, publik atau pribadi yang dapat diakses dari Direktur Cisco UCS Anda.
Periksa satu atau lebih files berisi kode JavaScript untuk tugas khusus Anda ke dalam repositori Anda.
- Melangkah 1 Pilih Administrasi > Integrasi.
- Melangkah 2 Pada halaman Integrasi, klik Kelola Repositori.
- Melangkah 3 Klik Tambah.
- Melangkah 4 Pada halaman Add Repository, lengkapi kolom yang wajib diisi, termasuk yang berikut:
- Di kolom Repository Nickname, masukkan nama untuk mengidentifikasi repositori di dalam Cisco UCS Director.
- Di Repositori URL bidang, masukkan URL dari repositori GitHub atau BitBucket.
- Di bidang Nama Cabang, masukkan nama cabang repositori yang ingin Anda gunakan. Nama defaultnya adalah cabang utama.
- Di bidang Pengguna Repositori, masukkan nama pengguna untuk akun GitHub atau BitBucket Anda.
- Untuk menambahkan repositori GitHub, di kolom Kata Sandi/Token API, masukkan token API yang dihasilkan untuk GitHub Anda.
Untuk menghasilkan token API menggunakan GitHub, klik Pengaturan dan arahkan ke Pengaturan Pengembang > Token akses pribadi, dan klik Hasilkan token baru.
Catatan untuk menambahkan repositori BitBucket, di bidang Kata Sandi/Token API, masukkan kata sandi untuk BitBucket Anda. - Untuk default ke repositori ini saat Anda membuat tugas kustom baru, centang Jadikan ini repositori default saya.
- Untuk menguji apakah Direktur Cisco UCS dapat mengakses repositori, klik Uji Konektivitas.
Status konektivitas dengan repositori ditampilkan dalam spanduk di bagian atas halaman.
Jika Anda tidak dapat terhubung dan berkomunikasi dengan repositori GitHub atau BitBucket dari Cisco UCS
Direktur, perbarui Direktur Cisco UCS untuk mengakses Internet melalui server proxy. Lihat Panduan Administrasi Direktur Cisco UCS.
Catatan
- Melangkah 5 Ketika Anda yakin bahwa informasi repositori sudah benar, klik Kirim.
Mengunduh Kode Skrip Tugas Khusus dari Repositori GitHub atau BitBucket
Untuk membuat tugas kustom baru dengan mengimpor teks dari repositori GitHub atau BitBucket, lakukan hal berikut:
Sebelum Anda memulai
Buat repositori GitHub atau BitBucket dan centang satu atau beberapa teks files berisi kode JavaScript untuk tugas khusus Anda ke dalam repositori Anda.
Tambahkan repositori GitHub ke Cisco UCS Director. Lihat Menambahkan Repositori GitHub atau BitBucket di Cisco UCS Director, di halaman
- Melangkah 1 Pada halaman Orkestrasi, klik Tugas Alur Kerja Kustom.
- Melangkah 2 Klik Tambah.
- Melangkah 3 Lengkapi bidang yang wajib diisi pada halaman Informasi Tugas Kustom. Lihat Membuat Tugas Khusus, di halaman 3.
- Melangkah 4 Lengkapi bidang yang wajib diisi pada halaman Input Tugas Kustom. Lihat Membuat Tugas Khusus, di halaman 3.
- Melangkah 5 Lengkapi kolom yang wajib diisi pada halaman Keluaran Tugas Khusus. Lihat Membuat Tugas Khusus, di halaman 3.
- Melangkah 6 Lengkapi bidang yang wajib diisi di halaman Pengontrol. Lihat Membuat Tugas Khusus, di halaman 3.
- Melangkah 7 Pada halaman Skrip, lengkapi kolom yang wajib diisi:
- Dari daftar tarik-turun Bahasa Eksekusi, pilih JavaScript.
- Centang Use Repository for Scripts untuk mengaktifkan tugas khusus untuk menggunakan skrip file dari repositori. Ini memungkinkan Anda untuk memilih repositori dan menentukan skrip file untuk digunakan.
- Dari daftar drop-down Pilih Repositori, pilih repositori GitHub atau BitBucket yang berisi skrip fileS. Untuk detail tentang cara menambahkan repositori, lihat Menambahkan Repositori GitHub atau BitBucket di Cisco UCS Director, di halaman 7.
- Masukkan jalur lengkap ke skrip file dalam Skrip filebidang teks nama.
- Untuk mendownload script, klik Load Script.
Teks dari file disalin di area edit teks Script. - Opsional, buat perubahan pada skrip yang diunduh di area edit teks Skrip.
- Untuk menyimpan skrip seperti yang ditampilkan di area edit teks Skrip, klik Simpan Skrip.
Saat Anda menekan Simpan Skrip, skrip disimpan ke sesi kerja Anda saat ini. Anda harus mengklik Kirim untuk menyimpan skrip ke tugas kustom yang sedang Anda edit.
Catatan
- Melangkah 8 Untuk menyimpan tugas khusus, klik Kirim.
Jika Anda membuat perubahan pada skrip yang diunduh di area edit teks Skrip, perubahan tersebut akan disimpan ke tugas kustom. Tidak ada perubahan yang disimpan ke repositori GitHub atau BitBucket. Jika Anda ingin membuang skrip yang dimuat dan memasukkan skrip Anda sendiri, klik Buang Skrip untuk menghapus jendela skrip.
Apa yang harus dilakukan selanjutnya?
Anda dapat menggunakan tugas kustom baru dalam alur kerja.
Mengimpor Alur Kerja, Tugas Khusus, Modul Skrip, dan Aktivitas
Untuk mengimpor artefak ke Cisco UCS Director, lakukan hal berikut:
Catatan Variabel global yang terkait dengan alur kerja akan diimpor saat mengimpor alur kerja jika variabel global tidak tersedia di alat.
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Pada halaman Orkestrasi, klik Alur kerja.
- Melangkah 3 Klik Impor.
- Melangkah 4 Pada layar Impor, klik Pilih a File.
- Melangkah 5 Pada Pilih File untuk mengunggah layar, pilih file untuk diimpor. Impor dan ekspor Direktur Cisco UCS fileKami memiliki .wfdx file perpanjangan.
- Melangkah 6 Klik Buka.
Ketika file diunggah, yaitu File Layar Upload/Validasi ditampilkan File siap pakai dan Kunci. - Melangkah 7 Masukkan kunci yang dimasukkan saat mengekspor file.
- Melangkah 8 Klik Berikutnya.
Layar Kebijakan Impor menampilkan daftar objek Cisco UCS Director yang terdapat dalam unggahan file. - Melangkah 9 (Opsional) Pada layar Kebijakan Impor, tentukan bagaimana objek ditangani jika nama duplikat sudah ada di folder alur kerja. Pada layar Impor, lengkapi bidang berikut
Nama | Keterangan |
Alur kerja | Pilih dari opsi berikut untuk menentukan bagaimana alur kerja bernama identik ditangani:
|
Tugas Kustom | Pilih dari opsi berikut untuk menentukan bagaimana tugas kustom bernama identik ditangani:
|
Nama | Keterangan |
Modul Skrip | Pilih dari opsi berikut untuk menentukan bagaimana modul skrip bernama identik ditangani:
|
Kegiatan | Pilih dari opsi berikut untuk menentukan cara menangani aktivitas dengan nama yang identik:
|
Impor Alur Kerja ke Folder | Chperiksa Impor Alur Kerja ke Folder untuk mengimpor alur kerja. Jika Anda tidak mencentang Import Workflows to Folder dan jika tidak ada versi workflo yang adaw ada, alur kerja itu tidak diimpor. |
Pilih Folder | Pilih folder untuk mengimpor alur kerja. Jika Anda memilih [Baru Map..] dalam daftar drop-down, file Folder Baru bidang muncul. |
Folder Baru | Masukkan nama folder baru untuk dibuat sebagai folder impor Anda. |
- Melangkah 10 Klik Impor.
Mengekspor Alur Kerja, Tugas Khusus, Modul Skrip, dan Aktivitas
Untuk mengekspor artefak dari Cisco UCS Director, lakukan hal berikut:
Catatan Variabel global yang terkait dengan alur kerja akan diekspor secara otomatis saat mengekspor alur kerja.
- Melangkah 1 Klik Ekspor.
- Melangkah 2 Pada layar Pilih Alur Kerja, pilih alur kerja yang ingin Anda ekspor.
Alur kerja kustom, tugas, dan skrip yang dibuat di Cisco UCS Director sebelum versi 6.6 dapat gagal diimpor jika berisi data XML.
Catatan - Melangkah 3 Klik Berikutnya.
- Melangkah 4 Pada layar Pilih Tugas Khusus, pilih tugas khusus yang ingin Anda tampilkan
Catatan Tugas kustom yang diekspor berisi semua input kustom yang digunakan oleh tugas kustom tersebut. - Melangkah 5 Klik Berikutnya.
- Melangkah 6 Pada layar Export: Select Script Modules, pilih modul skrip yang ingin Anda ekspor.
- Melangkah 7 Klik Berikutnya.
- Melangkah 8 Pada layar Ekspor: Pilih Aktivitas, pilih aktivitas yang ingin Anda ekspor.
- Melangkah 9 Klik Berikutnya.
- Melangkah 10 Pada Ekspor: Pilih layar Open APIs, pilih API yang ingin Anda ekspor.
- Melangkah 11 Pada layar Ekspor: Konfirmasi, lengkapi kolom berikut:
Nama | Keterangan |
Diekspor Oleh | Nama Anda atau catatan tentang siapa yang bertanggung jawab atas ekspor. |
Komentar | Komentar tentang ekspor ini. |
Enkripsi yang diekspor file | Periksa Enkripsi yang diekspor file centang kotak untuk mengenkripsi file untuk diekspor. Secara default, kotak centang dicentang. |
Kunci | Masukkan kunci untuk mengenkripsi file. Bidang ini hanya ditampilkan saat Enkripsi diekspor file kotak centang dicentang. Pertahankan kunci sesuai kebutuhan saat mengimpor alur kerja untuk dekripsi. |
Konfirmasi Kunci | Masukkan kunci lagi untuk konfirmasi. Bidang ini hanya ditampilkan saat Enkripsi diekspor file kotak centang dicentang. |
Diekspor File Nama | Nama dari file pada sistem lokal Anda. Ketik hanya basisnya filenama; itu file type extension (.wfdx) ditambahkan secara otomatis. |
- Melangkah 12 Klik Ekspor.
Anda diminta untuk menyimpan file.
Mengkloning Tugas Alur Kerja Kustom dari Perpustakaan Tugas
Anda dapat mengkloning tugas di pustaka tugas untuk digunakan dalam membuat tugas kustom. Anda juga dapat mengkloning tugas khusus untuk membuat tugas khusus.
Tugas kloning adalah kerangka kerja dengan input dan output tugas yang sama dengan tugas asli. Namun, tugas yang dikloning hanyalah kerangka kerja. Ini berarti Anda harus menulis semua fungsionalitas untuk tugas baru di CloupiaScript.
Perhatikan juga bahwa nilai pilihan untuk input daftar, seperti daftar dropdown dan daftar nilai, dibawa ke tugas kloning hanya jika nilai daftar tidak bergantung pada sistem. Hal-hal seperti nama dan alamat IP dari sistem yang ada bergantung pada sistem; hal-hal seperti opsi konfigurasi yang didukung oleh Cisco UCS Director tidak. Untuk mantanampfile, grup pengguna, nama cloud, dan grup port bergantung pada sistem; peran pengguna, tipe cloud, dan tipe grup port tidak.
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Klik Tugas Alur Kerja Khusus.
- Melangkah 3 Klik Kloning Dari Perpustakaan Tugas.
- Melangkah 4 Pada layar Kloning dari Perpustakaan Tugas, centang baris dengan tugas yang ingin Anda tiru.
- Melangkah 5 Klik Pilih.
Tugas alur kerja kustom dibuat dari pustaka tugas. Tugas kustom baru adalah tugas kustom terakhir dalam laporan Tugas Alur Kerja Kustom. Tugas kustom baru diberi nama setelah tugas kloning, dengan tanggal ditambahkan. - Melangkah 6 Klik Kirim
Apa yang harus dilakukan selanjutnya?
Edit tugas alur kerja kustom untuk memastikan bahwa nama dan deskripsi yang tepat tersedia untuk tugas kloning.
Mengkloning Tugas Alur Kerja Kustom
Anda dapat menggunakan tugas alur kerja kustom yang ada di Cisco UCS Director untuk membuat tugas alur kerja kustom.
Sebelum Anda memulai
Tugas alur kerja kustom harus tersedia di Cisco UCS Director.
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Klik Tugas Alur Kerja Khusus.
- Melangkah 3 Klik baris dengan tugas alur kerja khusus yang ingin Anda tiru.
Ikon Klon muncul di bagian atas tabel tugas alur kerja kustom. - Melangkah 4 Klik Kloning.
- Melangkah 5 Pada layar Clone Custom Workflow Task, perbarui bidang yang wajib diisi.
- Melangkah 6 Klik Berikutnya.
Input yang ditentukan untuk tugas alur kerja kustom akan muncul. - Melangkah 7 Klik baris dengan input tugas yang ingin Anda edit dan klik Edit untuk mengedit input tugas.
- Melangkah 8 Klik Tambah untuk menambahkan entri masukan tugas.
- Melangkah 9 Klik Berikutnya.
Edit keluaran tugas. - Melangkah 10 Klik Tambah untuk menambahkan entri keluaran baru.
- Melangkah 11 Klik Berikutnya.
- Melangkah 12 Edit skrip pengontrol. Lihat Mengontrol Input Tugas Alur Kerja Khusus, di halaman 13.
- Melangkah 13 Klik Berikutnya.
- Melangkah 14 Untuk menyesuaikan tugas khusus, edit skrip tugas.
- Melangkah 15 Klik Kirim
Mengontrol Input Tugas Alur Kerja Kustom
Menggunakan Pengontrol
Anda dapat mengubah tampilan dan perilaku input tugas khusus menggunakan antarmuka pengontrol yang tersedia di Cisco UCS Director.
Kapan Menggunakan Pengontrol
Gunakan pengontrol dalam skenario berikut:
- Untuk mengimplementasikan tampilan kompleks dan menyembunyikan perilaku GUI termasuk kontrol daftar nilai yang lebih halus, daftar nilai tabular, dan kontrol input lainnya yang ditampilkan kepada pengguna.
- Untuk mengimplementasikan logika validasi input pengguna yang kompleks.
Dengan pengontrol input, Anda dapat melakukan hal berikut:
- Tampilkan atau sembunyikan kontrol GUI: Anda dapat secara dinamis menampilkan atau menyembunyikan berbagai bidang GUI seperti kotak centang, kotak teks, daftar drop-down, dan tombol, berdasarkan kondisi. Untuk mantanample, jika pengguna memilih UCSM dari daftar drop-down, Anda dapat meminta kredensial pengguna untuk Cisco UCS Manager atau mengubah daftar nilai (LOVs) di daftar drop-down untuk hanya menampilkan port yang tersedia di server.
- Validasi bidang formulir: Anda dapat memvalidasi data yang dimasukkan oleh pengguna saat membuat atau mengedit alur kerja di Desainer Alur Kerja. Untuk data yang tidak valid yang dimasukkan oleh pengguna, kesalahan dapat ditampilkan. Data input pengguna dapat diubah sebelum disimpan dalam database atau sebelum disimpan ke perangkat.
- Mengambil daftar nilai secara dinamis: Anda dapat secara dinamis mengambil daftar nilai dari objek Direktur Cisco UCS dan menggunakannya untuk mengisi objek formulir GUI.
Membuat dan Menghapus Objek GUI Form
Pengontrol selalu dikaitkan dengan formulir di antarmuka masukan tugas Perancang Alur Kerja. Ada pemetaan satu-ke-satu antara formulir dan pengontrol. Pengontrol bekerja dalam dua detiktages, marshalling dan unmarshalling. Keduanya stages memiliki dua substagyaitu, sebelum dan sesudah. Untuk menggunakan pengontrol, Anda menyusun (mengontrol bidang formulir UI) dan/atau menghapus susunan (memvalidasi input pengguna) objek formulir GUI terkait menggunakan skrip pengontrol.
Tabel berikut merangkum initagyaitu.
Stage | Sub-stage |
Pengumpulan — Digunakan untuk menyembunyikan dan memperlihatkan bidang formulir dan untuk kontrol lanjutan LOV dan LOV tabular. | sebelum Marshall — Digunakan untuk menambahkan atau mengatur field input dan secara dinamis membuat dan mengatur LOV pada halaman (formulir). setelah Marshall — Digunakan untuk menyembunyikan atau menampilkan kolom input. |
Stage | Sub-stage |
Membongkar – Digunakan untuk validasi input pengguna formulir. | sebelum Unmarshall — Digunakan untuk mengonversi nilai masukan dari satu bentuk ke bentuk lain, misalnyaample, untuk mengenkripsi kata sandi sebelum mengirimkannya ke database. setelah Unmarshall — Digunakan untuk memvalidasi masukan pengguna dan menyetel pesan kesalahan pada halaman. |
Pembuatan Skrip Pengontrol
Pengontrol tidak memerlukan paket tambahan apa pun untuk diimpor.
Anda tidak meneruskan parameter ke metode pengontrol. Alih-alih, kerangka kerja Cisco UCS Director menyediakan parameter berikut untuk digunakan dalam marshalling dan unmarshalling:
Parameter | Keterangan | Example |
Halaman | Halaman atau formulir yang berisi semua masukan tugas. Anda dapat menggunakan parameter ini untuk melakukan hal berikut:
| halaman.setHidden(id + “.portList”, true); page.setValue(id + “.status”, “Tidak ada Port aktif. Daftar Port Tersembunyi”); |
id | Pengidentifikasi unik bidang masukan formulir. Id dihasilkan oleh kerangka kerja dan dapat digunakan dengan nama kolom input formulir. | page.setValue(id + “.status”, “Tidak ada Port aktif. Daftar Port Tersembunyi”);// di sini 'status' adalah nama kolom input. |
Pojo | POJO (objek Java lama biasa) adalah kacang Java yang mewakili formulir input. Setiap halaman GUI harus memiliki POJO terkait yang menyimpan nilai dari formulir. POJO digunakan untuk mempertahankan nilai ke database atau mengirim nilai ke perangkat eksternal. | pojo.setLunSize(asciiValue); //set nilai field input 'lunSize' |
Lihat Kelampsaya: Menggunakan Pengontrol, di halaman 14 untuk kode kerja sampfile yang mendemonstrasikan fungsionalitas kontroler.
Example: Menggunakan Pengontrol
Kode berikut example mendemonstrasikan cara mengimplementasikan fungsionalitas pengontrol dalam tugas alur kerja kustom menggunakan berbagai metode — sebelum Marshall, setelah Marshall, sebelum Unmarshall, dan setelah Unmarshall.
/*
Deskripsi Metode:
Sebelum Marshall: Gunakan metode ini untuk menambahkan atau mengatur kolom input dan secara dinamis membuat dan mengatur LOV pada halaman (formulir).
Setelah Marshall: Gunakan metode ini untuk menyembunyikan atau menampilkan kolom input.
Sebelum UnMarshall: Gunakan metode ini untuk mengonversi nilai masukan dari satu formulir ke formulir lain,
untuk mantanample, ketika Anda ingin mengenkripsi kata sandi sebelum mengirimnya ke database. Setelah UnMarshall: Gunakan metode ini untuk memvalidasi masukan pengguna dan menyetel pesan kesalahan pada
halaman.
*/
//Sebelum Marshall:
/*
Gunakan metode beforeMarshall saat ada perubahan di bidang input atau untuk membuat LOV secara dinamis dan menyetel bidang input baru di formulir sebelum dimuat.
Di mantanample di bawah ini, bidang input baru 'portList' ditambahkan pada halaman sebelum formulir ditampilkan di browser.
*/
importPackage(com.clupia.model.cIM);
importPackage(java.util);
importPackage(java.lang);
var portList = Daftar Array baru();
var lovLabel = “eth0”;
var lovValue = “eth0”;
var portListLOV = Array baru();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);//buat kolom input lov
//parameter 'halaman' digunakan untuk mengatur field input pada form
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// atur field input pada form =========================== ================================================== ================================
//Setelah Marshall :
/*
Gunakan metode ini untuk menyembunyikan atau menampilkan kolom input.
*/
halaman.setHidden(id + “.portList”, true); // sembunyikan field input 'portList'.
page.setValue(id + “.status”, “Tidak ada Port aktif. Daftar Port Tersembunyi”);
halaman.setEditable(id + “.status”, false);
=================================================== =================================================== ==========
//Sebelum Unmarshall :
/*
Gunakan metode beforeUnMarshall untuk membaca input pengguna dan mengonversinya ke bentuk lain sebelum memasukkannya ke dalam database. Untuk mantanampfile, Anda dapat membaca kata sandi dan menyimpan kata sandi di database setelah mengubahnya menjadi pengkodean base64, atau membaca nama karyawan dan mengubahnya menjadi Id karyawan saat nama karyawan dikirim ke database.
Dalam kode example di bawah ukuran lun dibaca dan diubah menjadi nilai ASCII.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
ukuran var = halaman.getValue(id + “.lunSize”);
var logger = Logger.getLogger(“pencatat saya”);
jika(ukuran != null){
logger.info(“Nilai ukuran “+ukuran);
if((new java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); //konversi ukuran lun dan dapatkan larik karakter ASCII
var asciiValueBuilder = StringBuilder baru();
for (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
nilai"
//id + “.lunSize” adalah pengidentifikasi bidang input
page.setValue(id + “.lunSize”,asciiValue); // parameternya
'halaman' digunakan untuk mengatur nilai pada kolom input.
pojo.setLunSize(asciiValue); // tetapkan nilai pada pojo.
Pojo ini akan dikirim ke DB atau perangkat eksternal
}
=================================================== =================================================== ==========
// Setelah membatalkan Marshall :
/*
Gunakan metode ini untuk memvalidasi dan menyetel pesan kesalahan.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
//ukuran var = pojo.getLunSize();
ukuran var = halaman.dapatkan Nilai(id + “.lunSize”);
var logger = Pencatat .get Pencatat(“pencatat saya”);
logger.info(“Nilai ukuran “+ukuran);
if (ukuran > 50) { //validasi ukuran
halaman. atur Error(id+”.lunSize”, “Ukuran LUN tidak boleh lebih dari 50MB”); //mengatur
pesan kesalahan pada halaman
page .set Page Message(“Ukuran LUN tidak boleh lebih dari 50MB”);
//halaman. atur Status Halaman (2);
}
Menggunakan Keluaran dari Tugas Sebelumnya dalam Alur Kerja
Anda dapat menggunakan output dari tugas sebelumnya sebagai input untuk tugas lain dalam alur kerja langsung dari skrip tugas kustom dan tugas Execute Cloupia Script dari pustaka tugas.
Untuk mengakses output ini, Anda dapat menggunakan salah satu cara berikut:
- Ambil variabel dari konteks alur kerja menggunakan metode get Input().
- Lihat output menggunakan notasi variabel sistem.
Untuk mengambil keluaran menggunakan metode konteks getInput() , gunakan:
var nama = ctxt.getInput(“PreviousTaskName.outputFieldName”);
Misalnyaampsaya:
nama var = ctxt.getInput(“tugas_khusus1_1684.NAME”); // NAME adalah nama keluaran task1
bidang yang ingin Anda akses
Untuk mengambil output menggunakan notasi variabel sistem, gunakan:
var name = “${Nama Tugas Sebelumnya. Keluarkan Nama Bidang}”;
Misalnyaampsaya:
var name = “${custom_task1_1684.NAME}”; // NAME adalah nama bidang keluaran task1 yang ingin Anda akses
Example: Membuat dan Menjalankan Tugas Khusus
Untuk membuat tugas kustom, lakukan hal berikut:
- Melangkah 1 Pilih Orkestrasi.
- Melangkah 2 Klik Tugas Alur Kerja Khusus.
- Melangkah 3 Klik Tambah dan masukkan informasi tugas khusus.
- Melangkah 4 Klik Berikutnya.
- Melangkah 5 Klik + dan tambahkan detail input.
- Melangkah 6 Klik Kirim.
- Melangkah 7 Klik Berikutnya.
Layar Custom Task Outputs ditampilkan. - Melangkah 8 Klik + dan tambahkan detail keluaran untuk tugas khusus.
- Melangkah 9 Klik Berikutnya.
Layar Pengontrol ditampilkan. - Melangkah 10 Klik + dan tambahkan detail pengontrol untuk tugas khusus.
- Melangkah 11 Klik Berikutnya.
Layar Skrip ditampilkan. - Melangkah 12 Pilih JavaScript sebagai bahasa eksekusi dan masukkan skrip berikut untuk dieksekusi.
logger.addInfo(“Halo Dunia!”);
logger.addInfo(“Pesan “+input.pesan);
di mana pesan adalah nama kolom input. - Melangkah 13 Klik Simpan Skrip.
- Melangkah 14 Klik Kirim.
Tugas kustom ditentukan dan ditambahkan ke daftar tugas kustom. - Melangkah 15 Pada halaman Orkestrasi, klik Alur kerja.
- Melangkah 16 Klik Tambah untuk menentukan alur kerja, dan tentukan input dan output alur kerja.
Setelah input dan output alur kerja ditentukan, gunakan Desainer Alur Kerja untuk menambahkan tugas alur kerja ke alur kerja. - Melangkah 17 Klik dua kali alur kerja untuk membuka alur kerja di layar Perancang Alur Kerja.
- Melangkah 18 Di sisi kiri Workflow Designer, perluas folder dan pilih tugas kustom (misample, 'Tugas kustom halo dunia').
- Melangkah 19 Seret dan lepas tugas yang dipilih ke desainer alur kerja.
- Melangkah 20 Lengkapi bidang di Tambah Tugas ( ) layar.
- Melangkah 21 Hubungkan tugas ke alur kerja. Lihat Panduan Orchstration Direktur Cisco UCS.
- Melangkah 22 Klik Validasi alur kerja.
- Melangkah 23 Klik Jalankan Sekarang dan klik Kirim.
- Melangkah 24 Lihat pesan log di jendela log Permintaan Layanan.
Dokumen / Sumber Daya
![]() | cisco Membuat Tugas Alur Kerja Kustom [Bahasa Indonesia:] Panduan Pengguna Membuat Tugas Alur Kerja Kustom, Tugas Alur Kerja Kustom, Membuat Tugas Alur Kerja, Tugas Alur Kerja, Tugas |