Tables d'événements

Les tables d'événements permettent de choisir quelles tables Business Central publient des événements, quels champs sont inclus dans le payload JSON de chaque événement, et quels types d'événements se déclenchent réellement. Ouvrez cette page depuis l'action Event Tables de Event Bridge Setup, ou recherchez Event Tables dans Business Central.

Ajouter une table

1. Dans Event Tables, choisissez Add Table.

2. Recherchez la table pour laquelle vous souhaitez publier des événements (par exemple « Customer », « Sales Header ») et sélectionnez-la — double-cliquez sur une ligne, ou cochez-en plusieurs et choisissez Add Table pour les ajouter toutes en une fois.

   

   Résultat attendu : la table apparaît dans la liste avec 0 Active Fields et tous les types d'événements décochés. Aucun événement n'est encore envoyé — vous devez encore ajouter des champs et activer au moins un type d'événement ci-dessous.

Ajouter des champs au payload

1. Cliquez sur le nom de la table dans Event Tables pour ouvrir son Event Card.
2. Dans la partie Fields, choisissez Add Field.
3. Sélectionnez les champs à inclure — la liste affiche le numéro, le nom, la légende et le type de chaque champ, s'il fait partie de la clé primaire, et sa table de relation le cas échéant. Les champs de clé primaire et les FlowFields sont mis en évidence visuellement pour être repérés d'un coup d'œil. Choisissez Add Field pour ajouter votre sélection.

Chaque champ ajouté reçoit un Key Name — le nom de propriété sous lequel il apparaît dans le payload JSON — généré automatiquement à partir de la légende du champ (lettres, chiffres, underscore et tiret uniquement). Renommez-le si vous souhaitez une clé JSON différente ; les noms doivent rester uniques au sein de l'événement de cette table et ne peuvent utiliser que ces mêmes caractères.

Ajouter des champs liés

Certains champs pointent vers la clé primaire d'une autre table (visible sous forme de Relation Table Name dans le sélecteur de champs) — pour ceux-là, vous pouvez également récupérer des champs de l'enregistrement lié, pas seulement la clé elle-même.

1. Sur un champ ayant une relation, choisissez Add Related Field.

2. Sélectionnez des champs de la table liée de la même manière que pour l'ajout de champs ci-dessus.

   Résultat attendu : les champs liés apparaissent en retrait sous leur champ parent dans la liste, et s'imbriquent sous la clé de ce champ dans le payload JSON — par exemple, les champs ajoutés sous une relation « Sell-to Customer No. » apparaissent imbriqués sous la clé de ce champ, et non aplatis à côté. Vérifiez la forme exacte avec Message Preview.

Les champs liés sont recherchés en direct, en comparant la valeur actuelle du champ parent avec la clé primaire de la table liée au moment où l'événement se déclenche — ils ne sont pas stockés de manière redondante. Si aucun enregistrement correspondant n'existe à ce moment-là, la clé imbriquée est simplement omise du payload plutôt que d'être envoyée vide.

Activer les types d'événements

Dans le groupe Registered Events de l'Event Card, activez n'importe quelle combinaison de :

• Insert Event — un nouvel enregistrement a été créé.
• Modify Event — un enregistrement existant a changé.
• Rename Event — la clé primaire d'un enregistrement a changé.
• Delete Event — un enregistrement a été supprimé.

Vous avez besoin d'au moins un champ ajouté avant que l'un de ces éléments ne prenne effet. Si des champs existent mais qu'aucun type d'événement n'est activé, Business Central affiche une notification de rappel directement sur la carte. À l'inverse, la suppression de tous les champs d'une table désactive automatiquement les quatre types d'événements.

Include Previous Values (pertinent uniquement lorsque Modify ou Rename est activé) contrôle si ces événements incluent une comparaison before/after de la valeur de chaque champ, ou seulement les valeurs actuelles (after) seules — les payloads de comparaison ont une taille environ double, donc laissez-le désactivé si votre intégration n'a pas besoin de voir ce qui a changé, seulement le fait que cela a changé.

Filtrer les changements publiés

Insert Filter et Modify Filter sur un champ (champs de premier niveau uniquement — pas les champs liés/détail, ni les champs Media/MediaSet) restreignent le déclenchement de ce type d'événement, en utilisant la syntaxe de filtre standard de Business Central (par exemple >100, A|B, <>'') évaluée par rapport à la valeur de ce champ au moment de l'événement.

Si vous définissez des filtres sur plusieurs champs, ils doivent tous correspondre — ils se combinent en ET, pas en OU. Une table sans aucun filtre défini déclenche toujours ses événements, sans filtrage.

Utilisez Message Preview pour vérifier si un enregistrement spécifique passe actuellement vos filtres (affiché sous forme de ✅/❌) avant de vous y fier en production.

Supprimer une table ou un champ

• Supprimez une ligne dans la partie Fields pour arrêter d'envoyer ce champ — tous les champs liés imbriqués en dessous sont supprimés en même temps.
• Supprimez une table de Event Tables pour arrêter complètement de publier des événements pour celle-ci, y compris tous ses champs configurés.