Événements UiPath Data Fabric

Configurez les événements UiPath Data Fabric dans Integration Service pour déclencher des workflows sur les modifications au niveau des enregistrements via des notifications webhook.

Events

Un événement dans Data Fabric représente un changement d’état par rapport à un enregistrement d’entité. Data Fabric publie des événements dans Integration Service via un webhook — chaque fois qu'une modification au niveau de l'enregistrement se produit sur l'entité abonnée (par exemple, un enregistrement est créé ou mis à jour), Data Fabric envoie une notification qu'Integration Service redirige vers le déclencheur de workflow abonné. Pour de plus amples informations, consultez la documentation sur les déclencheurs .

Le connecteur UiPath Data Fabric prend en charge les événements suivants:

• Record created — Se déclenche lorsqu'un enregistrement est créé sur l'entité sélectionnée qui correspond au filtre configuré du déclencheur.
• Record updated — Se déclenche lorsqu'un enregistrement existant sur l'entité sélectionnée est mis à jour et que l'état post-mise à jour correspond au filtre configuré du déclencheur.

Les événements de connecteur UiPath Data Fabric sont livrés via un webhook.

Propriétés de l'événement

L'enveloppe d'événement comprend les propriétés suivantes présentes sur chaque événement Data Fabric.

Propriété	Description
UiPathEvent	Type d'événement (par exemple, CREATED, UPDATED)
UiPathEventObjectType	L’entité sur laquelle l’événement s’est produit (par exemple, Customer, Invoice)
UiPathEventObjectId	L'identifiant unique (Id) de l'enregistrement concerné (par exemple, 65747f9e-6442-f111-8ef2-000d3a350adf)
UiPathEventConnector	Le connecteur qui a démarré l'automatisation (toujours uipath-uipath-dataservice)

Sorties d'événement

Chaque événement UiPath Data Fabric génère une référence à un enregistrement d'entité. La sortie comprend tous les champs accessibles sur l’entité sélectionnée, en fonction des autorisations de l’utilisateur de connexion du déclencheur.

Événement (Event)	Type de sortie
Enregistrement créé	Entity Record
Enregistrement mis à jour	Entity Record

Pour de plus amples informations sur les autorisations de connexion des déclencheurs et la livraison d'événements, reportez-vous à Amélioration de la sécurité.

Déclencheurs connectés

Lorsqu'un déclencheur est connecté, le workflow est lancé avec les propriétés de l'enveloppe d'événement (n'inclut PAS la charge utile de l'enregistrement). Cependant, l'activité de déclencheur prend en charge la production automatique de cette charge utile d'enregistrement. Pour de plus amples informations sur l'utilisation des déclencheurs d'événement Integration Service, consultez la section Utilisation de déclencheurs dans Integration Service.

Comportement

• La propriété output de l'activité de déclencheur est l'enregistrement d'entité affecté, saisi comme schéma de l'entité. Les types de champs, les formats et l’accessibilité sont dérivés des métadonnées de l’entité au moment de la conception.
• Le workflow peut lire les champs directement à partir de output et les utiliser dans des activités en aval sans configuration supplémentaire.
• Les propriétés de l'enveloppe d'événement (UiPathEvent, UiPathEventObjectId, etc.) restent disponibles avec l'enregistrement résolu.

Déclencheurs déconnectés

Avec un déclencheur déconnecté, le workflow est lancé avec les propriétés de l'enveloppe d'événement UNIQUEMENT — la charge utile de l'enregistrement affecté n'est pas renseignée pour le workflow. L'auteur du workflow doit récupérer l'enregistrement lui-même à l'aide de l'identifiant contenu dans l'événement. Pour de plus amples informations sur l'utilisation des déclencheurs d'événement Integration Service, consultez la section Utilisation de déclencheurs dans Integration Service.

Comportement

Pour lire l’enregistrement, le workflow doit:

1. Acceptez une propriété d'entrée liée à UiPathEventObjectId (le Id de l'enregistrement concerné).
   • Le workflow peut également accepter l'une des autres propriétés de l'enveloppe d'événement (par exemple, UiPathEventObjectType, UiPathEvent, UiPathEventConnector) comme entrées s'il en a besoin.
2. Appelez l'activité Obtenir un enregistrement d'entité par ID contre l'entité à laquelle le déclencheur est abonné, en utilisant le Id de l'enregistrement affecté.
3. Utilisez l'enregistrement renvoyé dans les activités suivantes.