Variabel sebaris di dalam kolom

Kolom teks mana pun pada sebuah permintaan menerima ekspresi Handlebars yang ditulis sebaris. Inilah mekanisme paling langsung untuk memparameterkan sebuah panggilan: tanpa konfigurasi awal, substitusinya terjadi pada saat pengiriman.

Di mana ini berlaku

• pada URL (termasuk skema, host, port, dan query string);
• pada header, baik kunci maupun nilainya;
• pada parameter kueri dan parameter jalur;
• pada body: JSON mentah, XML, formulir, x-www-form-urlencoded;
• pada kolom khas masing-masing protokol: topik MQTT, kunci perutean AMQP, pesan gRPC, kueri GraphQL beserta variabelnya, perintah Redis, kunci Kafka…

Contoh

Sebuah URL yang sepenuhnya diparameterkan:

{{scheme}}://{{host}}:{{port}}/v{{apiVersion}}/clients/{{clientId}}

Sebuah header gabungan:

Authorization: Bearer {{accessToken}}
X-Request-Id: {{uuid}}

Sebuah body JSON yang mencampur variabel dan helper:

{
  "reference": "CMD-{{timestamp}}",
  "client": "{{clientId}}",
  "libelle": "{{uppercase produit}}",
  "montant": {{multiply prixUnitaire quantite}},
  "creeLe": "{{now}}"
}

Sebuah topik MQTT dan sebuah kunci perutean AMQP:

capteurs/{{site}}/{{capteurId}}/mesures
commandes.{{pays}}.creees

Pratinjau nilai hasil resolusi

Di bawah kolom yang bersangkutan, Restorm menampilkan nilai hasil resolusi menurut lingkungan yang aktif. Inilah kebiasaan yang perlu dibangun sebelum bertanya-tanya mengapa sebuah panggilan menuju URL yang keliru: jawabannya hampir selalu terlihat di sana.

Pelengkapan otomatis

Ctrl+Space memicu pelengkapan otomatis di kolom yang mendukungnya: ia menawarkan variabel dari lingkungan saat ini dan helper Handlebars, lengkap dengan tanda tangan serta contohnya.

Yang perlu diketahui

• Ekspresi yang tidak terselesaikan (variabel tidak ada) menghasilkan string kosong — ia tidak memicu galat. Karena itulah pratinjaunya penting.
• Templatnya dikompilasi tanpa escaping HTML: sebuah & atau < di dalam suatu nilai lolos utuh, dan itulah perilaku yang diharapkan untuk JSON atau XML.
• Helper tanpa argumen ({{uuid}}, {{now}}, {{$randomEmail}}…) menghasilkan nilai yang berbeda pada setiap pengiriman. Itu memang disengaja, dan berguna untuk pengenal korelasi.

Referensi lengkap: Helper Handlebars.