Mapping

Résumé : Découvrez comment le Mapping relie les données source aux données cible dans une interface BrynQ, pourquoi les mappings sont nécessaires et comment les créer, importer, modifier, exporter et maintenir.

Prérequis : - Vous avez besoin d'une interface avec des applications source et cible. - Vous avez besoin d'un brouillon modifiable pour changer les mappings. Les versions publiées, anciennes, désactivées ou en lecture seule peuvent être consultées, mais pas modifiées.

Utiliser le Mapping dans une interface

Mapping indique à BrynQ comment les valeurs d'une application source doivent devenir des valeurs pour une application cible.

Comprendre ce qu'est un mapping

Une application source est le système dans lequel BrynQ lit les données.
Une application cible est le système dans lequel BrynQ écrit les données.
Un mapping est un tableau de règles entre valeurs source et valeurs cible. Chaque ligne indique : lorsque BrynQ reçoit cette valeur source, envoyer cette valeur cible.
Une colonne d'entrée contient les valeurs côté source.
Une colonne de sortie contient les valeurs côté cible.
Une ligne de mapping est une règle de conversion du tableau.
Set all unmapped values as est une valeur de repli. BrynQ l'utilise lorsqu'une valeur source ne figure pas dans le tableau de mapping.

Pourquoi le mapping est nécessaire

Différentes applications utilisent souvent des noms ou des codes différents pour une même signification métier.
Le mapping empêche BrynQ d'envoyer une valeur source que l'application cible ne comprend pas.
Le mapping rend aussi les règles de données visibles, afin que les utilisateurs et les intégrateurs puissent vérifier quelles valeurs sont autorisées avant l'exécution d'une interface.
Sans mapping correct, l'interface peut envoyer une mauvaise valeur, ignorer des valeurs ou nécessiter des corrections supplémentaires pendant l'implémentation.

Exemple

Une application RH source envoie le type de contrat sous la forme Full-time, Part-time et Contractor.
L'application de paie cible attend FT, PT et EXT.
Dans Mapping, créez une colonne d'entrée pour le type de contrat source et une colonne de sortie pour le code de paie cible.
Ajoutez une ligne de mapping pour chaque conversion :
Full-time devient FT.
Part-time devient PT.
Contractor devient EXT.
Lors de l'exécution de l'interface, BrynQ lit la valeur source et envoie la valeur cible correspondante.

Ouvrir l'onglet Mapping

Ouvrez l'interface sur laquelle vous souhaitez travailler.
Dans l'en-tête de l'interface ou le sélecteur de version, sélectionnez le bon brouillon modifiable.
Dans le menu de l'interface, allez dans Mapping.
Vérifiez l'en-tête de la page pour vous assurer que vous mappez les bonnes applications source et cible.

Créer ou importer un mapping

Vous pouvez créer un mapping manuellement dans BrynQ ou l'importer depuis un fichier si vous avez déjà les valeurs dans un tableur.

Créer manuellement un nouveau mapping

Dans la vue vide, cliquez sur New Mapping.
Si l'interface contient déjà des mappings, utilisez la barre latérale gauche et cliquez sur New Mapping en bas.
En haut de l'éditeur de mapping, cliquez sur le nom du mapping si vous souhaitez le renommer. Utilisez un nom qui explique la valeur métier, par exemple Employment type to payroll code.
Dans l'en-tête du tableau, utilisez Add column côté source lorsque la conversion nécessite une autre valeur d'entrée.
Dans l'en-tête du tableau, utilisez Add column côté cible lorsque la conversion nécessite une autre valeur de sortie.
Remplissez les lignes du tableau. Chaque ligne doit contenir une conversion complète de la source vers la cible.

Importer un mapping depuis un fichier

Sur la page Mapping, cliquez sur Import mapping.
Dans la fenêtre Import data for mapping, utilisez File pour téléverser un fichier .csv ou .xlsx.
Si vous téléversez un fichier Excel, sélectionnez la bonne Sheet.
Si vous téléversez un fichier CSV, choisissez le bon Delimiter. Cela indique à BrynQ comment le fichier sépare les colonnes, par exemple par une virgule, un point-virgule, une barre verticale ou une tabulation.
Renseignez Mapping name.
Utilisez Input range pour sélectionner les colonnes du fichier qui contiennent les valeurs source.
Utilisez Output range pour sélectionner les colonnes du fichier qui contiennent les valeurs cible.
Activez Set first row as column name lorsque la première ligne contient des noms de colonnes plutôt que des valeurs de mapping.
Vérifiez Sheet preview pour confirmer que BrynQ lit correctement le fichier.
En bas à droite de la fenêtre, cliquez sur Apply and import.

Choisir entre mapping manuel et mapping importé

Utilisez New Mapping lorsque le tableau est petit ou que vous souhaitez créer les règles directement dans BrynQ.
Utilisez Import mapping lorsque le mapping comporte de nombreuses lignes, existe déjà dans Excel ou CSV, ou doit d'abord être vérifié en dehors de BrynQ.
Après l'importation, vérifiez quand même les lignes dans BrynQ. Un mauvais délimiteur, une mauvaise feuille ou un mauvais réglage de la première ligne peut placer des valeurs dans les mauvaises colonnes.

Modifier et maintenir les mappings

Les modifications des mappings sont enregistrées automatiquement lorsque vous travaillez dans un brouillon modifiable.

Modifier un mapping existant

Dans la barre latérale gauche Mappings, sélectionnez le mapping à modifier.
En haut de l'éditeur, cliquez sur le nom du mapping pour le renommer.
Utilisez Add column uniquement lorsqu'une conversion nécessite plusieurs valeurs d'entrée ou plusieurs valeurs de sortie.
Mettez à jour les cellules du tableau lorsque les valeurs source ou cible changent.
Utilisez Set all unmapped values as uniquement lorsque toutes les valeurs source manquantes doivent devenir la même valeur cible. Laissez ce champ vide si les valeurs non mappées doivent rester visibles pour vérification.

Exporter ou supprimer un mapping

Dans la barre latérale gauche Mappings, sélectionnez le mapping à utiliser.
Dans la zone d'actions en haut à droite de l'éditeur de mapping, cliquez sur l'icône d'export pour télécharger le mapping actuel au format CSV.
Pour supprimer un mapping, utilisez l'icône de corbeille à côté du mapping dans la barre latérale gauche.

Garder des mappings propres

Utilisez des noms de mapping clairs qui décrivent la valeur source et la valeur cible.
Gardez une seule signification métier par mapping. Par exemple, séparez le mapping du type de contrat de celui du service.
Vérifiez les fichiers importés avant et après l'importation.
Supprimez les anciens mappings qui ne sont plus utilisés.
Vérifiez à nouveau les mappings lorsqu'une application source ou cible modifie ses valeurs autorisées.

Plus d'informations

Le mapping de l'onglet Mapping est différent du choix des champs dans Scenarios. Les Scenarios déterminent quelles données font partie d'un flux. Le mapping détermine comment un ensemble de valeurs doit être converti en un autre. Les deux aident BrynQ à transférer correctement les données de l'application source vers l'application cible.