Pengantar skenario

Sebuah skenario adalah graf. Kotak-kotak (aksinya) dihubungkan oleh sambungan yang mengangkut nilai dan sinyal. Mesinnya menjalankan sebuah kotak begitu semua masukan yang terhubung telah menerima sesuatu.

Inilah yang di Restorm menggantikan skrip pra-permintaan dan pasca-permintaan milik klien API lain — dengan satu keunggulan yang menentukan: alirannya terlihat.

Klik kanan di pohon ▸ Tambah ▸ Skenario.

Untuk apa gunanya

• Merangkai panggilan dan meneruskan sebuah nilai dari satu panggilan ke panggilan berikutnya: membuat sebuah sumber daya, mengambil pengenalnya, lalu memakainya pada panggilan berikutnya.
• Memeriksa: asersi, validasi skema JSON, perbandingan.
• Bercabang dan mengulang: if, switch, for, forEach, while, retry.
• Mengorkestrasi beberapa transport: membuka langganan MQTT, memicu sebuah aksi lewat HTTP, lalu memastikan pesannya tiba.
• Mengotomatiskan: skenario yang sama berjalan di dalam antarmuka maupun tanpa jendela dalam integrasi berkelanjutan.

Komponennya

Konsep	Artinya
Kotak (node)	Sebuah aksi. Tersedia sembilan puluh jenis — lihat katalognya
Port	Sebuah titik sambung pada kotak, bertipe dan berarah
Sambungan (sisi)	Sebuah kabel antara port keluaran dan port masukan
Selektor	Sebuah jalur yang diterapkan pada nilai yang sedang lewat di sebuah sambungan (data.items[0].id)
Variabel run	Sebuah nilai bernama, yang ditetapkan dan dibaca kembali selama eksekusi
Parameter	Sebuah masukan skenario, yang diberikan saat peluncuran atau di baris perintah
Keluaran	Sebuah hasil yang diekspos kepada pemanggil skenario

Tiga port yang dimiliki setiap kotak

Ketiganya tidak tercantum di dalam konfigurasi: mereka bagian dari kerangka kotaknya.

Port	Arah	Peran
in	Masukan	Pemicunya. Port ini menerima beberapa sambungan masuk dan kemudian menunggu hingga semuanya tiba — inilah penghalang “tunggu sampai beberapa cabang selesai”
error	Keluaran	Jalur kegagalan. Segala yang gagal keluar lewat sini
done	Keluaran	Dipancarkan ketika kotaknya dan seluruh sub-grafnya di hilir telah selesai

Perbedaan antara done dan keluaran nilai itu penting: sebuah nilai keluar begitu ia dihasilkan, sedangkan done menunggu semua yang bergantung padanya selesai.

Skenario pertama

1. Tambahkan aksi Permintaan HTTP lalu tautkan ke sebuah permintaan yang sudah ada.
2. Tambahkan aksi Assert, dengan operator eq.
3. Tarik sebuah sambungan dari port response milik permintaannya ke masukan a milik asersinya, lalu pasang selektor status pada sambungan itu.
4. Di dalam asersinya, setel b menjadi 200.
5. Klik Putar.

Asersinya memiliki dua keluaran, then dan else: sambungkan sebuah Log atau sebuah Toast pada masing-masingnya untuk melihat hasilnya lewat.

Selanjutnya

• Membangun sebuah skenario — gestur editornya.
• Port dan sambungan — model eksekusinya secara rinci.
• Variabel dan data — bagaimana nilai bersirkulasi.
• Katalog aksi — 90 kotaknya.
• Aksi kode — ketika grafnya tidak lagi memadai.

Edisi

Merancang dan menjalankan skenario di dalam antarmuka termasuk edisi Community. Eksekusi headless dalam CI dan penelusuran langkah demi langkah memerlukan edisi Pro — lihat Paket dan kapabilitas.