Paramètres pour Microsoft Dynamics 365 Business Central
Cette rubrique décrit comment configurer une connexion Dynamics 365 Business Central pour DataSync.
Pour configurer une nouvelle connexion
-
Se connecter à Dynamics 365 Business Central.
-
Accédez à la page Gérer les profils.
-
Chaque utilisateur possède une carte à laquelle vous pouvez attribuer des rôles.
-
-
Définissez les autorisations que vous souhaitez donner à l'utilisateur.
-
Ensuite, vous devez vous connecter au portail Azure à l'aide d'un utilisateur administrateur.
-
Sélectionnez Inscriptions d’applications et créez une nouvelle inscription pour votre utilisateur.
-
Sélectionnez un nom, un type de compte pris en charge et une URI de redirection, puis enregistrez.
-
De retour sur la page Inscriptions d’applications, sélectionnez la nouvelle inscription que vous venez de créer.
-
Allez dans la section Permissions API et sélectionnez toutes les permissions API nécessaires à votre application.
-
Ensuite, allez dans la section Certificats et secrets pour créer votre propre secret client.
Ce nouveau secret client ne peut être copié qu'une seule fois ; veillez donc le conserver pour un usage ultérieur.
-
Une fois l'application créée pour l'utilisateur, naviguez vers DataSync pour commencer la configuration d'un nouveau connecteur pour Microsoft Dynamics 365 Business Central.
Par défaut, nous autorisons l'utilisation de la connexion OAuth uniquement pour l'API en Cloud, et les accessKeys pour l'API On Premise.
-
Ajouter un nouveau connecteur avec les propriétés ci-dessous.
Après avoir sauvegardé le connecteur, une page devrait s'ouvrir vous demandant de vous connecter à votre compte. Une fois connecté, le callback devrait être effectué avec succès et vous pouvez commencer à travailler avec votre nouveau connecteur.
Propriétés de connexion Microsoft Dynamics 365 Business Central
| Paramètre | Description |
|---|---|
| Description | Saisir un nom d'utilisateur pour identifier la connexion dans DataSync. |
| URL de l'organisation |
Microsoft Dynamics 365 Business Central prend en charge plusieurs endpoints différents pour se connecter aux données, les deux catégories principales étant les endpoints de service commun et les endpoints de services Web. De plus, chaque ensemble d'endpoints est divisé en endpoints de production et de test. Par défaut, l'URL de l'organisation (OrganizationUrl) tentera de se connecter à un endpoint de service commun de production si une adresse du type https://businesscentral.dynamics.com/ est spécifiée. Cependant, la configuration peut être modifiée en changeant le type d'endpoint (EndpointType). Endpoints de service commun Les endpoints de service commun contiennent les données opérationnelles associées à Microsoft Dynamics 365 Business Central. Par exemple, les comptes, les bons de commande et les factures de vente se trouvent tous dans le service commun. Endpoints de service commun - Production https://api.businesscentral.dynamics.com/v2.0/{environment name}/api/v2.0 https://api.businesscentral.dynamics.com/v1.0/api/v2.0 https://api.businesscentral.dynamics.com/v2.0/sandbox/api/v2.0 Endpoints de service commun - Test https://api.businesscentral.dynamics.com/v2.0/{tenant id}/{environment name}/api/v2.0 https://api.businesscentral.dynamics.com/v1.0/{tenant id}/api/v2.0 https://api.businesscentral.dynamics.com/v2.0/{tenant id}/sandbox/api/v2.0 Note
L'identifiant du client (Tenant Id) est l'identifiant de votre client Azure qui vous permet d'accéder à l'application Business Central. Pour l'obtenir, connectez-vous à portal.azure.com, sélectionnez votre nom d'utilisateur et accédez à Switch Directory. Vous pouvez également le trouver en allant sur portal.azure.com, puis en sélectionnant Active Directory et ensuite Overview. Les noms d'environnement (environment names) sont disponibles sur https://businesscentral.dynamics.com/{tenant id}/admin. Endpoints de services Web Les endpoints de services Web comprennent toute donnée dont l'exposition a été personnalisée dans Microsoft Dynamics 365 Business Central. Il peut s'agir d'indicateurs de performance clés (KPI), de rapports, d'entités individuelles ou d'autres données. Dans Microsoft Dynamics 365 Business Central, cliquez sur la loupe et recherchez Services Web (Web Services) pour en savoir plus sur le contenu de ces endpoints. Endpoints de services Web - Production https://api.businesscentral.dynamics.com/v1.0/ODataV4/ Endpoints de services Web - Test https://api.businesscentral.dynamics.com/v1.0/{tenant id}/ODataV4/ Note
Pour utiliser les endpoints de services Web, consultez la section Autres propriétés de la connexion indiquez le type d'endpoint (EndpointType). Endpoints d'API personnalisés Pour vous connecter aux endpoints d'API personnalisés, vous devez définir la propriété de l'URL de l'organisation (OrganizationUrl) sur votre URL de base personnalisée comme suit : https://api.businesscentral.dynamics.com/v2.0/{tenant}/api/{API publisher}/{API group}/{API version} |
| Compagnie |
Saisir le nom de votre entreprise tel qu'il est également écrit dans les paramètres de l'API Microsoft Dynamics 365 Business Central. Il agit également comme un schéma dans le contexte de l'API, donc il est recommandé de le définir. |
| ID de l'annuaire (locataire) |
Vous trouverez cette information dans la page vue d'ensemble de la nouvelle inscription que vous avez créée. |
| Mode d'authentification |
Sélectionnez votre mode d'authentification :
|
| URL de rappel |
Ce champ aura déjà une valeur. Copiez-la, puis allez dans votre portail Azure. Dans Inscription d'application, sélectionnez l'application qui sera utilisée pour DataSync, et allez dans la section Gérer l'authentification. Ajoutez une configuration de plateforme Web avec l'URL de rappel qui avait été copiée. |
| Identité du client | Vous trouverez cette information dans la page vue d'ensemble de l'application que vous avez créée. |
| Secret du client | Il s'agit du secret client que vous avez créé à l'étape 9. |