Configuración del paquete DQE One en PowerApps / Dynamics

Información general

El paquete DQE One para Dynamics funciona en dos modos complementarios:

Flujo de validación en tiempo real:

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

Flujo de integración Standalone:

Dynamics 365 (Standalone tab / iframe)  ⟶  DQE Standalone (External server, URL configured in DataQ Settings)

• Validación en tiempo real: los componentes PCF en los formularios de Cuenta, Contacto y Lead/Prospecto llaman a los servicios web de DQE (Dirección, Correo electrónico, Teléfono, Nombre, Empresa) a través de las API personalizadas de Dynamics. La validación se produce de forma integrada mientras el usuario escribe.
• Integración Standalone: una pestaña dedicada en la navegación de DQE carga una aplicación externa de DQE en un iframe. La URL del entorno de Dynamics se pasa como parámetro (?dynamics_org=…) para habilitar el contexto bidireccional.

1. Configuración de acceso

El paquete DQE incluye tres roles de seguridad. Asígnelos según lo que cada usuario necesite hacer.

1.1 Asignación de roles

• Administrador de DQE: asigne DQE – Data Administrator.
• Usuarios finales (formularios): asigne DQE – User.
• Usuario de aplicación Standalone: asigne DQE – Unify Application User.

1. Vaya a Power Platform admin center → seleccione el entorno de destino.
2. Vaya a Security roles, busque el rol de DQE y asígnelo a los usuarios correspondientes.
3. Haga clic en Save.

1.2 Registro de la aplicación en Azure

El módulo DQE Standalone (Unify) se autentica frente a Dynamics mediante una aplicación de Azure Active Directory. Registre esta aplicación en su tenant de Azure antes de crear el usuario de aplicación de Dynamics.

1. En el Azure portal, vaya a Azure Active Directory → App registrations → New registration. Introduzca un nombre (p. ej., DQE One) y haga clic en Register.
2. En la página Overview, copie el Application (client) ID y el Directory (tenant) ID. Consérvelos para los siguientes pasos.
3. Vaya a API permissions → Add a permission → Microsoft APIs → Dynamics CRM. Seleccione user_impersonation y haga clic en Add permissions.
4. Vaya a Manage → Authentication (Preview) y haga clic en + Add Redirect URL. Seleccione el tipo Web y, a continuación, en el campo Redirect URL, introduzca su URL de ACI con el sufijo /dynamics/code:
   https://<your-aci-url>/dynamics/code

Nota: guarde el Directory (tenant) ID, el Application (client) ID y el Client Secret en un lugar seguro; son necesarios para el §1.3 y el §2.5.

1.3 Usuario de aplicación (S2S)

Cree un usuario de aplicación servidor a servidor (S2S) no interactivo en el entorno de Dynamics de destino y concédale los roles de DQE necesarios.

1. En Power Platform admin center, seleccione el entorno de destino y vaya a Settings → Users → Application users → New app user.
2. Haga clic en Add an app y pegue el Client ID obtenido en el §1.2. Seleccione la aplicación de la lista y haga clic en Add.
3. Seleccione una Business Unit (opcional) y haga clic en Create.
4. Abra el usuario de aplicación recién creado, haga clic en Edit security roles y asigne los siguientes roles: DQE – Unify Application User, DQE – Data Administrator, DQE – User. Haga clic en Save.

2. Configuración

Toda la configuración se realiza en DQE DataQ Settings, accesible desde la navegación de la aplicación DQE (Parameters → DQE DataQ Settings). La navegación redirige automáticamente al único registro de configuración.

2.1 Instalación del paquete

La solución administrada DQE One debe estar instalada en el entorno de Dynamics Sales o Power Apps de destino antes de continuar con cualquiera de las configuraciones siguientes.

2.2 Activación de la licencia

Introduzca la clave de licencia y habilite los servicios web incluidos en el contrato del cliente.

1. En DQE DataQ Settings → General, introduzca la clave DQE Licence proporcionada por su gestor de proyecto DQE.
2. Configure cada producto contratado en Yes. Active únicamente lo que figure en el contrato del cliente:

1. Haga clic en Save & Close.

2.3 URL de la API

La URL de la API de DQE es la dirección del servidor de servicios web de DQE. Los plugins backend de Dynamics la utilizan para llamar a las API de validación (dirección, correo electrónico, teléfono, nombre, empresa).

1. En DQE DataQ Settings → General, localice el campo API URL address.
2. Introduzca la URL proporcionada por su gestor de proyecto DQE.
3. Haga clic en Save & Close.

Nota: la entidad DQE Metadata presente en versiones anteriores del paquete se ha eliminado. La URL de la API ahora se gestiona directamente en DataQ Settings.

2.4 URL de Standalone

La URL de Standalone apunta a la aplicación externa DQE Standalone. Se muestra en un iframe dentro de la pestaña Standalone de la navegación de DQE.

1. En DQE DataQ Settings → General, localice el campo Standalone URL.
2. Introduzca la URL proporcionada por su gestor de proyecto DQE.
3. Haga clic en Save & Close.
4. Vaya a la pestaña Standalone de la aplicación DQE para verificar que el iframe se carga correctamente. Si la URL no es accesible, se muestra una advertencia de accesibilidad con la opción de editar la URL en línea.

Importante: la URL de Standalone debe ser accesible públicamente desde el navegador del usuario. No se llama desde el servidor: el navegador la carga directamente dentro del iframe. Asegúrese de que las reglas de CORS y del firewall permitan el acceso desde las redes de los usuarios de Dynamics.

2.5 Credenciales de Standalone

Para conectar la aplicación Standalone a su entorno de Dynamics 365, debe añadir una credencial de Dynamics directamente en la interfaz de Standalone. Estas credenciales las proporciona su gestor de proyecto DQE y corresponden a una aplicación de Azure AD registrada en su tenant.

1. Inicie sesión en la aplicación DQE Standalone.
2. Abra el User Profile y vaya a la sección Credentials.
3. Haga clic en New y seleccione Microsoft Dynamics como tipo de conector.
4. Complete los cuatro campos obligatorios:

1. Haga clic en Log In. El servidor Standalone se autentica frente a Dynamics y almacena la credencial para su uso futuro.

Nota: el usuario de aplicación de Dynamics vinculado a esta credencial debe tener asignado el rol de seguridad DQE – Unify Application User en Power Platform admin center.

Una vez configurado el paquete, continúe configurando cada servicio web individualmente en el editor de formularios. Consulte Configurar la validación de direcciones, correo electrónico, teléfono y B2B en Dynamics.