Configuration du package DQE One sur PowerApps / Dynamics
Vue d'ensemble
Le package DQE One 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 API personnalisées Dynamics. La validation s'effectue en direct pendant la saisie de l'utilisateur.
-
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 en fonction des besoins de chaque utilisateur.
| Rôle | Description |
|---|---|
| DQE – Data Administrator | Accès complet à la configuration DQE et à toutes les entités DQE. Requis pour les administrateurs configurant 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 interagissant 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 les entités Account, Contact, Lead et DQE, y compris le privilège Merge. Requis si l'application DQE Standalone accède aux données Dynamics via un utilisateur applicatif. |
1.1 Attribution des rôles
- Administrateur DQE : attribuer DQE – Data Administrator.
- Utilisateurs finaux (formulaires) : attribuer DQE – User.
- Utilisateur applicatif Standalone : attribuer DQE – Unify Application User.
- Accédez au Power Platform admin center → sélectionnez l'environnement cible.
- Accédez à Security roles, recherchez le rôle DQE, et attribuez-le aux utilisateurs concernés.
- Cliquez sur Save.
1.2 Enregistrement de l'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.
- Dans le portail Azure, accédez à Azure Active Directory → App registrations → New registration. Saisissez un nom (par ex. DQE One) et cliquez sur Register.
- Sur la page Overview, copiez l'Application (client) ID et le Directory (tenant) ID. Conservez-les pour les étapes suivantes.
- Accédez à API permissions → Add a permission → Microsoft APIs → Dynamics CRM. Sélectionnez user_impersonation et cliquez sur Add permissions.
- Accédez à Manage → Authentication (Preview) et cliquez sur + Add Redirect URL. Sélectionnez le type Web, puis dans le champ Redirect URL saisissez votre URL ACI avec le suffixe /dynamics/code :
https://<your-aci-url>/dynamics/code
Note : 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.
1.3 Utilisateur applicatif (S2S)
Créez un utilisateur applicatif non interactif de type serveur à serveur (S2S) dans l'environnement Dynamics cible et attribuez-lui les rôles DQE requis.
- Dans le Power Platform admin center, sélectionnez l'environnement cible et accédez à Settings → Users → Application users → New app user.
- 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.
- Sélectionnez une Business Unit (facultatif) et cliquez sur Create.
- 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 s'effectue dans DQE DataQ Settings, accessible depuis la navigation de l'application DQE (Parameters → DQE DataQ Settings). La navigation redirige automatiquement vers l'unique enregistrement 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 à l'une des configurations ci-dessous.
2.2 Activation de la licence
Saisissez la clé de licence et activez les webservices couverts par le contrat du client.
- Dans DQE DataQ Settings → General, saisissez la clé DQE Licence fournie par votre chef de projet DQE.
- Positionnez chaque produit souscrit sur Yes. N'activez que ce qui figure dans le contrat du client :
| Toggle | Description |
|---|---|
| Enable Address Autocomplete | Active le menu déroulant de suggestion d'adresse |
| Enable Address Validation (RNVP) | Active la boîte de dialogue de validation RNVP à l'enregistrement |
| Enable Email Validation | Active la validation Email |
| Enable Phone Validation | Active la validation Phone |
| Enable Firstname Validation | Active la suggestion de prénom/nom |
| Enable Company Verification | Active la suggestion et la vérification B2B |
- 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 backend Dynamics pour appeler les API de validation (adresse, email, téléphone, nom, entreprise).
| Paramètre | Valeur |
|---|---|
| API URL address | Saisissez l'URL du serveur DQE fournie par votre chef de projet DQE. |
- Dans DQE DataQ Settings → General, repérez le champ API URL address.
- Saisissez l'URL fournie par votre chef de projet DQE.
- Cliquez sur Save & Close.
Note : l'entité DQE Metadata présente dans les versions antérieures 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 externe DQE Standalone. Elle s'affiche 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. |
- Dans DQE DataQ Settings → General, repérez le champ Standalone URL.
- Saisissez l'URL fournie par votre chef de projet DQE.
- Cliquez sur Save & Close.
- Accédez à l'onglet Standalone dans 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.
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 de 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.
- Connectez-vous à l'application DQE Standalone.
- Ouvrez le User Profile et accédez à la section Credentials.
- Cliquez sur New et sélectionnez Microsoft Dynamics comme type de connecteur.
- 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 ex. https://yourorg.crm.dynamics.com. |
- Cliquez sur Log In. Le serveur Standalone s'authentifie auprès de Dynamics et enregistre l'identifiant pour une utilisation future.
Note : 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é, procédez à la configuration de chaque webservice individuellement dans l'éditeur de formulaire. Voir Configurer la validation d'adresse, d'email, de téléphone et B2B dans Dynamics.
Associé à