Module complémentaire Business Central pour la configuration de RapidStart CRM

Étapes de haut niveau

1. Créer ou utiliser un environnement existant activé pour Dataverse.
2. Installer RapidStart CRM depuis AppSource sur l'environnement activé pour Dataverse.
3. Obtenir l'ID du système de l'entreprise Business Central.
4. Configurer l'intégration depuis Business Central.
5. Vérifier le rôle de l'utilisateur de l'application d'intégration Business Central
6. Configurer le mappage des enregistrements
7. Lier les environnements (Optionnel)
8. Installer l'addon Business Central pour RapidStart CRM depuis AppSource sur l'environnement activé pour Dataverse.
9. Compléter dans l'application RapidStart Settings

Avant de commencer

Confirmez ces exigences avant de commencer la configuration de l'addon Business Central :

• Business Central et Dataverse doivent être dans le même locataire Microsoft Entra pour les tables virtuelles Business Central.
• Utilisez un administrateur de configuration humain avec les autorisations Business Central requises et l'accès Administrateur Système Dataverse pendant la configuration.
• Confirmez que RapidStart CRM est installé dans l'environnement Dataverse que vous prévoyez de connecter.

Étape 3 : Obtenir l'ID de l'entreprise

Pour obtenir votre ID d'entreprise, recherchez Entreprises dans Business Central. Sélectionnez l'entreprise cible et appuyez sur Ctrl+Alt+F1 pour ouvrir Inspection de la page. Copiez l'ID affiché et enregistrez-le pour plus tard.

Étape 4 : Configurer l'intégration depuis Business Central

Connectez-vous à l'environnement Business Central que vous souhaitez connecter.

Notez le nom de l'environnement Business Central dans la barre d'adresse. L'URL peut également afficher le nom d'affichage de l'entreprise, mais vous avez déjà capturé le GUID de l'ID du système de l'entreprise à l'étape précédente.

Copiez le nom de l'environnement Business Central dans les mêmes notes où vous avez enregistré le GUID de l'ID du système de l'entreprise.

1. Cliquez sur l'engrenage
2. Sélectionnez “Configuration assistée”

Faites défiler jusqu'à la section “Connecter avec d'autres systèmes” et cliquez sur “Configurer une connexion à Dataverse”.

1. Sélectionnez pour activer la synchronisation des données
2. Sélectionnez pour activer les tables virtuelles et les événements
3. Cliquez sur “Suivant”

Acceptez les termes et cliquez sur “Suivant”

Acceptez la connexion à Dataverse “Toujours autoriser”, et cliquez sur OK

Sélectionnez l'environnement activé pour Dataverse cible, et cliquez sur “Ok”

Confirmez que l'environnement est correct, puis cliquez sur le lien pour vous connecter à l'environnement Dataverse. Après vous être connecté, cliquez sur “Suivant”

Sélectionnez la propriété d'équipe recommandée, basculez pour terminer sans synchronisation (nous le ferons plus tard) et cliquez sur “Suivant”

1. Cliquez sur le lien pour installer l'application de table virtuelle Business Central
2. Cliquez sur “Suivant” (Un nouvel onglet s'ouvrira vers AppSource)

Cliquez sur le bouton “Obtenez-le maintenant” (Cet addon est gratuit), et la page suivante s'ouvrira :

1. Sélectionnez l'environnement cible (où vous avez installé RapidStart CRM).
2. Acceptez les termes.
3. Cliquez sur “Installer”.

Vous verrez que la solution est “En cours d'installation”. Cela peut prendre plusieurs minutes pour se terminer. Cliquez occasionnellement sur “rafraîchir” jusqu'à ce que vous voyiez qu'elle est “Installée”, puis revenez à l'onglet du navigateur Business Central pour continuer.

Cliquez sur “Rafraîchir”

Vous verrez que l'application de tables virtuelles a été installée avec succès. Cliquez sur “Terminer”

Après quelques minutes, cette page apparaîtra. Sélectionnez l'onglet Tables virtuelles puis “Tables virtuelles disponibles”

1. Commencez par sélectionner la ligne “article”
2. Cliquez sur “Activer” (Cela créera la table virtuelle dans Dataverse pour les articles)
3. Attendez jusqu'à ce que vous voyiez la case “Visible” cochée. Vous devrez peut-être rafraîchir plusieurs fois.

Répétez ces étapes pour : salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment, et salesShipmentLine. Cela prendra plusieurs minutes pour chacun à activer.

Changez pour trier par Visible/décroissant, et confirmez que vous voyez toutes ces tables. N'ajoutez pas plus de tables virtuelles pour le moment. Vous pouvez laisser l'écran tel quel (nous y reviendrons) et ouvrir un nouvel onglet.

Étape 5 : Vérifier l'utilisateur de l'application d'intégration Business Central

Si les autorisations de synchronisation Business Central-Dataverse semblent endommagées, ouvrez Configuration de la connexion Dataverse dans Business Central et utilisez Redéployer la solution d'intégration. Cela restaure la solution d'intégration de Microsoft et déploie le rôle de sécurité d'intégration Business Central.

Continuez uniquement après que le test de connexion réussit et que l'utilisateur de l'application d'intégration Business Central a le rôle d'intégration Business Central Dataverse de Microsoft.

Étape 6 : Configurer le mappage et le couplage des enregistrements

Mappages de référence à configurer avant CLIENT

• DEVISE : Devise Business Central → Devise de transaction Dataverse. La direction doit être Business Central vers Dataverse. Confirmez ces mappages de champs activés : Code → Code de devise, Symbole → Symbole de devise, et Description → Nom de la devise.
• Confirmez que le mappage CLIENT contient Code de devise → Devise. Synchronisez les devises avant les clients. La devise de base Dataverse et la devise locale Business Central doivent être en accord, et les taux de change requis doivent exister.
• Conditions de paiement : synchronisez avec les conditions de paiement du compte avant le test client.
• Méthode d'expédition : synchronisez avec les termes de fret du compte avant le test client.
• Agent d'expédition : synchronisez avec la méthode d'expédition du compte avant le test client.

Politique de création de clients

Définissez CLIENT sur Bidirectionnel si des comptes/entreprises peuvent être créés de chaque côté. Ensuite, choisissez la politique Synchroniser uniquement les enregistrements couplés comme décision de déploiement client :

Création et couplage automatique de clients

1. Si le client choisit la création automatique native, définissez CUSTOMER sur Bidirectional et Sync. Only Coupled Records sur Off. Gardez Sync New Account to BC désactivé.
2. Laissez Disable Event-driven Synch. Job Rescheduling décochée.
3. Confirmez que le filtre de la table d'intégration CUSTOMER contient le Company System ID sélectionné. Incluez 00000000-0000-0000-0000-000000000000 uniquement lorsque les lignes Dataverse héritées ou non assignées sont délibérément prises en charge.
4. Confirmez que le travail de synchronisation d'intégration CUSTOMER existe et que son intervalle répond aux besoins du client. On Hold with Inactivity Timeout est un statut attendu entre les exécutions ; un intervalle de 30 minutes n'est pas en temps réel.
5. Avant la synchronisation large, couplez manuellement les enregistrements qui existent déjà des deux côtés, ou passez en revue avec soin les critères et résultats de couplage basés sur la correspondance. La création automatique n'identifie pas en toute sécurité chaque paire existante.

Le couplage utilise le GUID d'intégration, pas le numéro de client Business Central. Le numéro est utile pour l'affichage et la recherche ; pour le montrer dans Dataverse, vérifiez le mappage des champs CUSTOMER de Business Central No. à Dataverse No de compte..

Validation des valeurs d'option

Les ID de valeur d'énumération Business Central utilisés pour les Conditions de paiement, la Méthode d'expédition et l'Agent d'expédition doivent correspondre aux ID d'option Dataverse correspondants. Le texte d'affichage ou l'étiquette de code seul ne suffit pas. Une synchronisation complète ne répare pas un décalage d'ID lorsque Business Central contient des valeurs d'énumération personnalisées qui n'existent pas dans Dataverse.

1. Exécutez Synchroniser les enregistrements modifiés pour les CONDITIONS DE PAIEMENT, la MÉTHODE D'EXPÉDITION et l'AGENT D'EXPÉDITION.
2. Inspectez Mapping des options Dataverse et le journal des erreurs de synchronisation avant de tester le CLIENT.
3. Si les ID ne sont pas alignés, utilisez la valeur par défaut sécurisée sur les mappages de champs CLIENT : Code des conditions de paiement → Conditions de paiement = FromIntegrationTable; Code de la méthode d'expédition → Adresse 1 : Termes de fret = FromIntegrationTable; Code de l'agent d'expédition → Adresse 1 : Méthode d'expédition = FromIntegrationTable.
4. Changez ces trois champs en Bidirectionnel uniquement après qu'un développeur a ajouté des ID d'option correspondants des deux côtés.
5. N'inventez pas ou ne renumérotez pas les ID d'option pendant la configuration. Les valeurs personnalisées Dataverse et les extensions d'énumération Business Central doivent utiliser exactement les mêmes ID.

Pour ces mappages de champs CUSTOMER, FromIntegrationTable signifie uniquement Dataverse → Business Central. Cela permet de garder la création de compte/client bidirectionnelle tout en empêchant les identifiants d'option Business Central non appariés de bloquer la création Business Central → Dataverse.

Revenez à l'onglet Business Central dans votre navigateur que nous avons laissé ouvert.

1. Cliquez sur l'onglet “Intégration”
2. puis “Mappages de tables d'intégration”

Décision du client : conserver COMMERCIAUX si le client souhaite la synchronisation standard utilisateur-Dataverse-à-commercial Business Central de Microsoft. Supprimez ou désactivez ce mappage uniquement lorsque cette synchronisation standard n'est pas utilisée intentionnellement.

1. Sélectionnez CONTACT
2. Sélectionnez Couplage
3. Puis cliquez sur “Couplage basé sur la correspondance”.
4. Faites correspondre ci-dessus et cliquez sur OK

1. Sélectionnez DEVISE
2. Sélectionnez Couplage
3. Puis cliquez sur “Couplage basé sur la correspondance”.
4. Faites correspondre ci-dessus et cliquez sur OK

Pour CUSTOMER, sélectionnez Mapping/Fields, puis Edit List. Activez le mappage de Business Central No. à Dataverse No de compte. si le numéro de client doit apparaître sur le compte Dataverse. Cela ne remplace pas le couplage d'intégration-GUID.

Toujours pour CLIENT, sélectionnez Couplage/Couplage basé sur la correspondance. Faites correspondre en utilisant les champs d'identifiant client/compte montrés dans la capture d'écran, et confirmez que les champs de correspondance identifient de manière unique le même client des deux côtés.

Pour CONDITIONS DE PAIEMENT, sélectionnez Couplage/Couplage basé sur la correspondance. Faites correspondre les enregistrements de conditions de paiement Business Central aux valeurs d'option de conditions de paiement Dataverse correspondantes par les ID configurés.

Pour MÉTHODE D'EXPÉDITION, sélectionnez Couplage/Couplage basé sur la correspondance. Faites correspondre les méthodes d'expédition Business Central aux valeurs d'option de termes de fret Dataverse correspondantes par les ID configurés.

Pour AGENT D'EXPÉDITION, sélectionnez Couplage/Couplage basé sur la correspondance. Faites correspondre les agents d'expédition Business Central aux valeurs d'option de méthode d'expédition Dataverse correspondantes par les ID configurés.

Pour FOURNISSEUR, sélectionnez Mappage/Champs
1. Sélectionnez “Modifier la liste”
2. et “activer” le numéro de compte.

Toujours pour FOURNISSEUR, sélectionnez Couplage/Couplage basé sur la correspondance. Faites correspondre en utilisant les champs d'identifiant fournisseur/compte montrés dans la capture d'écran, et confirmez que les champs de correspondance identifient de manière unique le même fournisseur des deux côtés.

Étape 7 : Lier les environnements (Optionnel)

Pour empêcher quelqu'un de supprimer accidentellement des environnements, vous pouvez les lier. Commencez par revenir dans Business Central.

1. Sélectionnez l'icône d'engrenage
2. Puis sélectionnez Centre d'administration

Sélectionnez le lien de l'environnement cible

Cliquez sur “Lier” et sélectionnez votre environnement Dataverse

Étape 8 : Installer l'addon Business Central pour RapidStart CRM depuis AppSource

Cliquez sur ce lien pour ouvrir AppSource de Microsoft et confirmez que vous êtes connecté avec votre compte professionnel.

Sélectionnez “Obtenez-le maintenant” pour lancer l'installation.

1. Sélectionnez l'environnement où vous avez installé la solution de tables virtuelles.
2. Acceptez les termes.
3. Cliquez sur Installer. Notez que l'installation peut prendre plusieurs minutes.

Vous verrez que la solution est “En cours d'installation”. Cela peut prendre plusieurs minutes pour se terminer. Cliquez occasionnellement sur “rafraîchir” jusqu'à ce que vous voyiez qu'elle est “Installée”.

Étape 9 : Compléter dans l'application RapidStart Settings

Allez dans RapidStart CRM et sélectionnez l'application RapidStart Settings.

Vous pouvez ouvrir l'application RapidStart Settings depuis le sélecteur d'application dans RapidStart CRM, ou depuis le portail du créateur :
1. Sélectionnez Applications dans la barre latérale.
2. Cliquez sur l'icône Exécuter pour l'application RapidStart Settings.

1. Confirmez que vous êtes dans l'application RapidStart Settings.
2. Sélectionnez “Applications et Addons” dans la barre latérale.
3. Cliquez sur “Configurer” pour l'addon Business Central.

Ouvrez d'abord Connections. AppSource n'affiche pas l'invite de mappage de connexion utilisée lors d'une importation de solution manuelle. L'assistant signale le statut de connexion mais ne crée pas de connexions ni ne lie de références de connexion.

1. Dans Connections, sélectionnez Configure pour la référence de connexion Microsoft Dataverse. Cela ouvre Power Apps.
2. Sélectionnez le même environnement Dataverse, puis ouvrez Solutions → RapidStart BC Addon → Connection references. Attribuez une connexion valide à la référence Microsoft Dataverse et enregistrez.
3. Répétez Configure pour la référence de connexion Dynamics 365 Business Central. Dans Power Apps, attribuez une connexion Business Central valide à cette référence et enregistrez.
4. Retournez à l'assistant RapidStart Settings et sélectionnez Refresh. Vérifiez que les deux références sont liées à des connexions en direct.
5. Toujours dans Connections, enregistrez BC Environment comme nom d'environnement Business Central et BC Company System ID comme le Company System ID GUID capturé à l'étape 3, pas le nom d'entreprise modifiable.
6. Lorsque les connexions et paramètres requis sont prêts, ouvrez Automations et activez les flux recommandés. Laissez Sync New Account to BC et Sync New Contact to BC désactivés sauf si le client a choisi ces chemins de création. Si la synchronisation native CUSTOMER est propriétaire de la création de clients, gardez Sync New Account to BC désactivé.

Validez avant le déploiement

Utilisez un petit test contrôlé avant une synchronisation large. Les tests de création ci-dessous s'appliquent lorsque la création automatique native est sélectionnée. Si Sync. Only Coupled Records est activé, couplez d'abord les enregistrements de test et vérifiez les mises à jour au lieu d'attendre une création automatique.

1. Confirmez l'environnement cible Dataverse, l'environnement Business Central, et Company System ID; testez la connexion Dataverse depuis Business Central.
2. Confirmez le propriétaire de la création. Pour la création automatique native, désactivez Sync New Account to BC avant de tester.
3. Configurez et synchronisez CURRENCY, PAYMENT TERMS, SHIPMENT METHOD, et SHIPPING AGENT. Vérifiez Dataverse Option Mapping et les erreurs de synchronisation. Si les identifiants d'option ne sont pas alignés, utilisez FromIntegrationTable pour les trois mappages de champs d'options CUSTOMER décrits à l'étape 6.
4. Vérifiez que CUSTOMER est Bidirectional et confirmez la politique Sync. Only Coupled Records choisie. Pour la création automatique, réglez-le sur Désactivé et laissez Disable Event-driven Synch. Job Rescheduling décochée.
5. Examinez les filtres d'entreprise CUSTOMER, confirmez l'entrée de sa file d'attente de travaux, et notez l'intervalle de synchronisation. Couplez manuellement les paires existantes connues ; examinez les résultats de couplage basés sur la correspondance avant de les accepter.
6. Lancez Synchronize Modified Records, pas une synchronisation complète, pour le premier test contrôlé. Examinez Integration Synchronization Jobs et résolvez les échecs avant d'élargir le déploiement.
7. Créez un compte Dataverse avec un nom unique qui répond aux filtres CUSTOMER, sans numéro de client Business Central. Exécutez ou attendez la synchronisation. Confirmez qu'un client Business Central est créé avec un numéro de client attribué et Coupled to Dataverse = Yes.
8. Changez un champ mappé sur le compte Dataverse; exécutez ou attendez la prochaine synchronisation et vérifiez la mise à jour du client Business Central couplé.
9. Créez un client Business Central avec un nom unique qui répond aux filtres. Confirmez que le compte Dataverse couplé est créé ; changez un champ mappé dans Business Central et vérifiez la mise à jour Dataverse.
10. Testez un client avec une devise autre que la devise de base. Confirmez que le mappage des devises et les taux de change sont valides.
11. Testez la création de devis uniquement après que le compte soit couplé à un client Business Central valide.
12. Lancez une synchronisation complète uniquement après avoir examiné les filtres, les données de référence, les mappages d'options, les paires existantes et les journaux d'erreurs.

Dépannage

IDs de connexion manquants

Réparez les références de connexion dans Power Apps : sélectionnez le même environnement Dataverse, puis Solutions → RapidStart BC Addon → Connection references. Attribuez et enregistrez des connexions Microsoft Dataverse et Dynamics 365 Business Central valides. Retournez à l'assistant RapidStart Settings et sélectionnez Refresh, puis activez à nouveau le flux requis sous Automations. L'assistant ne répare pas les liaisons de connexion. Recréer une connexion seule n'est pas suffisant si sa référence pointe toujours vers l'ancienne connexion.

Erreurs de mappage de devises

Erreur : Table CRM Transactioncurrency must be mapped to table Currency to transfer value between fields TransactionCurrencyId and Currency Code.

Le mappage CUSTOMER fait référence à la Devise Dataverse, mais le mappage de la Devise CURRENCY ou son mappage de champ Code → Code de devise est manquant, désactivé, ou n'a pas synchronisé la devise référencée.

1. Restaurez ou créez le mappage CURRENCY et définissez sa direction sur Business Central vers Dataverse.
2. Activez Code → Code de devise et synchronisez les devises.
3. Confirmez que la devise du client existe dans Dataverse, puis réessayez la synchronisation CUSTOMER.

Incompatibilités d'options

Exemple : The value 100000003 of 'paymenttermscode' on record of type 'account' is outside the valid range. Accepted Values: 1,2,3,4.

Business Central a envoyé un ID d'énumération de conditions de paiement personnalisé qui n'est pas présent dans le choix de Conditions de paiement Dataverse de Compte.

1. Comparez Dataverse Option Mapping avec les ID de choix Dataverse valides.
2. Si l'option doit se synchroniser dans les deux sens, demandez à un développeur d'ajouter les valeurs de choix Dataverse et les valeurs d'extension d'énumération Business Central avec des ID numériques identiques. N'inventez pas ou ne renumérotez pas les ID lors de la configuration.
3. Sinon, définissez le mappage de champ de Code des conditions de paiement CUSTOMER sur FromIntegrationTable. Appliquez la même vérification pour la méthode de livraison et l'agent de livraison.
4. Réessayez un client et confirmez que l'action Business Central Compte ouvre le compte couplé Dataverse.

Couplages pointant vers des enregistrements supprimés

Si un enregistrement semble couplé mais que la synchronisation pointe vers un enregistrement supprimé ou manquant, supprimez le couplage obsolète dans Business Central et créez un nouveau couplage vers le compte ou contact Dataverse correct avant de relancer la synchronisation.

Références Microsoft

• Synchroniser Business Central et Dataverse
• Programmer les tâches de synchronisation
• Configurer une connexion Dataverse
• Gérer les valeurs d'option Dataverse manquantes