
Zoom sur une fonctionnalité : comment configurer des transferts
Le thème de cette semaine dans notre série vidéo « Zoom sur une fonctionnalité » – dans laquelle nous présentons en détail une fonctionnalité de la plateforme MyRapidi – porte sur les transferts dans MyRapidi. Andreea Arseni, Data Integration Consultant chez Rapidi, vous explique comment configurer des transferts dans la vidéo ci-dessous.
Bon visionnage !
GUIDE ÉTAPE PAR ÉTAPE : CONFIGURER UN TRANSFERT DANS MYRAPIDI
Ce guide vous accompagne à chaque étape de la configuration d’un transfert dans MyRapidi. Suivez-le pour configurer votre transfert du début à la fin, avec des exemples concrets et des conseils pour chaque section.
1. Créer un nouveau transfert
Accédez à la section Transfers de MyRapidi et cliquez sur « New ». La mise en page de configuration s’ouvre alors, avec plusieurs sections à compléter dans l’ordre : General, Source Control, Table Link, Field List (mapping) et Filter Source.
2. Remplir la section General
- Code : cliquez sur l’icône en forme de crayon et saisissez un code court et explicite (par exemple
CUST_BC_SFDC_ADD). Il vous aidera à identifier le transfert par la suite. - Description : ajoutez plus de détails sur le transfert, afin que vous et vos collègues sachiez à quoi il sert.
- Status : choisissez « Implementing » ou « Testing » pendant que vous travaillez. Passez à « Ready » une fois terminé.
- Group : utilisez les groupes pour organiser les transferts liés, par exemple tous les transferts de clients ou de commandes.
- Source et Destination : sélectionnez le système depuis lequel vous lisez les données (source) et celui vers lequel vous les envoyez (destination). Assurez-vous que les deux connexions sont configurées au préalable.
- Source Layout et Destination Layout : ils affichent la structure de données disponible dans chaque système, pour que vous voyiez ce qui peut être mappé.
- Tables : choisissez les tables ou objets appropriés (par exemple
CustomerCarddans Business Central,Accountdans Salesforce). - Link Storage (facultatif) : ajoutez-le si vous souhaitez suivre les liens entre les enregistrements d’un système à l’autre.
- Enable : cochez la case « Enabled » pour activer le transfert.
- Actions : définissez ce qui doit se passer (par exemple créer de nouveaux clients). Pour éviter les doublons, utilisez « Add » avec « Disable Dest Lookup » afin d’obtenir la fonction d’upsert.
3. Compléter la section Source Control
- Timestamps : ajoutez un champ d’horodatage de votre système source. Salesforce en dispose par défaut ; certains ERP exigent de le publier d’abord.
- Source Mirror : utilisez cette fonction si votre système ne dispose pas d’horodatage. Elle permet de détecter les données nouvelles ou modifiées.
- Transferred Field et Store New ID Field : utilisez-les pour enregistrer le moment où les enregistrements sont transférés ou pour renvoyer vers la source les ID du système de destination.
- Commit Per : indiquez 1 si vous utilisez « Store New ID Field » ou « Transferred Field », et 200 si vous n’utilisez qu’un horodatage.
4. Configurer la section Table Link
Ajoutez les clés primaires de vos tables source et de destination. Vous pouvez ajouter plusieurs clés si nécessaire. C’est ce qui permet de faire correspondre les enregistrements entre les systèmes.
5. Mapper les champs dans la section Field List
- Cliquez sur New pour commencer à mapper les champs de la source vers la destination.
- Si vous ne trouvez pas un champ, lancez une recherche avec le signe pourcentage (
%) et un mot-clé. - S’il manque un champ, il n’est peut-être pas publié dans votre système source : publiez-le, puis revenez au mapping.
- Vous pouvez mapper un champ vers plusieurs destinations, ou ajouter des formules pour transformer les données pendant le transfert.
- Parcourez la structure de la table pour voir tous les champs disponibles et vérifier vos mappings.
- Activez les modifications une fois terminé, et gérez vos mappings avec les boutons de désactivation ou de suppression.
6. Ajouter des filtres dans la section Filter Source
- Ajoutez des filtres pour déterminer quels enregistrements sont inclus dans le transfert (par exemple uniquement les clients actifs).
- Indiquez le nom du champ et la valeur du filtre. Certains systèmes ne prennent pas en charge tous les opérateurs SQL : utilisez ceux que votre système autorise.
- Vous pouvez ajouter plusieurs filtres et désactiver ceux dont vous n’avez plus besoin.
7. Tester votre transfert
Une fois la configuration terminée, testez votre transfert. Vérifiez que les connexions sont actives, que les groupes sont définis et que tous les champs (en particulier les horodatages) sont publiés et visibles. Si quelque chose ne fonctionne pas comme prévu, passez chaque section en revue.
Bonnes pratiques pour configurer des transferts dans MyRapidi
- Utilisez des codes clairs et courts pour nommer vos transferts.
Choisissez un code qui indique d’un coup d’œil ce que fait le transfert (par exempleCUST_BC_SFDC_ADD). Restez bref : les détails ont leur place dans la description.
- Ajoutez des descriptions détaillées.
Utilisez le champ de description pour ajouter des informations sur l’objectif du transfert ou des remarques particulières sur sa configuration.
- Définissez le bon statut tout au long de la configuration.
Utilisez « Implementing » ou « Testing » pendant que vous travaillez. Ne passez à « Ready » que lorsque vous êtes sûr que le transfert est terminé.
- Organisez vos transferts avec des groupes.
Regroupez les transferts liés (comme tous les transferts de clients ou de commandes). Ils sont ainsi plus faciles à retrouver et à gérer.
- Configurez les connexions aux systèmes avant de définir les transferts.
Assurez-vous que les connexions des systèmes source et de destination sont configurées avant de commencer le transfert lui-même.
- Publiez et utilisez toujours un champ d’horodatage si possible.
Les horodatages permettent de repérer ce qui est nouveau ou modifié, ce qui améliore la rapidité et la précision des transferts. Si votre ERP ne dispose pas d’horodatage natif, publiez-en un ou utilisez la fonction Source Mirror.
- Utilisez les fonctions « Store New ID Field » et « Transferred Field » pour le suivi.
Ces champs vous permettent de savoir quand les enregistrements sont créés et de renvoyer les ID de destination vers le système source.
- Réglez « Commit Per » correctement.
Indiquez 1 si vous utilisez « Store New ID Field » ou « Transferred Field ». Indiquez 200 si vous n’utilisez qu’un horodatage.
- Mappez les champs avec soin et vérifiez qu’il n’en manque aucun.
Si un champ n’est pas disponible, il n’est peut-être pas publié dans votre système source. Publiez-le, puis revenez au mapping.
- Utilisez la fonction de recherche pour mapper les champs.
Utilisez le signe pourcentage (%) et un mot-clé pour trouver rapidement les champs.
- Activez les modifications après avoir mis à jour les mappings ou les filtres.
Utilisez toujours le bouton « Activate Changes » pour enregistrer votre travail.
- Ajoutez des filtres de manière réfléchie et désactivez-les quand ils ne sont pas nécessaires.
Les filtres permettent de contrôler quels enregistrements sont transférés. Désactivez les filtres dont vous n’avez pas besoin, sans les supprimer.
- Testez votre transfert avant la mise en production.
Vérifiez que toutes les connexions, tous les mappings et tous les filtres fonctionnent comme prévu avant de marquer le transfert comme prêt.
- Surveillez les doublons lorsque vous utilisez des actions d’upsert.
Lorsque vous utilisez « Add » avec « Disable Dest Lookup », veillez à ne pas créer de doublons dans votre système de destination.
- Utilisez les icônes d’aide et la documentation.
Cliquez sur les icônes en forme de point d’interrogation à côté des champs pour obtenir des explications dans l’application, et consultez le wiki pour en savoir plus sur les formules et les fonctions avancées.
La configuration d’un transfert dans MyRapidi se fait étape par étape. Avancez section par section et vous disposerez d’un transfert opérationnel, adapté aux besoins de votre entreprise.
Si vous avez besoin d’aide, vous pouvez toujours contacter l’équipe Support de Rapidi et trouver plus d’informations dans l’article du wiki
Questions fréquentes (FAQ)
Configurer des transferts dans MyRapidi : réponses aux questions les plus courantes
La configuration de transferts dans MyRapidi peut sembler complexe au début, mais une fois les bases acquises, elle devient simple. Ce guide répond aux questions les plus fréquentes sur la configuration des transferts, de la mise en place initiale aux options avancées.
Quelle est la première étape pour créer un transfert dans MyRapidi ?
Accédez à la section Transfers et cliquez sur « New ». La mise en page de configuration du transfert s’ouvre. Vous y voyez plusieurs sections : General, Source Control, Table Link, Field List (mapping) et Filter Source. Chaque section joue un rôle différent dans le processus de transfert.
Comment nommer mon transfert ?
Dans la section General, cliquez sur l’icône en forme de crayon et ajoutez un « Code » court qui décrit le transfert. Par exemple, CUST_BC_SFDC_ADD convient pour un transfert de clients de Business Central vers Salesforce. Le code doit être court et aller droit au but. Utilisez le champ « Description » pour ajouter des détails si nécessaire.
Que signifie le champ Status ?
Le statut indique où vous en êtes dans le processus. Utilisez « Implementing » ou « Testing » pendant que vous travaillez. Une fois que vous avez terminé et que le transfert est prêt, passez le statut à « Ready ».
Comment les groupes aident-ils à organiser les transferts ?
Les groupes rassemblent les transferts liés. Par exemple, tous les transferts concernant les clients peuvent être placés dans un groupe appelé « Clients ». Il est ainsi plus facile de retrouver et de gérer les transferts similaires. Utilisez des groupes pour les commandes, les produits ou tout autre type de données que vous traitez souvent.
Que sont la source et la destination dans un transfert ?
La source est le système depuis lequel vous lisez les données. La destination est l’endroit où les données sont envoyées. Par exemple, vous pouvez transférer des données de Business Central (source) vers Salesforce (destination). Avant de configurer le transfert, les connexions aux deux systèmes doivent être en place.
À quoi servent Source Layout et Destination Layout ?
Ces mises en page affichent la structure des données de vos systèmes source et de destination. Elles vous montrent quelles données sont disponibles pour le transfert et comment elles sont organisées. C’est utile au moment de mapper les champs.
Comment choisir les bonnes tables ?
Choisissez la table ou l’objet qui contient vos données. Par exemple, utilisez « CustomerCard » dans Business Central et « Account » dans Salesforce. Assurez-vous d’avoir défini les deux tables et configuré les connexions avant d’aller plus loin.
Qu’est-ce que Link Storage et en ai-je besoin ?
Link Storage est facultatif. Il permet de suivre les liens entre des enregistrements de systèmes différents. Si vous souhaitez l’utiliser, configurez-le d’abord, puis ajoutez-le à votre transfert. Une vidéo sur Link Storage est disponible, et n’hésitez pas à contacter le support si vous avez besoin d’aide avec Link Storage.
Comment activer un transfert ?
Sur la droite, cochez la case « Enabled » pour activer le transfert. Choisissez les actions à configurer, par exemple la création de nouveaux clients. Si vous utilisez « Add » et « Disable Dest Lookup », vous déclenchez la fonction « Upsert », qui évite les doublons dans Salesforce.
À quoi sert la section Source Control ?
La section Source Control sert à suivre les modifications. L’idéal est d’utiliser des horodatages dans tous les systèmes. Salesforce dispose d’un horodatage intégré, mais ce n’est pas le cas de nombreux ERP. Vous devrez peut-être publier un champ d’horodatage dans votre ERP. MyRapidi propose aussi une fonction « Source Mirror » si aucun horodatage natif n’est disponible. Utilisez « Transferred Field » pour enregistrer la date de création d’un enregistrement. Utilisez « Store New ID Field » pour renvoyer l’ID Salesforce vers Business Central.
Quelle valeur choisir pour Commit Per ?
Si vous utilisez « Store New ID Field » ou « Transferred Field », réglez « Commit Per » sur 1. Si vous n’utilisez qu’un horodatage, réglez-le sur 200. Ce paramètre détermine la fréquence à laquelle MyRapidi valide les données pendant le transfert.
Comment relier des tables avec des clés primaires ?
Dans la section Table Link, ajoutez les clés primaires de vos enregistrements dans les deux systèmes. Vous pouvez ajouter plusieurs clés si nécessaire. Cette étape fait correspondre les enregistrements entre les systèmes.
Comment mapper les champs entre la source et la destination ?
Dans la section Field List (mapping), cliquez sur « New » pour ajouter un mapping de champ. Mappez chaque champ de la source vers la destination. Si vous ne trouvez pas un champ, lancez une recherche avec le signe pourcentage (%) et un mot-clé. S’il manque un champ, il n’est peut-être pas publié dans votre système source. Publiez-le, puis revenez au mapping.
Puis-je utiliser des formules dans le mapping des champs ?
Oui, vous pouvez ajouter des formules sur la gauche de la liste de mapping. Le résultat est envoyé dans le champ de destination. Consultez le wiki pour en savoir plus sur la syntaxe et trouver des exemples.
Et si je dois filtrer des données ?
Utilisez la section Filter Source pour ajouter des filtres. Par exemple, vous pouvez filtrer pour n’inclure que les clients actifs. Indiquez le nom du champ et la valeur du filtre. Certains systèmes ne prennent pas en charge tous les opérateurs SQL : utilisez ceux que votre système autorise.
Comment tester mon transfert ?
Une fois la configuration terminée, testez le transfert. Vérifiez que les connexions sont configurées, que les groupes sont utilisés et que tous les champs nécessaires (comme les horodatages) sont publiés et visibles. En cas de problème, vérifiez chaque section ou demandez de l’aide.
Un résumé ou un dernier conseil pour configurer des transferts ?
La configuration de transferts dans MyRapidi se fait étape par étape. Maîtrisez les bases, et vous aurez une intégration opérationnelle en un rien de temps.