Configuration du package DQE One sur PowerApps / Dynamics

Support DQE
Support DQE
  • Mise à jour

Configuration du package DQE One sur PowerApps / Dynamics

Vue d'ensemble

Le package DQE One pour Dynamics fonctionne selon deux modes complémentaires :

Flux de validation en temps réel :

Dynamics 365 (PCF controls on forms)  ⟷  DQE Plugin (Custom API backend)  ⟶  DQE API (Webservices)

Flux d'intégration Standalone :

Dynamics 365 (Standalone tab / iframe)  ⟶  DQE Standalone (External server, URL configured in DataQ Settings)
  • Validation en temps réel : les composants PCF sur les formulaires Account, Contact et Lead appellent les webservices DQE (Address, Email, Phone, First Name, Company) via les Custom API Dynamics. La validation s'effectue au fil de la saisie.
  • Intégration Standalone : un onglet dédié dans la navigation DQE charge une application DQE externe dans une iframe. L'URL de l'environnement Dynamics est transmise en paramètre (?dynamics_org=…) pour permettre un contexte bidirectionnel.

1. Configuration des accès

Le package DQE inclut trois rôles de sécurité. Attribuez-les selon ce que chaque utilisateur doit faire.

Rôle Description
DQE - Data administrator Accès complet à la configuration DQE et à toutes les entités DQE. Nécessaire pour les administrateurs qui configurent la solution (DataQ Settings, mappings de champs, table des pays).
DQE - User Accès utilisateur final requis pour utiliser les fonctionnalités de validation DQE sur les formulaires Dynamics. À attribuer à tous les utilisateurs qui interagissent avec les formulaires Account, Contact ou Lead.
DQE - Unify Application User Rôle d'utilisateur applicatif non interactif. Accorde un accès complet en lecture/écriture sur Account, Contact, Lead et les entités DQE, y compris le privilège de fusion (Merge). Nécessaire si l'application DQE Standalone accède aux données Dynamics via un utilisateur applicatif.

1.1 Attribution des rôles

  • Administrateur DQE : attribuez DQE - Data administrator.
  • Utilisateurs finaux (formulaires) : attribuez DQE - User.
  • Utilisateur applicatif Standalone : attribuez DQE - Unify Application User.
  1. Allez dans le Power Platform admin center → sélectionnez l'environnement cible.
  2. Allez dans Security roles, trouvez le rôle DQE, et attribuez-le aux utilisateurs concernés.
  3. Cliquez sur Save.

1.2 Enregistrement d'application Azure

Le module DQE Standalone (Unify) s'authentifie auprès de Dynamics via une application Azure Active Directory. Enregistrez cette application dans votre tenant Azure avant de créer l'utilisateur applicatif Dynamics.

  1. Dans le portail Azure, allez dans Azure Active Directory → App registrations → New registration. Saisissez un nom (par exemple DQE One) et cliquez sur Register.
  2. Sur la page Overview, copiez l'Application (client) ID et le Directory (tenant) ID. Conservez-les pour les étapes suivantes.
  3. Facultatif — allez dans API permissions → Add a permission → Microsoft APIs → Dynamics CRM. Sélectionnez user_impersonation et cliquez sur Add permissions. Cette étape n'est pas obligatoire — voir la remarque ci-dessous.
  4. Allez dans Manage → Authentication (Preview) et cliquez sur + Add Redirect URL. Sélectionnez le type Web, puis dans le champ Redirect URL saisissez votre URL ACI suivie du suffixe /dynamics/code :
    https://<your-aci-url>/dynamics/code

Remarque : conservez le Directory (tenant) ID, l'Application (client) ID et le Client Secret en lieu sûr — ils sont nécessaires pour les §1.3 et §2.5.

Remarque : la permission user_impersonation ci-dessus n'est pas nécessaire pour le flux d'utilisateur applicatif (S2S) décrit au §1.3. L'accès à Dataverse de l'utilisateur applicatif est entièrement régi par son rôle de sécurité (DQE - Unify Application User), pas par cette permission d'API Azure AD. Si la politique de sécurité de votre organisation restreint l'octroi de permissions d'API déléguées, vous pouvez ignorer cette étape — une inscription d'application avec uniquement la permission par défaut User.Read sur Microsoft Graph fonctionne correctement. Voir l'article Rôles et permissions DQE One dans Dynamics pour plus de détails.

1.3 Utilisateur applicatif (S2S)

Créez un utilisateur applicatif serveur à serveur (S2S) non interactif dans l'environnement Dynamics cible et accordez-lui les rôles DQE nécessaires.

  1. Dans le Power Platform admin center, sélectionnez l'environnement cible et allez dans Settings → Users → Application users → New app user.
  2. Cliquez sur Add an app et collez le Client ID obtenu au §1.2. Sélectionnez l'application dans la liste et cliquez sur Add.
  3. Sélectionnez une Business Unit (facultatif) et cliquez sur Create.
  4. Ouvrez l'utilisateur applicatif nouvellement créé, cliquez sur Edit security roles, et attribuez les rôles suivants : DQE - Unify Application User, DQE - Data administrator, DQE - User. Cliquez sur Save.

2. Configuration

Toute la configuration se fait dans DQE DataQ Settings, accessible depuis la navigation de l'application DQE (Parameters → DQE DataQ Settings). La navigation redirige automatiquement vers l'unique fiche de configuration.

2.1 Installation du package

La solution managée DQE One doit être installée dans l'environnement Dynamics Sales ou Power Apps cible avant de procéder à toute configuration ci-dessous.

2.2 Activation de la licence

Saisissez la clé de licence et activez les webservices couverts par le contrat du client.

  1. Dans DQE DataQ Settings → General, saisissez la clé DQE Licence fournie par votre chef de projet DQE.
  2. Positionnez chaque produit souscrit sur Yes. N'activez que ce qui est prévu au contrat du client :
Bascule Description
Enable Address Autocomplete Active la liste déroulante de suggestions d'adresse
Enable Address Validation (RNVP) Active la boîte de dialogue de validation RNVP à l'enregistrement
Enable Email Validation Active la validation des emails
Enable Phone Validation Active la validation des téléphones
Enable Firstname Validation Active la suggestion de prénom/nom
Enable Company Verification Active la suggestion et la vérification B2B
  1. Cliquez sur Save & Close.

2.3 URL de l'API

L'URL de l'API DQE est l'adresse du serveur de webservices DQE. Elle est utilisée par les plugins back-end Dynamics pour appeler les API de validation (adresse, email, téléphone, nom, entreprise).

Paramètre Valeur
Adresse de l'API DQE Saisissez l'URL du serveur DQE fournie par votre chef de projet DQE.
  1. Dans DQE DataQ Settings → General, repérez le champ Adresse de l'API DQE.
  2. Saisissez l'URL fournie par votre chef de projet DQE.
  3. Cliquez sur Save & Close.

Remarque : l'entité DQE Metadata présente dans les versions précédentes du package a été supprimée. L'URL de l'API est désormais gérée directement dans DataQ Settings.

2.4 URL Standalone

L'URL Standalone pointe vers l'application DQE Standalone externe. Elle est affichée dans une iframe au sein de l'onglet Standalone de la navigation DQE.

Paramètre Valeur
Standalone URL Saisissez l'URL de l'application DQE Standalone fournie par votre chef de projet DQE.
  1. Dans DQE DataQ Settings → General, repérez le champ Standalone URL.
  2. Saisissez l'URL fournie par votre chef de projet DQE.
  3. Cliquez sur Save & Close.
  4. Allez dans l'onglet Standalone de l'application DQE pour vérifier que l'iframe se charge correctement. Si l'URL est inaccessible, un avertissement d'accessibilité s'affiche avec une option pour modifier l'URL directement sur place.

Important : l'URL Standalone doit être accessible publiquement depuis le navigateur de l'utilisateur. Elle n'est pas appelée côté serveur — le navigateur la charge directement dans l'iframe. Assurez-vous que les règles CORS et le pare-feu autorisent l'accès depuis les réseaux des utilisateurs Dynamics.

2.5 Identifiants Standalone

Pour connecter l'application Standalone à votre environnement Dynamics 365, vous devez ajouter un identifiant Dynamics directement dans l'interface Standalone. Ces identifiants sont fournis par votre chef de projet DQE et correspondent à une application Azure AD enregistrée sur votre tenant.

  1. Connectez-vous à l'application DQE Standalone.
  2. Ouvrez User Profile et allez dans la section Credentials.
  3. Cliquez sur New et sélectionnez Microsoft Dynamics comme type de connecteur.
  4. Renseignez les quatre champs requis :
Champ Valeur
Tenant Tenant ID Azure Active Directory.
Client Id Application (client) ID de l'enregistrement d'application Azure AD.
Client Secret Secret client généré pour l'enregistrement d'application.
Scope L'URL de votre environnement Dynamics, par exemple https://yourorg.crm.dynamics.com.
  1. Cliquez sur Log In. Le serveur Standalone s'authentifie auprès de Dynamics et enregistre l'identifiant pour une utilisation future.

Remarque : l'utilisateur applicatif Dynamics lié à cet identifiant doit avoir le rôle de sécurité DQE - Unify Application User attribué dans le Power Platform admin center.

Une fois le package configuré, passez à la configuration de chaque webservice individuellement dans l'éditeur de formulaire. Voir Configure address, email, phone and B2B validation in Dynamics.

Associé à

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 0