À propos des records : mapper des champs dans un scénario
Records : mapper des champs
1. Allez dans Interfaces
2. Ouvrez l'interface
4. Allez dans l'onglet Scenarios
Remarque : vous n'avez pas besoin de répéter les étapes 1 à 3 et 7 pour chaque record ajouté. Vous pouvez ajouter plusieurs records dans un même brouillon en répétant les étapes 5 et 6, puis les publier en une seule fois.
FAQ
Après l'ajout et la publication d'un nouveau record, l'interface s'exécute-t-elle immédiatement, c'est-à-dire, les données sont-elles transférées du système source vers le système cible ?
Non. La publication de l'interface ne déclenche pas de synchronisation. L'interface ne s'exécute que lorsque vous cliquez manuellement sur le bouton Run ou lorsqu'une planification est définie.
Puis-je ajouter un record à un scénario qui s'exécute actuellement selon une planification ?
Oui. Pour ajouter un record, vous passez en mode Draft, ce qui n'interrompt et n'affecte aucune exécution planifiée. Le nouveau record ne prend effet qu'une fois le brouillon publié. Les exécutions planifiées qui ont lieu avant la publication continuent d'utiliser la version publiée précédente de l'interface.
Remarque : Si une exécution planifiée est en cours au moment précis où vous publiez, elle se termine avec la version avec laquelle elle a démarré. La nouvelle version est utilisée à partir de l'exécution planifiée suivante.
Quelle est la différence entre ajouter un record et ajouter un champ à un record existant ?
Un record définit un mapping entre un ou plusieurs champs source et un ou plusieurs champs cible. Ajouter un record crée un mapping entièrement nouveau : un champ cible qui n'était pas mappé auparavant recevra désormais des données.
Ajouter un champ à un record existant revient à étendre un mapping existant. Par exemple, si un record mappe déjà First Name vers Full Name, vous pouvez ajouter Last Name à ce même record afin que les deux champs soient combinés dans le même champ cible.
Deux records d'un même scénario peuvent-ils cibler le même champ ?
Non. Chaque champ cible ne peut être utilisé que dans un seul record par scénario. Si vous essayez d'utiliser deux fois le même champ cible, BrynQ affiche l'avertissement : "The same library field cannot be used multiple times as a target field in this scenario." Si vous souhaitez que plusieurs champs source alimentent le même champ cible, ajoutez-les plutôt au même record.
Plusieurs champs source peuvent-ils alimenter le même champ cible ?
Oui. Un même record peut avoir plusieurs champs source côté source. Les paramètres Logic et Transformation du record déterminent comment ces valeurs source sont combinées dans le champ cible, par exemple en concaténant First Name et Last Name dans Full Name. Utilisez cette approche lorsque vous souhaitez enrichir un champ cible plutôt que de créer un mapping distinct.
Un record nouvellement ajouté s'applique-t-il rétroactivement aux données déjà synchronisées ?
Non. Un nouveau record n'affecte les données qu'à partir de la prochaine synchronisation. Les données synchronisées avant l'ajout du record ne sont pas mises à jour rétroactivement.
Puis-je annuler un record que je viens d'ajouter si je n'ai pas encore publié ?
Oui. Tant que vous n'avez pas publié, toutes les modifications n'existent que dans le brouillon et la version en production reste intacte. Vous pouvez supprimer le record ou abandonner tout le brouillon, et l'interface en production continuera de fonctionner exactement comme avant.
Qu'arrive-t-il aux données déjà présentes dans le système cible si je supprime un record ?
Rien n'est supprimé dans le système cible. La suppression d'un record empêche les exécutions futures d'écrire dans ce champ cible, mais les données que BrynQ a déjà envoyées au système cible y restent. BrynQ ne revient pas dans le système cible pour nettoyer les données synchronisées auparavant.
Puis-je désactiver temporairement un record sans le supprimer ?
Oui. Cliquez sur l'icône pause à droite de la ligne du record pour le désactiver. Le record est déplacé dans une section Inactive et conservé avec tous ses paramètres, mais le scénario cesse de le synchroniser. Vous pouvez le réactiver à tout moment pour reprendre la synchronisation.
Le champ source que je veux mapper n'apparaît pas. Que faire ?
Le sélecteur de champs n'affiche que les champs qui existent dans le schéma publié de l'application source. Si un champ manque, soit il n'a pas encore été ajouté à la définition du connecteur (une modification au niveau administrateur), soit vous pouvez utiliser un type de champ Fixed, Customou Configuration sur le record au lieu d'un champ Library.
De quelle autorisation ai-je besoin pour ajouter un record ?
Vous avez besoin d'un accès Edit sur l'interface. Les utilisateurs disposant d'un accès en lecture seule peuvent ouvrir l'interface, mais ne peuvent pas modifier les records ni passer en mode Draft.
Pourquoi le bouton Publish est-il grisé après l'ajout de mon record ?
Cela signifie qu'une ou plusieurs exigences de validation ne sont pas encore remplies. Les raisons les plus courantes sont :
- Le scénario n'a pas de record de clé unique.
- L'onglet Authorization contient des avertissements non résolus.
- Le même champ cible est utilisé dans plusieurs records.
Repérez les triangles d'avertissement jaunes dans la barre d'onglets : ils indiquent les onglets où le problème doit être résolu.
Les records existants peuvent être modifiés. Vous pouvez ajouter, supprimer ou modifier des champs dans un record.
Dans l'exemple ci-dessous, un record existant est modifié en remplaçant un champ source par un autre. Résultat : lors de l'exécution de l'interface, le champ cible sera désormais alimenté par les données du nouveau champ source.
5b.1 : supprimez l'ancien champ
FAQ
Après la modification et la publication de l'interface, celle-ci s'exécute-t-elle immédiatement, c'est-à-dire, les données sont-elles transférées du système source vers le système cible ?
Non. La publication de l'interface ne déclenche pas de synchronisation. L'interface ne s'exécute que lorsque vous cliquez manuellement sur le bouton Run ou lorsqu'une planification est définie.
Puis-je annuler les modifications apportées à un record après la publication ?
Oui. Vous avez deux options : revenir à une version précédente de l'interface [link], ou annuler manuellement les modifications en repassant en mode Draft et en les inversant selon les étapes décrites ci-dessus.
Y a-t-il une limite au nombre de champs que je peux ajouter à un record ?
Il n'y a pas de limite stricte. Il est toutefois déconseillé d'ajouter plus de 3 champs source ou cible à un même record, sauf s'il existe une raison claire de le faire.
L'interface fonctionnera-t-elle correctement dès que je l'exécuterai après la modification d'un record ?
Cela dépend de la nature de la modification. Les modifications mineures ont plus de chances de fonctionner directement, tandis que des changements plus importants peuvent nécessiter des tests et des ajustements avant que la synchronisation fonctionne correctement.
Si je supprime un champ d'un record, les données déjà transférées vers le système cible seront-elles supprimées ?
Pas nécessairement, mais cela peut avoir des conséquences inattendues.
Imaginons par exemple que le mapping suivant soit configuré :
First Name + Last Name → Full Name
Lors de la première synchronisation, cela donne :
John + Doe → John Doe
Si vous supprimez ensuite First Name du record, le mapping devient :
Last Name → Full Name
Lors de la synchronisation suivante, le champ cible est écrasé avec le nom de famille uniquement :
Doe → John Doe devient Doe
La valeur synchronisée précédemment est perdue, car l'interface a désormais une autre définition de ce que Full Name doit contenir.
FAQ
Que fait réellement la désactivation ? Le record est-il supprimé définitivement ?
Non. Désactiver un record n'est pas une suppression définitive. Le record quitte le tableau actif pour la section Inactive du scénario. Sa configuration complète (champ source, champ cible, mapping et logique) est conservée. Le record cesse simplement d'être synchronisé à la prochaine exécution. Vous pouvez le restaurer à tout moment depuis la section Inactive.
Pourquoi l'icône pause est-elle grisée sur certains records ?
Un record peut ne pas pouvoir être désactivé pour deux raisons :
- Il s'agit de la clé unique du scénario (🔑). Chaque scénario nécessite un record marqué comme identifiant unique. Sans lui, BrynQ ne peut pas distinguer les employés. Pour le désactiver, marquez d'abord un autre record comme clé unique.
- Il est marqué comme obligatoire. Soit le système cible exige ce champ dans chaque enregistrement qu'il reçoit (la synchronisation échouerait sans lui), soit l'interface a été créée à partir d'un template qui définit ce record comme obligatoire. Le désactiver casserait l'interface, c'est pourquoi BrynQ grise l'icône.
La désactivation d'un record supprime-t-elle les données déjà synchronisées vers le système cible ?
Non. La désactivation d'un record empêche les exécutions futures d'écrire dans ce champ cible, mais elle ne supprime pas et n'annule pas les données que BrynQ a déjà envoyées. Si vous devez aussi effacer les valeurs existantes dans le système cible, faites-le directement dans le système cible.
Puis-je annuler une désactivation avant de publier ?
Oui. La désactivation a lieu en mode Draft, l'interface en production reste donc intacte. Tant que vous n'avez pas cliqué sur Publish et confirmé, vous pouvez restaurer le record depuis la section Inactive ou abandonner tout le brouillon pour annuler toutes les modifications.
Puis-je désactiver un record pendant que l'interface s'exécute selon une planification ?
Oui. La modification n'existe qu'en mode Draft et n'affecte pas les exécutions planifiées tant que vous n'avez pas publié. Les exécutions planifiées lancées avant la publication continuent de synchroniser ce champ avec la version publiée précédente.
Remarque : Si une exécution planifiée est en cours au moment précis où vous publiez, elle se termine avec l'ancienne version. L'exécution planifiée suivante prendra en compte la modification.
La prochaine exécution planifiée appliquera-t-elle ma désactivation rétroactivement ?
Non. Une désactivation n'affecte que les exécutions qui démarrent après sa publication. Les exécutions passées ne sont pas relancées et les données historiques déjà écrites dans le système cible restent telles quelles.
Existe-t-il une étape de confirmation avant qu'une désactivation soit mise en production ?
La désactivation elle-même est immédiate dans le brouillon : la ligne passe dans la section Inactive dès que vous cliquez sur l'icône pause. La confirmation de sécurité intervient au moment de la publication : BrynQ affiche la boîte de dialogue "Warning! You are about to publish your draft" que vous devez confirmer avant que les modifications ne soient mises en production. Tant que vous n'avez pas confirmé, la désactivation reste réversible.
Puis-je désactiver plusieurs records à la fois ?
Pas pour le moment : les records sont désactivés un par un. Vous pouvez toutefois désactiver plusieurs records successivement dans le même brouillon, puis publier une seule fois, afin que toutes les modifications soient mises en production ensemble en une seule mise à jour.
Quelle est la différence entre désactiver un record et désactiver un scénario entier ?
Désactiver un record coupe un seul mapping dans un scénario : le reste du scénario continue de se synchroniser normalement. Désactiver un scénario coupe tous ses records et arrête l'ensemble du flux de données pour ce sujet.
Désactivez un record lorsque vous souhaitez que la majeure partie du scénario continue de se synchroniser tout en ignorant un seul champ. Désactivez le scénario lorsque tout le flux de données de ce sujet doit être mis en pause.
Qu'advient-il du mapping de valeurs (table de conversion) utilisé par le record désactivé ?
Le mapping de valeurs n'est pas affecté. Les mappings de valeurs se trouvent dans l'onglet Mapping , indépendamment de tout record. Désactiver un record qui faisait référence à un mapping laisse ce mapping intact et disponible pour d'autres records.
La désactivation d'un record a-t-elle un effet sur le système source ?
Non. BrynQ se contente de lire le système source et ne modifie jamais ses données ni son schéma. Désactiver un record signifie simplement que ce scénario cesse de lire ce champ source à la prochaine exécution. Le champ continue d'exister sans changement dans le système source.