Champs bouton

Un champ button affiche un contrôle interactif sur un enregistrement. Il ne stocke rien. Il accepte par ailleurs les propriétés de base des champs.

- {
    id: 4,
    name: approve,
    type: button,
    label: Approve,
    action: automation,
    automation: approve_request,
  }

action est un vocabulaire fermé à deux valeurs

action: url exige url ; action: automation exige automation. Toute autre valeur — chaîne vide comprise — est refusée au démarrage.

Cette rigueur n'est pas de la coquetterie. action est la clé de dispatch sur laquelle s'appuient à la fois le rendu et le point d'entrée d'invocation : une valeur qu'aucun des deux ne reconnaît afficherait un bouton qui ne fait silencieusement rien une fois pressé. Refuser la configuration est le seul dénouement qui prévienne quelqu'un.

L'automatisation qu'un bouton nomme doit porter un déclencheur manual pour être invocable ainsi. Une automatisation déclenchée uniquement par un événement d'enregistrement ne peut pas être lancée par une personne.

N'afficher un bouton que sur certains enregistrements

visibleWhen nomme un champ de l'enregistrement et applique à sa valeur le vocabulaire de conditions partagé — eq, neq, in, notIn, contains, gt, lt, gte, lte. Plusieurs opérateurs se cumulent : tous doivent être vrais.

- {
    id: 5,
    name: ship,
    type: button,
    label: Ship,
    action: automation,
    automation: ship_order,
    visibleWhen: { field: status, eq: pending },
  }

C'est la grammaire qu'utilisent déjà les actions de ligne d'un tableau de données, pour que « n'afficher ce contrôle que sur certains enregistrements » s'écrive partout de la même façon.

Omettre visibleWhen affiche le bouton sur tous les enregistrements.

La visibilité n'est pas une permission

visibleWhen décide de ce qui est dessiné. Elle ne décide pas de ce qui peut s'exécuter : l'automatisation derrière le bouton reste soumise aux mêmes permissions que partout ailleurs, et un appelant qui atteint directement le point d'entrée d'invocation y est contrôlé. Servez-vous de visibleWhen pour écarter un contrôle sans objet d'un enregistrement, et du contrôle d'accès de l'automatisation elle-même pour en tenir un appelant non autorisé à l'écart.

Pages connexes

• Champs formule — l'autre façon de faire produire une valeur au moteur.
• Déclencheur manuel et chaînage — le déclencheur qu'une automatisation doit porter pour être invocable depuis un bouton.
• Présentation des types de champs — tous les types par catégorie.