Membangun sebuah skenario

Editornya

Kanvas di bagian tengah, palet penambahan dan inspektur di sekelilingnya. Kotak digeser dengan tetikus, dan tampilannya dapat digeser serta diperbesar.

Menambahkan sebuah kotak

Dari paletnya, yang tersusun menurut kategori: kendali, komposisi (permintaan dan koneksi), daftar, perulangan, waktu, matematika, algoritmika, format data, encoding, antarmuka, utilitas.

Sebuah aksi yang terkait dengan permintaan (Permintaan HTTP, Permintaan SOAP, seluruh aksi koneksi) meminta Anda menunjuk permintaan proyek yang dikendalikannya.

Kaitan skenario ↔ permintaan

Menunjuk sebuah permintaan di dalam suatu aksi menciptakan kaitan yang kuat: aksinya merujuk permintaan itu melalui pengenalnya, bukan lewat salinan. Konsekuensinya:

• permintaannya tetap dipakai bersama — mengubahnya (URL, header, body) mengubah apa yang dimainkan semua skenario yang memakainya, pada eksekusi berikutnya;
• kaitannya bertahan terhadap penggantian nama atau pemindahan permintaan di dalam pohon: kaitan itu tidak bersandar pada nama maupun jalurnya;
• dari sisi permintaannya, smartbar memuat tombol “Dipakai dalam skenario” — tombol itu mendaftar skenario yang memanggilnya dan memungkinkan Anda melompat ke sana. Inilah kebiasaan yang perlu dimiliki sebelum mengubah sebuah permintaan bersama;
• permintaan yang hilang (dihapus, atau tidak ada saat proyeknya dibuka) akan menggagalkan validasi skenarionya: tombol putarnya tetap terkunci dan kotak yang bermasalah ditandai — tidak pernah ada skenario yang rusak diam-diam.

Untuk memainkan ulang permintaan yang sama tanpa menyentuh versinya yang tersimpan, jangan mengubahnya: gunakan penimpaan (pengaturan cepat, penimpaan aksi, sambungan) yang dijelaskan di Menimpa sebuah permintaan.

Mengonfigurasi sebuah kotak

Setiap kotak memiliki kolomnya sendiri, yang diisi langsung pada kotaknya atau di dalam inspektur. Kolomnya menerima nilai bertipe — string, angka, boolean, tanggal, ekspresi Handlebars, variabel, daftar kustom, rahasia… — lihat Variabel dan lingkungan.

Ctrl+Space memicu pelengkapan otomatis variabel dan helper di kolom yang mendukungnya.

Menyambungkan

Tariklah dari sebuah port keluaran menuju sebuah port masukan.

Dua aturan yang perlu diketahui:

1. Sebuah port masukan hanya menerima satu sambungan — kecuali port in, yang menerima sebanyak yang Anda mau dan kemudian berperan sebagai penghalang.
2. Keluaran sinyal murni tidak dapat memasok masukan nilai murni. Selebihnya diperbolehkan: sebuah keluaran yang membawa nilai juga berfungsi sebagai pemicu.

Selengkapnya: Port dan sambungan.

Selektor sambungan

Sebuah sambungan dapat membawa selektor: sebuah jalur yang diterapkan pada nilai yang sedang lewat.

data.items[0].id
body['user-id']
status

Inilah yang menghindarkan Anda menyelipkan sebuah kotak transformasi di antara setiap panggilan dan konsumernya. Selektornya disetel saat sambungannya dibuat atau di kemudian hari; mengosongkannya berarti menghapusnya.

Menimpa sebuah permintaan

Sebuah aksi yang terkait dengan permintaan dapat mengubahnya tanpa menyentuh permintaannya sendiri. Ada empat lapisan, dengan urutan berikut:

1. permintaannya sebagaimana tersimpan;
2. sebuah pengaturan cepat (quick config) yang ditunjuk pada aksinya — begitulah Anda memakai ulang varian tersimpan sebuah permintaan langsung di dalam skenario, tanpa mengetikkannya lagi;
3. penimpaan yang diisi pada aksinya;
4. nilai yang tiba melalui sebuah sambungan pada port penimpaannya.

Inilah cara yang bersih untuk memainkan ulang panggilan yang sama dengan tiga himpunan data.

Memainkan ulang pada setiap peristiwa

Menu konteks sebuah kotak menawarkan “Mainkan ulang pada setiap peristiwa yang diterima”. Bila diaktifkan, opsi itu mengubah semua masukan yang tersambung menjadi gerbang “atau” yang tidak menghalangi: kotaknya terpicu ulang pada setiap nilai yang diterima di port mana pun, alih-alih menunggu semuanya hadir.

Ini wajib untuk mengolah sebuah aliran (setiap pesan MQTT, setiap peristiwa SSE), dan sekaligus membuka siklus penyelesaian.

Parameter dan keluaran

• Kotak Input / Param mendeklarasikan parameter skenarionya. Parameter itu diberikan saat peluncuran, di baris perintah (--param nama=nilai), atau diminta pada saat eksekusi dalam mode interaktif.
• Kotak Output / Return mengekspos sebuah hasil kepada pemanggilnya — berguna ketika skenarionya dipanggil oleh skenario lain lewat aksi Jalankan skenario.

Menata

Restorm mampu merapikan sebuah graf secara otomatis (penataan letak); setelahnya kotaknya tetap dapat digeser secara manual. Ctrl+Z membatalkan, Ctrl+Shift+Z mengulangi.

Memvalidasi

Tombol putarnya terkunci selama masih ada galat validasi: sambungan tidak valid, permintaan hilang, kolom wajib kosong. Kotak yang bermasalah ditandai.