Que sont les Open Office Hours ? Saison 1 : Session 2 - Conception de transferts Rapidi 101
Le 15 janvier 2026, nous avons lancé notre série Open Office Hours. Ces sessions de formation en direct se déroulent de janvier à avril et couvrent tout, de la configuration de base au paramétrage avancé. Tous les clients Rapidi peuvent y participer en direct ou regarder les enregistrements.
Dans cet article, nous vous expliquons comment configurer des transferts dans MyRapidi - vous y trouverez aussi l’enregistrement de la session 2 des Open Office Hours - Conception de transferts 101
Configurer un transfert dans Rapidi, c’est relier votre système source (comme Business Central) à votre système de destination (comme Salesforce). Ce guide vous accompagne à chaque étape de la configuration, de la création du transfert jusqu’à votre premier test.
Regardez le replay de notre deuxième session : Conception de transferts Rapidi 101
Diapositives de la présentation
Comment configurer des transferts dans Rapidi : le guide étape par étape
Configurer un transfert dans Rapidi, c’est relier votre système source (comme Business Central) à votre système de destination (comme Salesforce). Ce guide vous accompagne à chaque étape de la configuration, de la création du transfert jusqu’à votre premier test.
Étape 1 : créer un nouveau transfert
Connectez-vous à Rapidi, allez dans Transfers, puis cliquez sur New. Vous voyez alors la section General, dans laquelle vous saisissez les informations de base de votre transfert.
Code et description
Le code suit votre propre convention de nommage. Choisissez quelque chose qui a du sens pour vous. Par exemple, si vous synchronisez des clients de Business Central vers Salesforce, vous pourriez utiliser : 01-CustomerSync-AddUpdate-BC-SF
La description précise ce que fait le transfert. Une formulation comme « Synchronisation des clients entre BC et Salesforce » convient très bien.
Statut
Lorsque vous créez un transfert, réglez son statut sur Implementing/Testing. Tout le monde sait ainsi que le transfert est encore en cours de construction. Une fois que vous l’avez testé et que tout fonctionne, passez le statut à Ready. Ready signifie que le transfert est prêt pour la production.
Groupes
Les groupes sont des catégories qui vous aident à organiser vos transferts. Vous pourriez par exemple avoir des groupes pour les clients, les factures, les commandes, etc. Sélectionnez le groupe qui correspond à votre transfert. Il sera ainsi plus facile de retrouver plus tard les transferts liés.
Source et destination
Sélectionnez votre connexion source (le système dans lequel vous lisez) et votre connexion de destination (le système dans lequel vous écrivez). Choisissez ensuite les tables concernées. Pour la source, commencez à saisir le nom de la table ou utilisez le signe pourcentage (%) pour afficher toutes les options disponibles. Faites de même pour la table de destination.
Link Storage (facultatif)
Le Link Storage enregistre les identifiants des enregistrements des deux systèmes. Par exemple, si vous transférez un client de Business Central vers Salesforce, le Link Storage garde la trace du numéro client BC qui correspond à chaque Account ID Salesforce. Ce n’est pas obligatoire, mais c’est utile lorsque vous devez suivre les relations entre les enregistrements d’un système à l’autre.
Actions
Commencez par activer le transfert (il est désactivé par défaut). Choisissez ensuite les actions souhaitées :
- Add and Update : crée de nouveaux enregistrements et met à jour ceux qui existent. Nécessite une clé unique présente dans les deux systèmes.
- Update only : met uniquement à jour les enregistrements existants. Nécessite également une clé unique.
- Add, Update, and Disable Destination Lookup (Salesforce) : déclenche la fonction upsert de Salesforce. Salesforce décide lui-même s’il faut créer ou mettre à jour chaque enregistrement. Cette option améliore les performances, car les enregistrements sont créés plus rapidement.
Étape 2 : configurer le Source Control
Le Source Control détermine comment Rapidi repère les enregistrements qui ont changé et doivent être transférés.
Champ d’horodatage ou datetime
Pour les transferts en production, utilisez un champ d’horodatage ou datetime. Ce champ enregistre la date de la dernière modification d’un enregistrement. Lorsque quelqu’un modifie l’adresse e-mail d’un client, par exemple, le champ d’horodatage capture ce changement. Rapidi sait alors qu’il doit transférer cet enregistrement. C’est la meilleure approche en termes de performances, car seuls les enregistrements modifiés sont transférés.
Champ Transferred/Confirmation (facultatif)
Vous pouvez configurer Rapidi pour qu’il renvoie une confirmation après le transfert d’un enregistrement. Il peut s’agir d’une valeur datetime indiquant quand le transfert s’est terminé, ou d’une valeur vrai/faux. C’est utile lorsque vous devez savoir quels enregistrements ont été synchronisés avec succès.
Champ Store New ID (write-back)
Lorsque vous créez un client dans Salesforce, il reçoit un nouvel ID Salesforce. La fonction Store New ID réécrit cet ID dans votre système source. Les enregistrements des deux systèmes sont ainsi liés.
Paramètre Commit Per
Ce paramètre définit le nombre d’enregistrements que Rapidi traite avant de valider (commit). La valeur standard est 200. Mais si vous utilisez des fonctions de write-back (champs Store New ID ou Confirmation), réglez-le sur 1. Avec le write-back, Rapidi doit traiter un enregistrement à la fois : créer l’enregistrement, récupérer le nouvel ID et le réécrire avant de passer à l’enregistrement suivant.
Étape 3 : définir les Table Links
Les Table Links définissent la correspondance entre les enregistrements du système source et ceux du système de destination. Cela évite les doublons et garantit que les mises à jour s’appliquent aux bons enregistrements.
Clés primaires
Ajoutez la clé primaire de votre table source et associez-la à un champ de la destination. Pour les clients, il peut s’agir du numéro client. La clé doit être unique dans les deux systèmes.
External IDs dans Salesforce
Voici un problème courant : votre ERP utilise un type de clé primaire (comme un numéro client), mais Salesforce en utilise un autre (comme un ID Salesforce). Ces clés ne correspondent pas. La solution consiste à créer un champ External ID dans Salesforce. Marquez-le comme External ID pour que Salesforce sache qu’il doit l’utiliser pour la mise en correspondance. Cela évite les doublons lorsque vous ne pouvez pas utiliser l’ID natif de Salesforce.
Alternative : le Link Storage
Au lieu des External IDs, vous pouvez utiliser le Link Storage. Le Link Storage tient à jour une liste des enregistrements mis en correspondance entre les deux systèmes. Lorsque le transfert s’exécute, il consulte le Link Storage pour vérifier si le client existe déjà. Si oui, il le met à jour. Sinon, il le crée.
Étape 4 : créer les mappages de champs
Les mappages relient les champs de votre table source aux champs de votre table de destination.
Ajouter des mappages
Pour chaque champ à transférer, sélectionnez le champ source et le champ de destination. Commencez à saisir le nom du champ ou utilisez le signe pourcentage (%) pour afficher tous les champs disponibles. Vous pouvez ajouter autant de mappages que nécessaire.
Gérer les mappages
Vous pouvez désactiver un mappage sans le supprimer. Un mappage désactivé ne transfère aucune donnée lors de l’exécution du transfert. C’est utile pour les tests ou lorsque vous n’avez temporairement pas besoin de certains champs. Vous pouvez aussi supprimer complètement les mappages dont vous n’avez plus besoin.
Browse Table Layout
La fonction Browse Table Layout affiche tous les champs disponibles d’une table. Elle vous permet de voir les noms des champs, leurs types (texte, nombre, etc.), leurs tailles et s’ils peuvent rester vides. Si vous ne trouvez pas un champ que vous attendiez, il n’est peut-être pas publié. Publiez le champ dans le système source, puis actualisez la structure de la table dans Rapidi.
Étape 5 : ajouter des filtres (facultatif)
Les filtres vous permettent d’inclure des enregistrements précis dans le transfert ou de les en exclure.
Quand utiliser des filtres
- Tester avec un seul enregistrement ou un petit ensemble d’enregistrements
- Exclure certains types ou catégories de clients
- Exécuter des transferts ciblés sur des sous-ensembles de données précis
Syntaxe des filtres
Saisissez le nom du champ et votre condition de filtre. Les systèmes ERP suivent généralement une syntaxe de type SQL. Salesforce possède sa propre syntaxe (SOQL). Si vous obtenez une erreur, c’est que le système ne prend pas en charge ce format de filtre. Essayez une autre variante.
Étape 6 : activer et exécuter
Après chaque modification de votre transfert, cliquez sur Activate Changes. Cette action valide et enregistre votre travail. Sans cette étape, vos modifications ne prennent pas effet.
Pour tester votre transfert, cliquez sur Run Transfer. Surveillez les éventuelles erreurs renvoyées par le système de destination. En cas d’échec, ajustez votre configuration et relancez le transfert.
Récapitulatif : liste de contrôle pour configurer un transfert
- Créer un nouveau transfert avec un code et une description
- Régler le statut sur Implementing/Testing
- Sélectionner la catégorie de groupe
- Choisir les connexions source et de destination
- Sélectionner les tables source et de destination
- Activer le transfert et définir les actions
- Configurer le Source Control avec un champ d’horodatage
- Définir le Commit Per (200 en standard, 1 pour le write-back)
- Définir les Table Links avec les clés primaires
- Créer des External IDs dans la destination si nécessaire
- Ajouter les mappages de champs
- Ajouter des filtres si nécessaire
- Cliquer sur Activate Changes
- Exécuter le transfert et le tester
Ressources associées
- General Section - Les bases de la configuration d’un transfert : code, description, statut, groupes et connexions
- Source Control - Champs d’horodatage, write-back et paramètres de commit
- Table Link - Clés primaires et External IDs
- Field List Mapping - Relier les champs source et de destination
- Filters Source Delimitation - Inclure et exclure des enregistrements
Mis à jour en février 2026
Questions fréquentes
Quelle est la différence entre Add/Update et l’option upsert de Salesforce ?
Avec l’option standard Add/Update, Rapidi vérifie si l’enregistrement existe avant de décider de le créer ou de le mettre à jour. Avec l’option upsert de Salesforce (Add, Update, and Disable Destination Lookup), Rapidi envoie tout à Salesforce et le laisse décider. L’option upsert est plus rapide, car elle saute l’étape de recherche.
Ai-je besoin du Source Control pour les tests ?
Non. Le Source Control est facultatif pendant les tests. Mais pour les transferts en production, vous devriez configurer un champ d’horodatage ou datetime. Ainsi, seuls les enregistrements modifiés sont transférés, ce qui améliore les performances.
Quand régler le Commit Per sur 1 plutôt que sur 200 ?
Utilisez 200 (la valeur standard) pour la plupart des transferts. Passez à 1 lorsque vous utilisez des fonctions de write-back comme les champs Store New ID ou Confirmation. Le write-back impose de traiter un enregistrement à la fois pour récupérer et renvoyer les nouvelles valeurs.
Qu’est-ce qu’un External ID et pourquoi en ai-je besoin ?
Un External ID est un champ de votre système de destination (comme Salesforce) qui stocke un identifiant unique provenant de votre système source. Vous en avez besoin lorsque les clés primaires de la source et de la destination ne correspondent pas. Par exemple, votre ERP utilise des numéros clients, alors que Salesforce utilise ses propres ID. L’External ID conserve votre numéro client ERP dans Salesforce, ce qui permet à Rapidi de faire correspondre correctement les enregistrements et d’éviter les doublons.
Quelle est la différence entre Table Link et Link Storage ?
Table Link utilise des External IDs dans votre système de destination pour faire correspondre les enregistrements. Link Storage est une liste distincte, tenue par Rapidi, qui indique quels enregistrements source correspondent à quels enregistrements de destination. Les deux évitent les doublons. Utilisez Table Link avec des External IDs lorsque vous voulez que la logique de correspondance se trouve dans votre système de destination. Utilisez Link Storage lorsque vous avez besoin que Rapidi gère les relations.
Un champ dont j’ai besoin n’apparaît pas dans les options de mappage. Que faire ?
Le champ n’est peut-être pas publié dans votre système source ou de destination. Publiez le champ dans ce système, puis revenez dans Rapidi et actualisez ou relisez la structure de la table depuis la connexion. Le champ devrait alors apparaître dans vos options.
Mon filtre renvoie une erreur. Quel est le problème ?
Chaque système utilise sa propre syntaxe de filtre. Les systèmes ERP utilisent généralement des opérateurs de type SQL. Salesforce utilise la syntaxe SOQL. Si votre filtre ne fonctionne pas, vérifiez la syntaxe propre à votre système et essayez un autre format.
Dois-je cliquer sur Activate Changes après chaque modification ?
Oui. Activate Changes valide et enregistre vos modifications. Si vous sautez cette étape, vos modifications ne seront pas appliquées lors de l’exécution du transfert.
Quand passer le statut de Testing à Ready ?
Passez le statut à Ready lorsque votre transfert est entièrement testé et prêt pour la production. Laissez-le sur Implementing/Testing tant que vous êtes encore en train de le configurer, de résoudre des problèmes ou de le tester.
Puis-je désactiver un mappage sans le supprimer ?
Oui. Un mappage désactivé reste dans votre configuration, mais ne transfère plus de données. C’est utile lorsque vous voulez exclure temporairement un champ sans perdre la configuration de votre mappage.
Que se passe-t-il si mon système de destination renvoie une erreur pendant un transfert ?
Lisez le message d’erreur pour comprendre ce qui s’est passé. Les problèmes courants sont des champs obligatoires manquants, des types de données incompatibles ou des doublons. Ajustez votre configuration, vos mappages ou vos données, puis relancez le transfert.
Où trouver plus d’aide ?
Chaque section de Rapidi comporte une icône en forme de point d’interrogation qui renvoie vers la documentation du wiki. Vous pouvez aussi contacter le support Rapidi si vous avez besoin d’aide pour une configuration précise.