Configuration d'Event Bridge

Recherchez Event Bridge Setup (ou rabbitmq / service bus / event broker) dans Business Central pour l'ouvrir. C'est une page de configuration unique, à l'échelle de l'entreprise — il n'y a pas de surcharge par table du point de terminaison ou de l'autorisation, seulement des champs et types d'événements que chaque Table d'événements envoie.

Général

Champ	Remarques
Endpoint Type	RabbitMQ, API endpoint, Azure Service Bus, Azure Event Hub, Azure Queue Storage, ou Azure Event Grid — détermine le groupe de champs ci-dessous qui s'applique, et la manière dont les événements sont formatés lors de l'envoi.
Authorization	No Auth, Basic Auth, API Key, OAuth 2.0, Azure SAS Token, Storage SAS Token, ou Event Grid SAS Token — détermine le groupe d'autorisation ci-dessous qui s'applique. Tous les Endpoint Type n'acceptent pas toutes les méthodes d'autorisation ; consultez Authentification pour savoir quelles combinaisons sont valides et pourquoi.
Include User Data	Ajoute l'ID, le nom et l'e-mail de l'utilisateur agissant aux en-têtes de chaque événement, pour les pistes d'audit ou le suivi des erreurs. Cela peut contenir des données personnelles — n'activez cette option que si votre système en aval est censé les recevoir.
Language	La langue utilisée à la fois pour interpréter les filtres Insert/Modify et pour formater les valeurs des champs Option/Enum dans le payload JSON. Cela garantit une sortie cohérente quelle que soit l'action de l'utilisateur ayant déclenché l'événement — sans cela, le texte d'un champ Enum pourrait s'afficher dans la langue de session de l'utilisateur agissant. Par défaut : anglais (US) ; utilisez la recherche du champ pour la modifier.
Max Retry Attempts	Le nombre de fois qu'un événement en échec est automatiquement retenté avant d'être marqué Error dans la File d'attente des événements — uniquement pour les échecs pouvant être retentés (une erreur réseau, ou une réponse HTTP 5xx, 408, ou 429) ; tout autre échec échoue immédiatement sans nouvelle tentative. De 1 à 10, par défaut 5. Voir File d'attente des événements → Fonctionnement de la livraison.

Endpoint

API URL (RabbitMQ) et API Endpoint (API endpoint) sont les deux seuls champs ici où vous indiquez une URL de votre choix — tous les autres Endpoint Type sont un service cloud Microsoft fixe, assemblé à partir d'un nom d'espace de noms ou de compte, et utilisent toujours HTTPS. Si l'un de ces deux champs commence par http://, Business Central le met en surbrillance jaune (Ambiguous) en guise d'avertissement, et non de blocage strict — il s'enregistre et fonctionne quand même. En HTTPS, TLS assure déjà le chiffrement et l'intégrité de l'ensemble de la requête, en-têtes compris, de sorte que personne sur le chemin réseau ne peut la lire ou la modifier ; le HTTP simple n'offre rien de tout cela, donc tout ce qui y est envoyé — y compris vos identifiants d'autorisation — circule en clair. Ne pointez ces champs vers http:// que pour des tests locaux contre un broker ou un point de terminaison que vous contrôlez ; utilisez https:// pour tout ce qui atteint la production.

RabbitMQ (Endpoint Type = RabbitMQ)

Champ	Remarques
API URL	L'URL de base de l'API de gestion RabbitMQ. Doit commencer par http:// ou https:// ; les barres obliques finales sont supprimées automatiquement.
Virtual Host	L'hôte virtuel RabbitMQ dans lequel publier. Les barres obliques en début/fin sont supprimées automatiquement.
Exchange Type	Direct, Fanout, Headers, Topic (par défaut), ou Custom. Doit correspondre à la façon dont l'échange est réellement configuré dans RabbitMQ.
Custom Exchange	Le nom d'un échange que vous avez déjà créé dans l'hôte virtuel RabbitMQ. Modifiable — et requis — uniquement lorsque Exchange Type est Custom ; ignoré sinon. Ne peut pas commencer par amq., que RabbitMQ réserve à ses propres échanges intégrés.
Publish URL	Lecture seule. L'URL complète vers laquelle les événements sont envoyés en POST, construite à partir des champs ci-dessus sous la forme {API URL}/exchanges/{Virtual Host}/{Exchange Name}/publish — le nom de l'échange est l'un des noms AMQP intégrés par défaut (amq.direct, amq.fanout, amq.headers, amq.topic) correspondant à Exchange Type, ou la valeur de Custom Exchange lorsque Exchange Type est Custom. Utile pour vérifier que les autres champs se combinent comme prévu.

Accepte uniquement les autorisations No Auth, Basic Auth, ou OAuth 2.0 — voir Authentification.

API endpoint (Endpoint Type = API endpoint)

Champ	Remarques
API Endpoint	L'URL qui reçoit un POST JSON brut pour chaque événement.

Accepte uniquement les autorisations No Auth, Basic Auth, API Key, ou OAuth 2.0 — voir Authentification. Pour des instructions détaillées afin de pointer ceci vers Zapier, Make.com, ou Power Automate, voir Zapier, Make.com & Power Automate.

Azure Service Bus (Endpoint Type = Azure Service Bus)

Champ	Remarques
Namespace	L'espace de noms Service Bus, par ex. mynamespace — sans le suffixe .servicebus.windows.net, qui est supprimé automatiquement si vous le collez quand même.
Queue/Topic Name	Le nom de la file d'attente ou du topic Service Bus dans lequel publier les messages. Les barres obliques en début/fin sont supprimées automatiquement.
Publish URL	Lecture seule. L'URL complète vers laquelle les événements sont envoyés en POST, construite à partir des deux champs ci-dessus — utile pour vérifier qu'ils se combinent comme prévu.

Accepte uniquement OAuth 2.0 ou un Azure SAS Token — voir Authentification.

Azure Event Hub (Endpoint Type = Azure Event Hub)

Champ	Remarques
Namespace	L'espace de noms Event Hubs, par ex. mynamespace — sans le suffixe .servicebus.windows.net, qui est supprimé automatiquement si vous le collez quand même.
Event Hub Name	Le nom de l'Azure Event Hub dans lequel publier les événements. Les barres obliques en début/fin sont supprimées automatiquement.
Publish URL	Lecture seule. L'URL complète vers laquelle les événements sont envoyés en POST, construite à partir des deux champs ci-dessus — utile pour vérifier qu'ils se combinent comme prévu.

Accepte uniquement OAuth 2.0 ou un Azure SAS Token — voir Authentification.

Azure Queue Storage (Endpoint Type = Azure Queue Storage)

Champ	Remarques
Storage Account Name	Le nom du compte de stockage Azure, par ex. mystorageaccount — sans le suffixe .queue.core.windows.net, qui est supprimé automatiquement si vous le collez quand même.
Queue Name	Le nom de la file d'attente Azure Storage dans laquelle publier les messages. Doit être en minuscules ; elle est automatiquement convertie en minuscules si vous la saisissez avec des majuscules.
Publish URL	Lecture seule. L'URL complète vers laquelle les événements sont envoyés en POST, construite à partir des deux champs ci-dessus — utile pour vérifier qu'ils se combinent comme prévu.

Accepte uniquement OAuth 2.0 ou un Storage SAS Token — voir Authentification.

Azure Event Grid (Endpoint Type = Azure Event Grid)

Champ	Remarques
Topic Endpoint	L'URL du point de terminaison du topic Event Grid, copiée depuis Overview sur le topic dans le portail Azure, par ex. https://mytopic.westus2-1.eventgrid.azure.net/api/events. Doit commencer par http:// ou https:// ; les barres obliques finales sont supprimées automatiquement.

Accepte uniquement API Key, OAuth 2.0, ou un Event Grid SAS Token — voir Authentification. Si vous utilisez API Key, le champ Key ci-dessous doit être défini sur aeg-sas-key, le nom d'en-tête attendu par Event Grid. Le topic doit également être configuré pour Event Grid Schema, et non CloudEvents v1.0 — voir Authentification → Azure Event Grid.

Limites de taille du payload

Event Bridge ne plafonne pas lui-même la taille du payload — le nombre de champs que vous pouvez enregistrer sur une table avant qu'un événement soit rejeté dépend entièrement de la limite propre à l'API REST du point de terminaison :

Endpoint	Appel REST utilisé	Limite de taille
API endpoint	L'URL que vous configurez	Aucune limite imposée par Event Bridge — entièrement à la discrétion du serveur récepteur.
RabbitMQ	Plugin de gestion POST /api/exchanges/{vhost}/{exchange}/publish	Régie par le paramètre management.http_max_body_size du broker (généralement quelques dizaines de Mo) — mais la documentation officielle de RabbitMQ décrit ce point de terminaison comme destiné uniquement aux messages de test, et non au trafic de production.
Azure Queue Storage	API REST Storage Put Message	64 Ko sur le réseau, une limite stricte. Event Bridge encode le JSON en base64 dans <QueueMessage><MessageText>, donc une fois pris en compte le surcoût d'environ 33 % du base64 et l'enveloppe XML, le payload JSON brut plafonne effectivement à environ ~47 Ko.
Azure Service Bus	Messagerie intermédiée POST .../messages	256 Ko par message sur le niveau Standard. Niveau Premium : 1 Mo par défaut, jusqu'à 100 Mo si l'option large messages est explicitement activée sur l'espace de noms.
Azure Event Hub	POST .../messages (Send Event)	1 Mo par événement sur le niveau Standard (relevé par rapport à l'ancienne limite de 256 Ko). Les unités de capacité Premium/Dedicated peuvent être configurées plus haut.
Azure Event Grid	API REST Publish Events du topic personnalisé	1 Mo par événement, et 1 Mo par lot/requête. Event Bridge envoie toujours un événement par appel, donc ce 1 Mo couvre l'intégralité de l'objet événement enveloppé (id, subject, eventType, eventTime, data.headers + data.payload, dataVersion) — pas seulement vos champs de payload.

Si vous êtes proche d'une limite : Include Previous Values double à peu près le payload avec sa comparaison before/after, et Include User Data ajoute une petite quantité fixe de métadonnées en plus — intégrée directement dans le corps pour RabbitMQ, Azure Queue Storage, et Azure Event Grid spécifiquement (voir En-têtes et propriétés). Plutôt que d'estimer à la main, consultez Message Preview — il affiche la taille estimée réelle du corps réseau pour un enregistrement réel avant que vous ne l'enregistriez en production.

Autorisation

Les méthodes d'autorisation disponibles dépendent de l'Endpoint Type sélectionné ci-dessus — voir Authentification pour la matrice de compatibilité complète et la référence des champs pour chacune des méthodes No Auth, Basic Auth, API Key, OAuth 2.0, Azure SAS Token, Storage SAS Token, et Event Grid SAS Token.

Actions

• Send Test Payload (Processing) — envoie un seul événement factice directement vers le point de terminaison configuré, en utilisant l'Endpoint Type et l'Authorization actuellement définis, indépendamment de toute table enregistrée. Permet de confirmer que vos paramètres de connexion fonctionnent avant d'enregistrer de vraies tables. Voir Tests et dépannage.
• Schedule Automatic Retries (Processing) — crée une entrée de file d'attente de tâches récurrente (toutes les 5 minutes) qui réinitialise les entrées bloquées de la File d'attente des événements et reprend toute table dont la livraison a été perdue. Configurez ceci une fois, comme filet de sécurité — voir File d'attente des événements → Fonctionnement de la livraison.
• Event Tables (Navigation) — ouvre la liste des tables actuellement enregistrées pour les événements. Voir Tables d'événements.
• Event Queue (Navigation) — ouvre la liste de tous les événements capturés et de leur statut de livraison. Voir File d'attente des événements.

Qui peut ouvrir cette page

La configuration de Setup nécessite l'ensemble de permissions Event Bridge Admin — voir Licences et accès pour savoir comment celui-ci est attribué.