Alur Kerja
Alur kerja adalah rangkaian otomatisasi yang dapat digunakan kembali untuk memproses lalu lintas yang direkam, menjalankan langkah aktif, atau mentransformasi data - tanpa mengharuskan Anda menulis skrip mandiri.
Jenis Alur Kerja
| Jenis | Dipicu oleh | Penggunaan umum |
|---|---|---|
| Pasif | Lalu lintas baru yang direkam | Menandai pola menarik, memberi tag permintaan, membuat temuan secara otomatis. |
| Aktif | Eksekusi manual | Mengirim permintaan lanjutan, merangkai tindakan, menjalankan pengujian beberapa langkah. |
| Konversi | Masukan uji, tindakan konversi, atau Cocokkan & Ganti | Mentransformasi teks atau byte, seperti memformat JavaScript atau menormalkan JSON. |
Alur kerja pasif berjalan terus-menerus di latar belakang. Alur kerja aktif berjalan sesuai permintaan terhadap kumpulan permintaan terpilih.
Kanvas Alur Kerja
Buka Alur Kerja dan pilih alur kerja untuk membuka kanvasnya.
- Simpul muncul di panel tengah. Setiap simpul memiliki port masukan dan keluaran bertipe.
- Hubungkan port keluaran ke port masukan dengan mengeklik dan menyeret di antaranya.
- Klik simpul untuk membuka panel konfigurasinya di sebelah kanan.
- Bilah alat di bagian atas berisi kontrol eksekusi, aktifkan/nonaktifkan, dan impor/ekspor.
Jenis Simpul
| Simpul | Deskripsi |
|---|---|
| Mulai / Akhir | Simpul masuk dan keluar yang sesuai dengan jenis alur kerja pasif, aktif, atau konversi. |
| Kondisi | Jika / Selain Itu, Jika / Selain Itu JS, Pencocokan HTTPQL, Pencocokan Cakupan Pengujian, String Mengandung, dan Pencocokan Regex. |
| Pengodean | Pengodean/dekode Base64, URL, Hex, dan HTML. |
| Pemformatan dan hash | Ringkas JSON/Format JSON, MD5, SHA-1, dan SHA-256. |
| Operasi teks | Pangkas Ujung, Gabungkan, Pisahkan, Cocokkan & Ganti, Transformasi JQ, dan Ekstraksi Grep. |
| JavaScript | Logika kustom menggunakan SDK alur kerja; dapat membaca lalu lintas, mengoperasikan file, dan membuat temuan. |
| Integrasi | Log, Webhook, Panggil Alur Kerja, Kirim Permintaan, dan Aturan Cocokkan & Ganti. |
Gunakan palet simpul untuk melihat port dan konfigurasi sebenarnya. Klik koneksi untuk mengelola tautan tersebut, alih-alih menghapus simpul untuk menghubungkan ulang graf. Simpan dengan Simpan atau Ctrl+S (Command+S pada macOS).
Berbagi dan Cakupan
Secara default, alur kerja digunakan bersama oleh proyek dalam ruang kerja yang sama. Aktifkan Khusus proyek agar definisi tetap bersama proyeknya. Definisi bersama tidak berarti lalu lintas, hasil, atau catatan setiap proyek ikut dibagikan. Ekspor/impor JSON alur kerja saat berpindah ke ruang kerja atau instalasi lain.
Menguji Sebelum Penggunaan Langsung
Alur kerja pasif dan aktif memiliki bagian Uji HTTP dengan data uji URL, Permintaan dalam format transmisi, dan Respons dalam format transmisi. Aktifkan alur kerja, isi kolom tersebut, dan klik Uji alur kerja. Pengujian menyimpan perubahan sebelum mengeksekusi. Nilai data uji dipertahankan per alur kerja saat Anda meninggalkan halaman dan kembali.
Alur kerja konversi memiliki Masukan uji dan keluaran. Mulailah dengan masukan kecil yang representatif, lalu uji aset dengan ukuran realistis. Data uji tidak menjadikan JavaScript sembarang atau simpul Kirim Permintaan aman: kode alur kerja tetap dapat melakukan tindakan yang dikonfigurasi.
JavaScript dan File
JavaScript alur kerja mendukung SDK Ogma dan impor fs/path yang kompatibel. Gunakan sdk.fs.readFile, writeFile, appendFile, exists, readDir, mkdir, dan unlink untuk operasi file, serta sdk.path untuk path yang menyesuaikan platform. Ini adalah helper Ogma, bukan seluruh pustaka standar Node.js.
Untuk pengekspor aset, baca response.getBody().toText(), pilih tujuan dengan sdk.path.join, buat direktori induknya, dan periksa sdk.fs.exists jika Anda tidak ingin menimpa file yang ada. Tinjau path sistem file sebelum eksekusi: helper sistem file alur kerja berjalan pada host Ogma, berbeda dengan sdk.fs plugin yang dibatasi ke direktori privat. Lihat SDK plugin untuk runtime yang berbeda tersebut.
Mengimpor Alur Kerja
- Klik Impor pada bilah alat Alur Kerja.
- Pilih file alur kerja JSON.
- Alur kerja terbuka di kanvas. Verifikasi konfigurasi simpul sebelum mengaktifkannya.
- Simpan alur kerja.
File JSON alur kerja yang diekspor dapat dibagikan antarinstalasi Ogma atau disimpan dalam kontrol versi.
Menjalankan Alur Kerja pada Riwayat yang Direkam
Alur kerja aktif dapat dijalankan kembali terhadap permintaan yang telah direkam sebelumnya.
- Buka alur kerja.
- Klik Jalankan pada riwayat.
- Dalam modal pemindaian riwayat, masukkan filter HTTPQL opsional untuk membatasi permintaan yang diproses alur kerja.
- Klik Jalankan.
Tinjau jumlah kecocokan dan mulai tugas. Progres dan kesalahan muncul dalam tugas pemindaian dan, saat pencatatan aktif, dalam riwayat eksekusinya. Alur kerja pasif menyediakan Pindai Riwayat dan Jalankan ulang pada permintaan untuk pemrosesan retrospektif.
Untuk beberapa aset menarik, pilih satu atau beberapa baris Riwayat HTTP, klik kanan, pilih Kirim Ke > Alur Kerja, dan pilih alur kerja aktif yang diaktifkan. Ini memberikan entri terpilih kepadanya tanpa mengubah definisi atau memproses seluruh riwayat.
Tombol AI di samping masukan filter pemindaian riwayat menghasilkan ekspresi HTTPQL dari deskripsi dalam bahasa sehari-hari.
Eksekusi dan Hasil Alur Kerja
Aktifkan Aktifkan pencatatan log dalam konfigurasi alur kerja saat Anda memerlukan detail eksekusi. Pengaturan ini berlaku pada alur kerja pasif, aktif, dan konversi, termasuk konversi Cocokkan & Ganti. Saat nonaktif, pemrosesan tetap berjalan tetapi tidak menambahkan log eksekusi/langkah; aktifkan kembali dan ulangi pengujian untuk mendiagnosis masalah.
- Klik eksekusi untuk melihat keluaran langkah per simpul.
- Simpul yang menghasilkan kesalahan disorot.
- Temuan yang dibuat selama eksekusi muncul dalam tampilan Temuan.
- Variabel yang diekstrak selama eksekusi terlihat dalam panel detail langkah.
Bersihkan Semua menghapus riwayat eksekusi tersimpan dari alur kerja terpilih. Unduh log sebelum membersihkannya jika Anda perlu menyimpan bukti debugging. Pencatatan dapat menyimpan keluaran besar seperti isi skrip lengkap, jadi biarkan nonaktif untuk konversi bervolume tinggi kecuali diperlukan.
Mengaktifkan Alur Kerja Pasif
- Buka alur kerja.
- Pastikan konfigurasi kanvas lengkap (tidak ada port wajib yang terputus).
- Gunakan sakelar Aktifkan pada bilah alat.
Alur kerja pasif yang diaktifkan memproses lalu lintas baru secara otomatis. Nonaktifkan alur kerja untuk menjedanya tanpa menghapusnya.