Open Office Hours saison 1 : session 5 - Mappages de champs

February 12, 2026 · Andreea Arseni · Open Office Hours

Les mappages de champs sont au cœur de toute intégration de données. Ils déterminent comment les données passent d’un système à un autre et ce qu’elles deviennent en chemin. Rapidi vous propose un ensemble de formules intégrées qui vous permettent de convertir, filtrer, rechercher et transformer vos données sans écrire de code personnalisé.

Ce guide présente les bonnes pratiques pour les deux plateformes et vous montre, étape par étape, comment configurer vos mappages de champs dans MyRapidi.

Dans la 5e session de notre série Open Office Hours, nous expliquons comment configurer les mappages de champs avec Rapidi.

Comment configurer les mappages de champs

Regardez le replay de notre cinquième session : Mappages de champs

Mappages de champs dans RAPIDI : formules, lookups et bonnes pratiques

Les mappages de champs peuvent être de simples relations 1 à 1 entre un champ source et un champ de destination. Dans de nombreuses intégrations, cette approche ne suffit pas, car les données doivent parfois être récupérées à différents endroits, reformatées, validées, raccourcies ou mappées de façon conditionnelle. Les formules RAPID (aussi appelées expressions) couvrent ces cas.

Où ajouter des formules dans RAPID

Les formules s’ajoutent dans les Field List Mappings.

Règles de syntaxe obligatoires

• Chaque formule commence par deux dièses : ##
• Les chaînes de texte s’écrivent entre guillemets simples : 'text'
• Les noms de champs s’écrivent entre guillemets doubles : "FieldName"

Cette structure s’applique aux formules comme aux valeurs codées en dur.

Catégories de formules pour les mappages de champs

Les formules RAPID sont regroupées en catégories qui correspondent aux besoins de mappage les plus courants.

1) Conversions (alignement des formats)

Les conversions traitent les cas où deux systèmes stockent les mêmes données dans des formats différents. L’objectif est d’aligner les formats pour que la destination reçoive la structure attendue.

Un exemple courant consiste à convertir une date de la source au format date et heure exigé par la destination.

2) Logique conditionnelle et valeurs par défaut

La logique conditionnelle s’utilise lorsque :

• les données source sont manquantes ou vides
• un champ doit être mappé différemment selon sa valeur
• une valeur par défaut doit être envoyée faute de correspondance

Formule CASE (mappage de valeurs avec valeur par défaut)

Un scénario fréquent consiste à mapper des valeurs qui ne correspondent pas d’un système à l’autre.

Exemple de schéma :

• Champ source : code de service avec des valeurs comme east, west, north
• La destination attend des valeurs numériques :
  • east → 1
  • west → 2
  • north → 3
• Une valeur par défaut est nécessaire lorsqu’aucune des valeurs attendues n’est trouvée

La valeur par défaut se place à la fin pour garantir le bon déroulement du transfert.

Gestion des valeurs vides (actions de repli)

Une formule Blank Value est souvent associée à des lookups :

• Si le résultat d’un lookup est vide, une seconde action est exécutée
• Actions de repli courantes :
  • envoyer une valeur par défaut
  • ignorer le champ à l’aide d’une formule Skip Field

Exemple de comportement :

• Si un champ de code de langue est vide, le mappage ignore le champ
• Sinon, la valeur existante est envoyée

3) Lookups (interroger d’autres tables, vues ou le Link Storage)

Les lookups récupèrent des données d’autres tables, listes ou vues et les envoient à la destination.

Types de lookups

• Lookups DB : exécutent une requête sur la source ou la destination
• Lookup LS : interroge le Link Storage

Condition essentielle : un identifiant commun

Un lookup exige un point commun entre :

• la table mappée
• la table interrogée

Exemple de structure (lookup sur la destination) :

• Interroger la table ou l’objet de destination
• Faire correspondre un champ comme External ID à un champ de la table de transfert comme Owner ID
• En cas de correspondance, renvoyer une valeur comme Code et l’envoyer vers le champ de destination

Destination, source ou Link Storage

• DDS sert aux lookups sur la destination
• SourceDS sert aux lookups sur la source
• LS lookup sert aux valeurs du Link Storage, qui doivent être tenues à jour pour rester fiables

Exemples de lookups utilisés dans les mappages

• Attribution du propriétaire : rechercher un utilisateur de la destination par son alias, vérifier qu’il est actif, puis renvoyer son ID utilisateur ; si le résultat est vide, envoyer un ID utilisateur par défaut ou ignorer le champ
• Champs de référence : rechercher un objet de la destination (par exemple un emplacement) pour récupérer l’ID du système de destination exigé par un champ de référence
• Enrichissement ERP : récupérer des valeurs associées (par exemple les factures impayées) dans une autre page ou table de l’ERP à l’aide d’un identifiant commun (par exemple le numéro client), puis envoyer la valeur vers un champ de destination ; les mises à jour de la table source se répercutent sur le champ de destination mappé lors de l’exécution suivante

4) Manipulation de texte (contrôle de la longueur, découpage, concaténation)

Les formules de manipulation de texte adaptent les chaînes aux contraintes de la destination.

Formule COPY (tronquer à une longueur maximale)

Elle sert couramment à éviter les erreurs dans la destination dues à des chaînes trop longues.

Exemple :

• Le champ source name accepte jusqu’à 50 caractères
• Le champ de destination n’accepte que 6 caractères
• COPY ne prend que les 6 premiers caractères, pour que la destination ne rejette pas l’enregistrement

Coder des valeurs en dur dans les mappages

Les valeurs codées en dur suivent les mêmes règles de syntaxe :

• Commencer par ##
• Mettre la valeur entre guillemets simples

Les valeurs codées en dur permettent de toujours envoyer des valeurs cohérentes ou de fournir des valeurs par défaut.

Formules opérationnelles pour le dépannage et le contrôle

Formule Message (journaliser le contexte de chaque enregistrement)

La formule Message consigne dans les logs les valeurs de champs choisies pendant les exécutions de transfert.

Exemple de comportement :

• Un champ de numéro client est inclus dans la formule Message
• Chaque enregistrement transféré inscrit son numéro client dans les logs
• En cas d’erreur, les logs indiquent alors quel enregistrement a échoué, ce qui facilite le dépannage lorsque les systèmes fournissent peu de détails sur les erreurs

Formule Error (arrêt immédiat)

La formule Error empêche un transfert de s’exécuter. Elle s’utilise lorsqu’une validation stricte est nécessaire et que des données manquantes ou non valides doivent bloquer le traitement.

Formules de validation

Les formules de validation peuvent vérifier le format des champs avant l’envoi des données :

• La formule de validation d’e-mail vérifie si une adresse e-mail est valide
• La formule de validation de téléphone vérifie si un numéro de téléphone respecte le format attendu

Bonnes pratiques pour utiliser des formules dans les mappages de champs

• Commencez par des formules simples et un minimum de conditions
• Testez le comportement, puis ajoutez des conditions et des imbrications si nécessaire
• Utilisez des valeurs par défaut lorsque les mappages reposent sur la correspondance de valeurs
• Associez la gestion des valeurs vides aux lookups pour maîtriser ce qui se passe quand les résultats sont vides
• Assurez-vous que les lookups disposent d’un identifiant commun fiable entre la table mappée et la table interrogée
• Utilisez la journalisation par formule Message pour consigner les identifiants des enregistrements dans les logs et accélérer le dépannage
• N’utilisez la formule Error que lorsqu’un transfert doit s’arrêter en cas d’échec de validation
• Respectez la syntaxe de façon systématique : préfixe ##, guillemets simples pour les chaînes, guillemets doubles pour les noms de champs
• Imbriquez les formules lorsque plusieurs étapes sont nécessaires (lookup + gestion des valeurs vides + valeur par défaut/champ ignoré)

Récapitulatif

Les mappages de champs RAPID vont au-delà des transferts de champ à champ en 1 à 1. Les formules permettent les conversions de format, le mappage conditionnel avec valeurs par défaut, les lookups sur la source, la destination et le Link Storage, le contrôle de la longueur du texte, la validation, la journalisation et l’arrêt immédiat en cas d’erreur. Une syntaxe correcte et une construction progressive de la logique réduisent les erreurs de mappage et améliorent la fiabilité des transferts.

Et ensuite ?

Questions fréquentes

Qu’est-ce que le mappage de champs dans l’intégration de données ?

Le mappage de champs consiste à relier un champ d’un système au champ correspondant d’un autre système. Il indique à l’intégration quelles données vont où. Un exemple simple : le champ « Customer Name » de votre ERP doit être mappé vers le champ « Account Name » de Salesforce. Sans mappage correct, les données atterrissent au mauvais endroit ou ne sont pas transférées du tout.

Quelle est la différence entre un mappage 1 à 1 et un mappage basé sur une formule ?

Un mappage 1 à 1 envoie une valeur directement d’un champ source vers un champ de destination, sans aucune modification. Un mappage basé sur une formule transforme les données en chemin. Vous utiliserez une formule lorsque les deux systèmes stockent les données dans des formats différents, utilisent des valeurs différentes pour la même chose, ou lorsque vous devez récupérer des données d’une table liée qui ne fait pas partie du transfert principal.

Que se passe-t-il lorsqu’un champ de mon système source est vide ?

Si vous ne tenez pas compte des champs vides, votre transfert risque d’échouer ou d’envoyer des valeurs vides vers la destination, ce qui peut écraser des données existantes. Dans Rapidi, vous pouvez utiliser une formule Blank Value combinée à Skip Field pour indiquer au système : « Si ce champ est vide, conserver le champ de destination tel quel. » C’est particulièrement utile pour les champs que les utilisateurs finaux ne renseignent pas toujours.

Pourquoi ai-je des erreurs liées à la longueur des champs ou à des types de données incompatibles ?

Les systèmes définissent souvent le même type de données de manière différente. Un champ de nom peut accepter 50 caractères dans votre ERP, mais seulement 30 dans Salesforce. Un champ de date peut utiliser un format (DD/MM/YYYY) dans un système et un autre (YYYY-MM-DD) dans l’autre. Ces écarts provoquent des erreurs de validation côté destinataire. Les formules COPY et FORMAT de Rapidi vous permettent de raccourcir les champs et de convertir les formats avant que les données n’atteignent la destination.

Quand utiliser un lookup plutôt qu’un mappage direct ?

Utilisez un lookup lorsque les données dont vous avez besoin ne se trouvent pas dans la table que vous transférez. Par exemple, si vous synchronisez des fiches clients mais devez inclure le montant des factures impayées, cette valeur peut se trouver dans une table de statistiques distincte. Un lookup vous permet d’interroger une autre table, d’établir la correspondance sur un identifiant commun (comme un numéro client) et d’intégrer la valeur à votre transfert. Dans Rapidi, vous pouvez exécuter des lookups sur le système source, le système de destination ou le Link Storage.