Mengontrol aktivitas runbook
Penting
Versi Orchestrator ini telah mencapai akhir dukungan. Kami menyarankan Anda untuk meningkatkan ke Orchestrator 2022.
Anda mengatur urutan operasi dalam runbook dengan menautkan aktivitas bersama-sama di Designer Runbook. Tautan ini dikenal sebagai tautan pintar karena Anda dapat mengonfigurasinya untuk mengontrol jenis data yang diteruskan dari satu aktivitas ke aktivitas lainnya. Anda juga dapat mengontrol kapan runbook menyelesaikan aktivitas dengan mengatur logika saat operasi tersebut berjalan dengan perulangan yang disematkan. Terakhir, Anda dapat menggunakan operasi teks dan numerik untuk memanipulasi data saat melewati antar aktivitas, atau untuk mengatur kondisi untuk urutan operasi. Artikel ini menjelaskan cara mengontrol pengurutan dan memanipulasi data dalam runbook Anda.
Mengontrol urutan aktivitas dengan tautan pintar
Aktivitas dalam runbook Anda akan selesai sesuai dengan urutan yang Anda tetapkan dengan menautkannya bersama-sama. Anda dapat mengontrol data yang mengalir di antara aktivitas dengan menggunakan tab Sertakan dan Kecualikan dari Properti Tautan. Misalnya, Anda hanya dapat menyertakan data untuk diteruskan ke aktivitas berikutnya yang memenuhi kriteria tertentu.
Penting
Aturan tab Kecualikan tautan pintar menggantikan aturan pada tab Sertakan tautan pintar.
Penting
Aturan pada setiap tab digabungkan dengan menggunakan kondisi atau . Hanya salah satu kondisi yang ditentukan pada tab yang harus benar agar kondisinya benar.
Jenis data yang diterbitkan oleh aktivitas menentukan jenis kriteria yang dapat Anda atur untuk mengontrol urutan runbook. Beberapa aktivitas menerbitkan data biner, dan yang lain menerbitkan data numerik atau teks.
Jika data yang diterbitkan adalah data teks, Anda bisa menggunakan salah satu hal berikut ini untuk mengatur kriteria untuk eksekusi, penyertaan, atau pengecualian.
| Kondisi | Deskripsi |
|---|---|
| berisi | Teks yang ditentukan muncul di suatu tempat dalam nilai item Data yang Diterbitkan. |
| tidak berisi | Teks yang ditentukan tidak muncul di suatu tempat dalam nilai item Data yang Diterbitkan. |
| STARTS_WITH | Nilai item Data yang Diterbitkan dimulai dengan teks yang ditentukan. |
| diakhir dengan | Nilai item Data yang Diterbitkan berakhir dengan teks yang ditentukan. |
| pola kecocokan | Nilai item Data yang Diterbitkan cocok dengan ekspresi reguler tertentu. |
| tidak cocok dengan pola | Nilai item Data yang Diterbitkan cocok dengan ekspresi reguler tertentu. |
| setara | Nilai item Data yang Diterbitkan sama persis dengan teks yang ditentukan. |
| tidak sama dengan | Nilai item Data yang Diterbitkan tidak cocok dengan teks yang ditentukan. |
Catatan
Nilai teks tidak peka huruf besar/kecil.
Anda juga dapat mengatur kriteria menggunakan ekspresi reguler untuk melakukan pencocokan pola.
Jika data yang diterbitkan bersifat numerik, Anda dapat menggunakan salah satu hal berikut ini untuk mengatur kriteria eksekusi, penyertaan, atau pengecualian.
| Kondisi | Deskripsi |
|---|---|
| setara | Nilai item Data yang Diterbitkan sama persis dengan nilai yang ditentukan. |
| tidak sama dengan | Nilai item Data yang Diterbitkan tidak sama dengan nilai yang ditentukan. |
| kurang dari | Nilai item Data yang Diterbitkan kurang dari nilai yang ditentukan. |
| lebih besar dari | Nilai item Data yang Diterbitkan lebih besar dari nilai yang ditentukan. |
| kurang dari atau sama dengan | Nilai item Data yang Diterbitkan kurang dari atau sama dengan nilai yang ditentukan. |
| lebih besar dari atau sama dengan | Nilai item Data yang Diterbitkan lebih besar dari atau sama dengan nilai yang ditentukan. |
| antara | Nilai item Data yang Diterbitkan berada di antara dua nilai yang ditentukan. |
Pilih tab yang diperlukan untuk langkah-langkah menambahkan atau menghapus kondisi tautan pintar:
Ikuti langkah-langkah berikut untuk menambahkan kondisi tautan pintar:
Klik kanan tautan pintar untuk memilih Properti untuk membuka dialog Properti Tautan .
Penting
Untuk mengubah nilai yang membentuk aturan, Anda harus memilih setiap bagian yang digaris bawahi dari kondisi tautan pintar.
Pilih aktivitas yang tercantum dalam kondisi untuk membuka dialog Data yang Diterbitkan .
Pilih kotak Perlihatkan Data umum yang Dikembalikan untuk menampilkan properti yang umum untuk semua aktivitas.
Pilih properti dari Data yang Diterbitkan dan pilih OK. Ekspresi kriteria diubah tergantung pada jenis data yang dikembalikan properti.
Untuk mengubah bagian ekspresi yang berbeda, pilih teks bergaris bawah, lalu pilih atau masukkan nilai yang sesuai.
Pilih Selesai.
Ulangi aktivitas dengan perulangan yang disematkan
Dengan menggunakan perulangan, Anda dapat membuat percobaan ulang otomatis dan memantau di lokasi mana pun dalam runbook.
Anda dapat membuat perulangan untuk aktivitas apa pun sehingga Anda dapat mencoba kembali operasi jika gagal atau menguji informasi output aktivitas untuk data yang valid. Anda juga dapat menggunakan mekanisme ini untuk membangun kondisi tunggu ke dalam alur kerja Anda.
Saat Anda mengonfigurasi perulangan untuk aktivitas, itu akan terus berjalan dengan data input yang sama sampai kriteria perulangan keluar yang diinginkan tercapai. Anda membangun kriteria keluar untuk perulangan dengan cara yang sama seperti konfigurasi tautan pintar. Anda dapat menggunakan item data yang diterbitkan dari aktivitas sebagai bagian dari keluar atau tidak keluar dari konfigurasi. Termasuk dalam data umum yang diterbitkan adalah item data khusus, seperti Perulangan: Jumlah upaya dan Perulangan: Total durasi, yang memungkinkan Anda menggunakan informasi dari perulangan itu sendiri dalam kondisi perulangan.
Perulangan berjalan satu kali untuk setiap bagian data masuk yang diteruskan ke aktivitas. Misalnya, pertimbangkan runbook yang menggunakan aktivitas Database Kueri diikuti dengan Tambahkan Baris. Jika aktivitas Database Kueri mengembalikan tiga baris, aktivitas Tambahkan Garis akan berjalan tiga kali. Jika Anda memiliki perulangan pada aktivitas Append Line , itu akan menjalankan tiga perulangan terpisah. Setelah item data pertama diulang melalui aktivitas Tambahkan Baris , item berikutnya melewati Baris Tambahkan dan perulangan hingga keluar, lalu yang ketiga dimulai. Setelah ketiga item diproses, aktivitas berikutnya dalam runbook berjalan.
Mengonfigurasi perulangan
Klik kanan aktivitas di runbook untuk memilih Perulangan. Dialog Properti Perulangan terbuka.
Pada tab Umum , pilih Aktifkan.
Dalam kotak Tunda di antara upaya , masukkan jumlah detik untuk dijeda di antara setiap upaya untuk menjalankan aktivitas.
Keluar dan Jangan Keluar dari Kondisi
Aturan pada tab Keluar menentukan kondisi yang menentukan apakah perulangan keluar. Aturan pada tab Jangan Keluar menentukan kondisi yang menyebabkan perulangan berlanjut.
Penting
Aturan pada tab Jangan Keluar menggantikan aturan pada tab Keluar .
Aturan dalam setiap tab digabungkan dengan menggunakan kondisi Or . Hanya salah satu kondisi pada tab yang harus benar agar seluruh tab benar.
Pilih tab yang diperlukan untuk prosedur menambahkan atau menghapus kondisi Keluar :
Ikuti langkah-langkah berikut untuk menambahkan kondisi keluar:
Dalam dialog Properti Perulangan , pilih tab Keluar atau Jangan Keluar , lalu pilih kondisi yang tercantum dalam kotak pilih Tambahkan untuk menambahkan kondisi.
Penting
Untuk mengubah nilai yang membentuk aturan, Anda harus memilih setiap bagian yang digaris bawahi dari kondisi tautan.
Pilih aktivitas yang tercantum dalam kondisi untuk membuka dialog Data yang Diterbitkan .
Centang kotak Perlihatkan Data umum yang Dikembalikan untuk menampilkan properti yang umum untuk semua aktivitas.
Pilih properti dari data yang diterbitkan, lalu pilih OK. Ekspresi kriteria diubah tergantung pada jenis data yang dikembalikan properti.
Untuk mengubah bagian ekspresi yang berbeda, pilih teks bergaris bawah dan pilih atau masukkan nilai yang sesuai.
Pilih Selesai.
Mengatur jadwal untuk runbook
Anda dapat mengatur jadwal untuk mengontrol kapan runbook berjalan. Misalnya, ada kalanya tidak pantas untuk menjalankan beberapa runbook, seperti mencadangkan runbook di server utama selama jam kerja reguler. Anda dapat membuat jadwal yang berjalan sesuai dengan interval kompleks, seperti Senin dan Kamis pertama dan ketiga setiap bulan, kecuali ketika hari-hari ini jatuh pada hari libur.
Jadwal menggunakan jam sistem server Runbook yang menjalankan runbook. Ini memungkinkan jadwal untuk berfungsi di lingkungan komputer virtual, dan untuk terus berjalan bahkan ketika jam sistem disesuaikan karena perpindahan ke atau dari waktu musim panas.
Runbook yang dimulai sebelum waktu yang dilarang berjalan hingga selesai, bahkan jika mereka masih memproses ketika waktu yang dilarang tiba. Mereka tidak akan terganggu setelah pemrosesan dimulai.
Penting
Izin akses untuk jadwal dapat dimodifikasi, tetapi server runbook tidak memberlakukan izin ini.
Catatan
Jika Anda menjadwalkan runbook untuk memulai selama satu jam yang dilewati saat jam sistem disesuaikan maju satu jam, waktu mulai tersebut dilewati, dan runbook dimulai pada waktu terjadwal berikutnya. Jika Anda menjadwalkan runbook untuk memulai selama satu jam yang terjadi dua kali karena jam sistem disesuaikan mundur satu jam, runbook dimulai dua kali.
Catatan
Orchestrator tidak mendukung pemindahan beberapa jadwal dengan beberapa pilihan. Untuk memindahkan lebih dari satu jadwal ke folder lain, Anda harus memindahkan setiap jadwal satu per satu.
Pilih tab yang diperlukan untuk membuat jadwal, menetapkan jadwal ke runbook, atau menghapus jadwal dari runbook:
Ikuti langkah-langkah berikut untuk membuat jadwal:
Di panel Connections, klik kanan folder Jadwal atau subfolder folder Jadwal, arahkan ke Baru, lalu pilih Jadwalkan untuk membuka dialog Jadwal Baru.
Pada tab Umum , dalam kotak Nama , masukkan nama untuk jadwal.
Dalam kotak Deskripsi , masukkan deskripsi yang menjelaskan atau menjelaskan tujuan jadwal.
Pilih tab Detail . Pilih hari-hari yang jadwal ini memungkinkan runbook untuk berjalan:
Hari dalam seminggu: Pilih opsi ini dan pilih hari dalam seminggu ketika jadwal ini memungkinkan runbook berjalan.
Kemunculan: Pilih minggu dalam sebulan saat jadwal memungkinkan runbook berjalan.
Hari dalam sebulan: Pilih opsi ini dan pilih hari dalam sebulan saat jadwal ini memungkinkan runbook berjalan. Tentukan hari dalam sebulan dengan memasukkan jumlah hari. Anda dapat menggunakan tanda hubung untuk menjelaskan rentang dan koma untuk memisahkan entri. Misalnya, mengetik 1,3 mencakup hari pertama dan ketiga dalam sebulan. Memasukkan 1-21 mencakup hari pertama hingga dua puluh hari pertama dalam sebulan. Anda dapat menggabungkan keduanya untuk membuat deskripsi kompleks hari dalam sebulan. Masukkan semua untuk menentukan semua hari dalam sebulan. Masukkan terakhir untuk menentukan hari terakhir dalam sebulan.
Anda tidak dapat menggunakan semua dan terakhir sebagai bagian dari rentang hari. Selain itu, jika Anda memasuki rentang 5-31, rentang ini berfungsi dengan benar untuk semua bulan, termasuk yang memiliki 28, 29, 30, dan 31 hari.
Pilih Jam untuk membuka dialog Jam Jadwal .
Pilih dan seret untuk memilih sekelompok jam dalam seminggu. Teks di bagian bawah dialog memperlihatkan periode waktu yang Anda pilih. Kemudian pilih salah satu hal berikut ini:
Izin (biru): menetapkan periode waktu yang Anda pilih sebagai waktu saat runbook diizinkan untuk berjalan.
Ditolak (putih): tetapkan periode waktu yang Anda pilih sebagai waktu ketika runbook tidak diizinkan untuk berjalan.
PilihOK.
Pilih tab Pengecualian . Daftar menampilkan semua hari yang merupakan pengecualian untuk aturan yang ditentukan di tab Detail .
Pilih Tambahkan untuk membuka dialog Tanggal .
Tentukan tanggal dan pilih Izinkan atau Larang untuk mengizinkan atau tidak mengizinkan runbook berjalan pada hari itu, lalu pilih OK. Entri muncul dalam daftar.
Untuk mengubah entri Pengecualian, pilih entri tersebut, lalu pilih Ubah. Untuk menghapus entri Pengecualian, pilih entri tersebut, lalu pilih Hapus.
Untuk mengubah jadwal, klik dua kali Jadwal.
Untuk menghapus jadwal, klik kanan Jadwal, lalu pilih Hapus.
Pilih Selesai.
Memanipulasi data dengan fungsi
Anda mungkin perlu memanipulasi data string dari file teks, data yang dikembalikan, atau sumber lain, dan mengonversinya menjadi bentuk yang dapat digunakan untuk aktivitas runbook Anda. Selain itu, Anda dapat melakukan operasi aritmatika sederhana, seperti menghitung jumlah dan perbedaan serta melakukan operasi pembagian dan perkalian. Misalnya, Anda dapat mengekstrak teks dari file teks dengan menggunakan aktivitas Manajemen File Teks , memangkas spasi awal dan akhir dari teks, lalu mengambil bagian tertentu dari teks yang dapat Anda teruskan ke aktivitas lain sebagai item data yang dikembalikan.
Anda memanipulasi data dalam runbook dengan menyisipkan fungsi. Fungsi manipulasi data harus diapit dalam kurung siku ('[' dan ']'). Contohnya:
[Upper('this will be inserted in upper case')]
Ketika aktivitas berjalan, teks 'ini akan dimasukkan dalam huruf besar' dalam contoh diganti dengan 'INI AKAN DIMASUKKAN DALAM HURUF BESAR'.
Fungsi peka huruf besar/kecil. Misalnya, Upper('Text') akan diproses, tetapi upper('Text') tidak akan.
Tabel di bawah ini mencantumkan fungsi yang didukung untuk runbook.
| Fungsi dan Definisi | Penggunaan | Parameter | Contoh |
|---|---|---|---|
| Atas - mengonversi teks menjadi huruf besar. | Atas('Teks') | Teks - teks yang sedang dikonversi menjadi huruf besar. | Upper('this will be converted to uppercase') returns 'THIS WILL BE CONVERTED TO UPPERCASE' |
| Lebih rendah - mengonversi teks menjadi huruf kecil. | Lower('Text') | Teks - teks yang sedang dikonversi menjadi huruf kecil. | Lower('This Will Be Converted To Lowercase') mengembalikan 'this will be converted to lowercase' |
| Bidang - mengembalikan teks dalam posisi tertentu. | Bidang('Teks', 'Pemisah', Nomor Bidang) | Teks - teks yang sedang dicari. Pemisah - karakter yang memisahkan setiap bidang. Nomor Bidang - posisi bidang yang dikembalikan (mulai dari 1). |
Field('John; Smith; 9055552211', ';', 2) mengembalikan 'Smith' |
| Jumlah - mengembalikan jumlah sekumpulan angka. | Sum(firstNumber, secondNumber, thirdNumber, ...) | Number - angka yang sedang ditambahkan. Anda dapat meletakkan sekumpulan angka, masing-masing dipisahkan oleh koma (,). | Jumlah(2,3,4,5) mengembalikan '14' |
| Diff - mengembalikan selisih dua angka. | Diff(Number1, Number2, <Presisi>) | Number1 - angka yang akan dikurangi. Number2 - angka yang akan dikurangi dari Number1. Presisi Opsional> - jumlah tempat desimal <yang hasilnya akan dibulatkan. |
Diff(9, 7) mengembalikan '2' Diff(9.3, 2.1, 2) mengembalikan '7.20' |
| Mult - mengembalikan produk dari sekumpulan angka. | Mult(firstNumber, secondNumber, thirdNumber, ...) | Number - angka yang sedang dikalikan. Anda dapat meletakkan sekumpulan angka, masing-masing dipisahkan oleh koma (,). | Mult(2, 3, 4) mengembalikan '24' |
| Div - mengembalikan nilai quotient dari dua angka. | Div(Number1, Number2, <Presisi>) | Number1 - angka yang akan dibagi. Number2 - angka yang akan membagi Number1. Presisi Opsional> - jumlah tempat desimal <yang hasilnya akan dibulatkan. |
Div(8, 4) mengembalikan '2' Div(9, 2, 2) mengembalikan '4,50' |
| Instr - mengembalikan posisi kemunculan pertama teks dalam teks lain. | Instr ('SearchText', 'TextToFind') | SearchText - teks yang sedang dicari. TextToFind - teks yang Anda cari. |
Instr('Ini adalah string yang dicari', 'string') mengembalikan 11 |
| Kanan - mengembalikan subset teks dari sisi kanan teks lengkap. | Kanan('Teks', Panjang) | Teks - teks lengkap. Panjang - jumlah karakter dari sisi kanan yang akan dikembalikan. |
Right('Take from the right', 9) mengembalikan 'the right' |
| Kiri - mengembalikan subset teks dari sisi kiri teks lengkap. | Kiri('Teks', Panjang) | Teks - teks lengkap. Panjang - jumlah karakter dari sisi kiri yang akan dikembalikan. |
Left('Take from the left', 4) mengembalikan 'Take' |
| Mid - mengembalikan subset teks dari tengah teks lengkap. | Mid('Text', Start, Length) | Teks - teks lengkap. Mulai - posisi awal dalam teks tempat Anda ingin mulai mengembalikan karakter. Panjang - jumlah karakter yang dimulai dari posisi Mulai yang akan dikembalikan. |
Mid('Take from the middle', 5, 4) mengembalikan 'from' |
| LTrim - memangkas spasi di depan dari teks. | LTrim('Text') | Teks - teks yang sedang dipangkas dari spasi di depan. | LTrim(' Hapus spasi utama saja. ') mengembalikan 'Hapus spasi utama saja. ' |
| RTrim - memangkas spasi di belakang dari teks. | RTrim('Text') | Teks - teks yang sedang dipangkas dari spasi berikutnya. | RTrim(' Hapus spasi berikutnya saja. ') mengembalikan ' Hapus spasi berikutnya saja.' |
| Pangkas - memangkas spasi di depan dan di belakang dari teks. | Pangkas('Teks') | Teks - teks yang sedang dipangkas. | Pangkas(' Hapus spasi di depan dan di belakang. ') mengembalikan 'Hapus spasi di awal dan akhir.' |
| Len - mengembalikan panjang teks. | Len('Text') | Teks - teks yang sedang diukur. | Len('Measure this text') mengembalikan 17 |
Catatan
Fungsi peka huruf besar/kecil. Misalnya, Upper('Text') akan diproses, tetapi upper('Text') tidak akan.
Langkah berikutnya
Untuk membaca panduan terpandu untuk membuat runbook sampel, lihat Membuat dan menguji runbook sampel.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk