Aller au contenu principal

Utiliser Handlebars

Handlebars est le moteur de templates utilisé dans Ecosystem pour créer des valeurs dynamiques.

Vue d'ensemble​

Handlebars permet de :

  • Insérer des variables dans les configurations
  • Créer des expressions conditionnelles
  • Parcourir des tableaux
  • Transformer des données

Syntaxe de base​

Variables simples​

{{variableName}}

Propriétés d'objets​

{{object.property}}
{{order.customer.name}}

Contexte​

Accès aux données du contexte :

  • {{trigger.body}} : Données du trigger
  • {{httpRequest.body}} : Résultat d'un nœud HTTP Request
  • {{item}} : Élément courant dans une boucle ForEach

Expressions conditionnelles​

If​

{{#if condition}}
  Contenu si vrai
{{/if}}

If/Else​

{{#if condition}}
  Contenu si vrai
{{else}}
  Contenu si faux
{{/if}}

Unless​

{{#unless condition}}
  Contenu si faux
{{/unless}}

Boucles​

Each​

Parcourir un tableau :

{{#each items}}
  {{name}} - {{price}}
{{/each}}

Avec index :

{{#each items}}
  {{@index}}: {{name}}
{{/each}}

Helpers​

Comparaisons​

{{#if (eq status "active")}}
  Actif
{{/if}}

Opérations​

{{add a b}}
{{subtract a b}}
{{multiply a b}}
{{divide a b}}

Exemples​

Exemple 1 : URL dynamique​

{
  "url": "https://api.example.com/users/{{userId}}/orders/{{orderId}}"
}

Exemple 2 : Body conditionnel​

{
  "body": {
    "status": "{{#if approved}}approved{{else}}pending{{/if}}"
  }
}

Exemple 3 : Liste dans email​

<ul>
  {{#each order.items}}
  <li>{{name}} - {{quantity}} x {{price}}</li>
  {{/each}}
</ul>

Bonnes pratiques​

  • Validation : Vérifiez que les variables existent
  • Sécurité : Évitez d'injecter du code non validé
  • Performance : Évitez les expressions trop complexes
  • Documentation : Documentez les variables utilisées

Prochaines étapes​