Configuration des préférences de site personnalisées pour le code de licence DQE (clé API)
Pour intégrer les services DQE dans votre environnement Salesforce Commerce Cloud (SFCC), configurez le code de licence DQE (clé API) dans vos préférences de site. Cette étape est obligatoire. Les autres configurations sont facultatives.
Configurer le code de licence DQE
- Accédez à Site > sélectionnez le site SFCC souhaité > Site Preferences > Custom Preferences > DQE dans Business Manager.
- Sélectionnez l'instance DQE appropriée dans la liste déroulante, telle que Sandbox/Development, Staging ou Production.
- Saisissez le code de licence DQE (clé API) fourni par votre interlocuteur DQE dans le champ DQE License Code.
- Cliquez sur Apply pour enregistrer la configuration.
Préférences de site personnalisées facultatives
Outre le License Code, d'autres paramètres facultatifs peuvent être configurés dans les préférences DQE.
Accédez à Site > sélectionnez le site SFCC souhaité > Site Preferences > Custom Preferences > DQE pour accéder à ces préférences et les configurer.
Préférences de site DQE
| ID | Nom | Description |
|---|---|---|
dqeLicenceCode |
DQE License Code | Code de licence DQE (clé API). Il est requis pour l'authentification à l'API DQE et doit être fourni par l'équipe DQE. |
dqeAddressSuggestionsEnabled |
DQE Address Suggestions Enabled | Active ou désactive la fonctionnalité de suggestion d'adresse sur le site. |
dqeAddressCompleteEnabled |
DQE Address Suggestions Complete Enabled | Active ou désactive l'appel API de complétion d'adresse pour la fonctionnalité de suggestion d'adresse sur le site. |
dqeAddressValidationEnabled |
DQE Address Validation Enabled | Active ou désactive la fonctionnalité de validation d'adresse sur le site. |
dqeAddressValidationMode |
DQE Address Validation Mode |
Définit à quel moment les adresses soumises sont validées avec DQE. Valeurs possibles : Avec Avec |
dqeAddressValidationPropositionEnabled |
DQE Address Validation Proposition Enabled | Définit le paramètre Proposition sur O pour l'appel RNVP. Cela permet de renvoyer des suggestions lorsque l'adresse est incorrecte. |
dqeAddressValidationModificationEnabled |
DQE Address Validation Modification Enabled | Définit le paramètre Modification sur O pour l'appel RNVP. Cela indique ce qui a été modifié par le moteur RNVP pour rendre une adresse postale valide. |
dqePhoneEnabled |
DQE Phone Enabled | Active ou désactive la fonctionnalité de validation du téléphone sur le site. |
dqePhoneResponsePhoneFormat |
DQE Response Phone Format | Définit le format du numéro de téléphone dans la réponse DQE. Consultez la documentation de l'API DQE pour plus de détails. |
dqeEmailEnabled |
DQE Email Enabled | Active ou désactive la fonctionnalité de validation de l'e-mail sur le site. |
dqeEmailRectifyEnabled |
DQE Email Rectify Enabled | Propose une correction du domaine lorsque le domaine saisi est inconnu. |
dqeEmailCheckuserEnabled |
DQE Email Checkuser Enabled | Vérifie la partie gauche d'une adresse e-mail. Si ce paramètre est défini sur No, l'appel API de validation est plus rapide, mais la partie gauche de l'adresse e-mail n'est pas validée. |
dqeCustomMappingUsageIsEnabled |
DQE Custom Mapping Usage Is Enabled | Active l'utilisation des règles de mapping de validation configurées dans Business Manager. Si ce paramètre est défini sur No, la validation utilise les règles configurées au niveau du code. |
Configuration des services dans SFCC
Après l'import du fichier services.xml depuis le dossier de métadonnées, les services DQE sont disponibles dans Business Manager Salesforce Commerce Cloud (SFCC).
Consulter et configurer les services
- Accédez à Administration > Operations > Services dans Business Manager SFCC.
- Dans la section Services, les services préfixés par
dqe.httpsont listés. - Les profils de service associés, préfixés par
dqe.http, sont également listés. Ces profils définissent la manière dont le système interagit avec les services DQE. - Les identifiants de service associés, préfixés par
dqe.http, sont également listés. Ces identifiants sont requis pour authentifier et autoriser les requêtes entre SFCC et DQE.
Profils de service
Les profils de service permettent de configurer les propriétés générales de connexion.
Accédez à Administration > Operations > Services > Profiles.
Configuration des identifiants de service pour les services DQE dans SFCC
Les identifiants de service permettent d'ajouter ou de modifier l'URL si nécessaire.
- Accédez à Administration > Operations > Services > Credentials.
- Dans la liste Credentials, les identifiants préfixés par
dqe.httpdoivent être visibles. - Ouvrez les identifiants de service DQE requis et configurez les champs URL tels que fournis par DQE. Vous pouvez également ajouter des paramètres de requête supplémentaires à l'URL si nécessaire.
Modules Business Manager pour DQE dans SFCC
La cartouche bm_dqe inclut des extensions et des modules supplémentaires pour Business Manager Salesforce Commerce Cloud (SFCC). Une fois la cartouche configurée globalement et l'accès utilisateur BM accordé, les modules DQE peuvent être consultés et configurés depuis Business Manager.
Accéder aux modules DQE dans Business Manager
- Accédez à BM > Merchant Tools > DQE dans Business Manager.
- Sélectionnez le site approprié, les modules et configurations DQE étant spécifiques à chaque site.
Liens DQE
Le module DQE Links propose aux utilisateurs deux boutons pour accéder facilement aux services DQE :
- Un bouton qui redirige les utilisateurs vers https://new.mydqe.com pour suivre leur consommation.
- Un bouton qui redirige les utilisateurs vers le Help Center à l'adresse https://helpcenter.dqe.tech/hc/en-gb.
Mappings des codes DQE
Le module DQE Codes Mapping permet aux administrateurs de configurer et de gérer le mapping entre les codes de réponse de validation DQE, les résultats de validation et les messages correspondants affichés aux utilisateurs.
Trois options sont disponibles en haut de la page pour mapper différents types de réponses :
- Email DQE Code Mapping
- Phone DQE Code Mapping
- Address DQE Code Mapping
Sélectionnez l'option appropriée pour afficher le mapping correspondant.
Actions disponibles :
- Create : créer de nouveaux codes.
- Edit : modifier des codes existants.
- Remove : supprimer des codes si nécessaire.
Chaque configuration de code DQE comprend les champs suivants :
- DQE Code
- Validation Status
- Display Message (localisable)
Le message affiché est spécifique à chaque locale : veillez donc à sélectionner la bonne locale dans le champ Locale avant de le modifier.
Remarque importante : le mapping de validation DQE est mis en cache. Après avoir effectué des modifications, invalidez le cache personnalisé DQE. Sinon, les modifications risquent de ne pas être appliquées immédiatement sur le storefront.
Le cache personnalisé est accessible via BM > Administration > Operations > Custom Caches.
Module Préférences de site DQE
Le module DQE Site Preferences propose une méthode alternative pour configurer les préférences de site liées à DQE. Ce module est utile lorsqu'un rôle utilisateur Business Manager (BM) n'a pas accès, ou ne doit pas avoir accès, à l'ensemble des modules Site Preferences du site.
Points clés :
- Le module DQE Site Preferences permet de configurer les préférences de site DQE personnalisées, comme décrit dans les sections précédentes.
- Il offre un moyen de gérer ces préférences sans avoir à accéder au module Site Preferences plus large, ce qui est utile lorsque des restrictions d'accès sont en place pour certains utilisateurs.
Cela permet aux utilisateurs de contrôler la configuration des préférences DQE sur le site, même lorsque l'accès à Site Preferences est limité.
Associé à