Configuración de las site preferences personalizadas para el código de licencia de DQE (clave de API)
Para integrar los servicios de DQE en su entorno de Salesforce Commerce Cloud (SFCC), configure el DQE License Code (clave de API) en sus site preferences. Este paso es obligatorio. El resto de configuraciones son opcionales.
Configurar el DQE License Code
- Vaya a Site > seleccione el sitio SFCC deseado > Site Preferences > Custom Preferences > DQE en Business Manager.
- Seleccione la instancia de DQE adecuada en el menú desplegable, como Sandbox/Development, Staging o Production.
- Introduzca el DQE License Code (clave de API) proporcionado por su representante de DQE en el campo DQE License Code.
- Haga clic en Apply para guardar la configuración.
Site preferences personalizadas opcionales
Además del License Code, se pueden configurar otros ajustes opcionales en las preferencias de DQE.
Vaya a Site > seleccione el sitio SFCC deseado > Site Preferences > Custom Preferences > DQE para acceder a estas preferencias y configurarlas.
Site preferences de DQE
| ID | Name | Description |
|---|---|---|
dqeLicenceCode |
DQE License Code | Código de licencia de DQE (clave de API). Es obligatorio para la autenticación de la API de DQE y debe ser proporcionado por el equipo de DQE. |
dqeAddressSuggestionsEnabled |
DQE Address Suggestions Enabled | Habilita o deshabilita la función de sugerencia de direcciones en el sitio. |
dqeAddressCompleteEnabled |
DQE Address Suggestions Complete Enabled | Habilita o deshabilita la llamada a la API de finalización de direcciones para la función de sugerencia de direcciones en el sitio. |
dqeAddressValidationEnabled |
DQE Address Validation Enabled | Habilita o deshabilita la función de validación de direcciones en el sitio. |
dqeAddressValidationMode |
DQE Address Validation Mode |
Define cuándo se validan con DQE las direcciones enviadas. Valores posibles: Con Con |
dqeAddressValidationPropositionEnabled |
DQE Address Validation Proposition Enabled | Establece el parámetro Proposition en O para la llamada RNVP. Esto permite devolver sugerencias cuando la dirección es incorrecta. |
dqeAddressValidationModificationEnabled |
DQE Address Validation Modification Enabled | Establece el parámetro Modification en O para la llamada RNVP. Esto indica lo que ha modificado el motor RNVP para que una dirección postal sea válida. |
dqePhoneEnabled |
DQE Phone Enabled | Habilita o deshabilita la función de validación de teléfono en el sitio. |
dqePhoneResponsePhoneFormat |
DQE Response Phone Format | Define el formato de teléfono de la respuesta de DQE. Consulte la documentación de la API de DQE para obtener más información. |
dqeEmailEnabled |
DQE Email Enabled | Habilita o deshabilita la función de validación de correo electrónico en el sitio. |
dqeEmailRectifyEnabled |
DQE Email Rectify Enabled | Propone una corrección de dominio cuando el dominio introducido es desconocido. |
dqeEmailCheckuserEnabled |
DQE Email Checkuser Enabled | Comprueba la parte izquierda de una dirección de correo electrónico. Si se establece en No, la llamada a la API de validación es más rápida, pero no se valida la parte izquierda de la dirección de correo electrónico. |
dqeCustomMappingUsageIsEnabled |
DQE Custom Mapping Usage Is Enabled | Habilita el uso de las reglas de asignación de validación configuradas en Business Manager. Si se establece en No, la validación utiliza las reglas configuradas a nivel de código. |
Configuración de servicios en SFCC
Tras importar el archivo services.xml desde la carpeta metadata, los servicios de DQE quedan disponibles en Business Manager de Salesforce Commerce Cloud (SFCC).
Ver y configurar servicios
- Vaya a Administration > Operations > Services en Business Manager de SFCC.
- En la sección Services, se listan los servicios con el prefijo
dqe.http. - También se listan los perfiles de servicio vinculados con el prefijo
dqe.http. Estos perfiles definen cómo interactúa el sistema con los servicios de DQE. - También se listan las credenciales de servicio vinculadas con el prefijo
dqe.http. Estas credenciales son necesarias para autenticar y autorizar las solicitudes entre SFCC y DQE.
Perfiles de servicio
Los perfiles de servicio se utilizan para configurar las propiedades generales de conexión.
Vaya a Administration > Operations > Services > Profiles.
Configuración de las credenciales de servicio para los servicios de DQE en SFCC
Las credenciales de servicio se utilizan para añadir o cambiar la URL cuando sea necesario.
- Vaya a Administration > Operations > Services > Credentials.
- En la lista Credentials, deberían aparecer las credenciales con el prefijo
dqe.http. - Abra las credenciales de servicio de DQE necesarias y configure los campos de URL según lo proporcionado por DQE. También puede añadir parámetros de consulta adicionales a la URL si es necesario.
Módulos de Business Manager para DQE en SFCC
El cartridge bm_dqe incluye extensiones y módulos adicionales para Business Manager de Salesforce Commerce Cloud (SFCC). Una vez configurado el cartridge a nivel global y concedido el acceso de usuario de BM, se puede acceder a los módulos de DQE y configurarlos a través de Business Manager.
Acceder a los módulos de DQE en Business Manager
- Vaya a BM > Merchant Tools > DQE en Business Manager.
- Seleccione el sitio correspondiente, ya que los módulos y configuraciones de DQE son específicos de cada sitio.
DQE Links
El módulo DQE Links proporciona a los usuarios dos botones para acceder fácilmente a los servicios de DQE:
- Un botón que redirige a los usuarios a https://new.mydqe.com para seguir su consumo.
- Un botón que redirige a los usuarios al Help Center en https://helpcenter.dqe.tech/hc/en-gb.
DQE Codes Mappings
El módulo DQE Codes Mapping permite a los usuarios administradores configurar y gestionar la asignación de los códigos de respuesta de validación de DQE a los resultados de validación y a los mensajes correspondientes que se muestran a los usuarios.
En la parte superior de la página hay tres opciones disponibles para asignar los diferentes tipos de respuestas:
- Email DQE Code Mapping
- Phone DQE Code Mapping
- Address DQE Code Mapping
Seleccione la opción correspondiente para mostrar la asignación correspondiente.
Acciones disponibles:
- Crear nuevos códigos.
- Editar códigos existentes.
- Eliminar códigos según sea necesario.
Cada configuración de código de DQE incluye los siguientes campos:
- DQE Code
- Validation Status
- Display Message (localizable)
El mensaje de visualización es específico de cada idioma, así que asegúrese de seleccionar el idioma correcto en el campo Locale antes de editarlo.
Nota importante: la asignación de validación de DQE es almacenable en caché. Después de realizar cambios, invalide la caché personalizada de DQE. De lo contrario, es posible que los cambios no se apliquen de inmediato en el storefront.
La caché personalizada está disponible en BM > Administration > Operations > Custom Caches.
Módulo DQE Site Preferences
El módulo DQE Site Preferences proporciona un método alternativo para configurar las site preferences relacionadas con DQE. Este módulo es útil cuando un rol de usuario de Business Manager (BM) no tiene acceso, o no debería tenerlo, a todos los módulos de Site Preferences del sitio.
Puntos clave:
- El módulo DQE Site Preferences permite configurar las site preferences personalizadas de DQE descritas en las secciones anteriores.
- Proporciona una forma de gestionar estas preferencias sin acceder al módulo más amplio de Site Preferences, lo cual es útil cuando existen restricciones de acceso para determinados usuarios.
Esto da a los usuarios control sobre cómo se configuran las preferencias de DQE en el sitio, incluso cuando se concede un acceso limitado a Site Preferences.
Relacionada con