El autocompletado de direcciones, la validación de email/teléfono, las sugerencias de empresa (B2B) y la validación de nombre llaman a los webservices de DQE a través de las Custom API de Dynamics. Cuando algo está mal configurado, estas funciones normalmente no muestran ningún mensaje de error en el formulario — simplemente dejan de devolver sugerencias, como si no pasara nada. Este artículo explica las causas reales más comunes y dónde encontrar el motivo exacto.
Síntomas comunes
- No aparece ninguna sugerencia de dirección mientras se escribe en un campo de dirección.
- La comparación de validación de dirección RNVP no aparece al guardar, o ignora silenciosamente un bloque de dirección.
- Las búsquedas de teléfono, email, empresa o nombre nunca devuelven ningún resultado.
- No se muestra nada en el propio formulario que explique por qué — ni aviso, ni notificación de error.
Por qué no se muestra nada en el formulario
Estas funciones están diseñadas para fallar en silencio: si la llamada a la Custom API subyacente devuelve un error, el control PCF o el cuadro de diálogo de validación de dirección simplemente lo descarta y no muestra ninguna sugerencia, en lugar de interrumpir al usuario con una ventana de error. El motivo real se escribe en dos lugares en su lugar:
- El Plug-in Trace Log del entorno — siempre, para cada campo (dirección, email, teléfono, nombre, empresa).
- La consola del navegador (F12 → Console) — además, específicamente para la comparación de validación de dirección mostrada al guardar.
Activar y consultar el Plug-in Trace Log
- Abra el Power Platform admin center, vaya a Manage → Environments y seleccione el entorno de destino.
- Haga clic en Settings → Resources → All legacy settings para abrir el área de Settings clásica.
- Si el registro de trazas aún no está activado, vaya a Settings → Administration → System Settings, abra la pestaña Customization, y ponga Enable logging to plug-in trace log en Exception o All.
- Reproduzca el problema (escriba en el campo, o guarde el registro), luego vaya a Settings → Customization → Plug-in Trace Log y abra la entrada más reciente de la Custom API de DQE que está probando. El mensaje contendrá uno de los mensajes exactos de abajo.
Nota: el texto exacto en el trace log depende del idioma de interfaz de Dynamics del usuario que desencadenó la acción. DQE solo tiene traducciones para inglés, francés y español. En cualquier otro idioma de interfaz (incluido el alemán), cada uno de estos errores se registra con el mismo texto genérico de reserva en lugar del mensaje específico de abajo — en ese caso, cambie temporalmente su idioma personal a inglés, francés o español (Settings → Personalization Settings → Languages) para ver de cuál se trata realmente, o pruebe las causas de la tabla de abajo una por una.
Qué significa cada mensaje
| Mensaje que encontrará en el trace log | Qué significa | Dónde corregirlo |
|---|---|---|
| «No se encontró el registro "DQE Setup DataQ". Por favor, créelo para continuar con la operación.» (el mensaje usa un nombre distinto al de la pantalla real, "DQE DataQ Settings" — se refiere al mismo registro) | Aún no existe ningún registro de DQE DataQ Settings en este entorno. | Complete DQE DataQ Settings como se describe en DQE One Package Setup §2. |
| «Falta la licencia en la configuración de "DQE Paramétrages DataQ". Por favor, indíquela para continuar.» (el nombre entre comillas aparece en francés incluso en la versión en español — un fallo real del producto, no un error de este artículo) | El registro DataQ Settings existe, pero su campo DQE Licence está vacío. | DQE DataQ Settings → General → DQE Licence (Package Setup §2.2). |
| «Licencia inválida. Por favor, verifique su clave de licencia.» | Hay una clave de licencia configurada, pero el servidor de licencias de DQE la rechazó — normalmente una clave incorrecta, caducada o mal escrita, o un Org ID para el que la clave no está autorizada. | Verifique la clave con la proporcionada por su gestor de proyecto de DQE; contáctelo si el problema persiste. |
| «Falta la URL de la API DQE Address» | El campo Adresse de l'API DQE en DataQ Settings está vacío. | DQE DataQ Settings → General → Adresse de l'API DQE (Package Setup §2.3). |
| «Falta el código de país ISO3» | DQE no pudo resolver un código de país ISO3 para el registro — ver más abajo. | Ver Resolución del país más abajo. |
Resolución del país («Falta el código de país ISO3»)
Antes de llamar al webservice de DQE, DQE primero resuelve un código de país ISO3 para el registro: consulta el propio campo de país del registro (mediante la tabla de países de DQE), y si eso no se resuelve, recurre al campo Address Default Country configurado en DataQ Settings. El error solo aparece cuando ambas resoluciones fallan. Compruebe, en este orden:
- Que el campo de país propio del registro tiene un valor, y que ese valor existe en la tabla de países de DQE con un código ISO3 válido.
- Si el campo de país del registro está vacío o sin mapear, que DQE DataQ Settings → Address Default Country está configurado con un valor válido.
Cuándo contactar con el soporte de DQE
Si el Plug-in Trace Log no muestra ninguno de los mensajes anteriores, o muestra un mensaje genérico «Se produjo un error durante la ejecución del plugin», la causa está fuera de las comprobaciones de configuración propias de DQE (por ejemplo, un problema de red o del lado del servidor de DQE). Comparta la entrada exacta del trace log con su gestor de proyecto de DQE.
Artículos relacionados
- DQE One Package Setup on PowerApps / Dynamics
- Configure address, email, phone, name and B2B validation in Dynamics
Relacionada con