Déclencheurs d'enregistrement et de commentaire

Les deux déclencheurs qui naissent de l'activité à l'intérieur de votre application : une ligne qui change, et quelqu'un qui parle d'une ligne.

Déclencheur d'enregistrement

Se déclenche lorsque des enregistrements changent dans une table surveillée.

trigger:
  type: record
  table: orders
  events: [create, update]
  watchFields: [status]
  condition:
    conditions:
      - field: '{{trigger.data.record.status}}'
        operator: equals
        value: paid

Propriété	Description
table	Nom de la table à surveiller. Obligatoire, non vide.
events	Tableau de create / update / delete. Obligatoire, au moins une entrée.
watchFields	Sur update, ne se déclenche que si l'un de ces champs change. Au moins une entrée si présent.
condition	Un groupe de conditions — ne se déclenche que si la ligne correspond.

watchFields et condition répondent à deux questions différentes. watchFields demande ce qui a changé ; condition demande à quoi ressemble la ligne désormais. L'exemple ci-dessus ne se déclenche que si status a été touché et que le statut résultant est paid : une commande passée de pending à paid déclenche, une commande dont l'adresse de livraison est corrigée non.

Contexte de l'enregistrement

La ligne est à {{trigger.data.record.*}} (également accessible via {{trigger.record.*}}). Elle n'est pas aplatie : {{trigger.data.status}} ne se résout donc pas. Deux autres chemins sont disponibles :

Chemin	Disponible sur	Contient
{{trigger.data.record.*}}	tous les événements	La ligne après le changement.
{{trigger.data.previousRecord.*}}	update seulement	La ligne avant le changement.
{{trigger.data.records}}	écritures par lot	L'ensemble des lignes affectées.

previousRecord est ce qui rend « notifier quand le statut quitte draft » exprimable sans conserver d'état entre deux exécutions.

Déclencheur de commentaire

Se déclenche lorsqu'un commentaire est créé sur un enregistrement d'une table où les commentaires sont activés.

trigger:
  type: comment
  table: tickets
  when: created
  filter: { mentionsOnly: true }

Propriété	Description
table	Nom de la table avec commentaires activés. Obligatoire, non vide.
when	approved (modérés approuvés uniquement), created (tout nouveau commentaire) ou any. Par défaut created.
filter	{ topLevelOnly, repliesOnly, mentionsOnly } — topLevelOnly et repliesOnly s'excluent mutuellement.
respectReadPermissions	Ne se déclenche que si l'auteur du commentaire peut lire l'enregistrement. Par défaut true.

Choisissez when selon ce que fait l'automatisation. approved convient à tout ce qui est visible des utilisateurs, car un commentaire modéré ne devrait pas alerter un canal avant qu'un humain ne l'ait validé. created convient aux notifications internes qui veulent le commentaire dès son arrivée.

Les déclencheurs de commentaire exposent $trigger.comment.*, $trigger.record.*, $trigger.threadParticipants et $trigger.mentions — de quoi notifier les participants d'un fil sans requête supplémentaire.

Pages connexes

• Présentation des déclencheurs — les neuf types en un coup d'œil.
• Contrôle de flux — le modèle de groupe de conditions employé par condition.
• Actions sur les enregistrements — réécrire des lignes depuis une automatisation.
• Historique des enregistrements — la piste de révisions derrière previousRecord.
• Permissions de table — le prédicat read.when honoré par respectReadPermissions.