Configuración del paquete DQE One en PowerApps / Dynamics

Resumen

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 Account, Contact y Lead llaman a los webservices DQE (Address, Email, Phone, First Name, Company) a través de las Custom API de Dynamics. La validación ocurre mientras el usuario escribe.
• Integración Standalone: una pestaña dedicada en la navegación de DQE carga una aplicación DQE externa en un iframe. La URL del entorno de Dynamics se pasa como parámetro (?dynamics_org=…) para permitir un contexto bidireccional.

1. Configuración de accesos

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 DQE: asigne DQE - Data administrator.
• Usuarios finales (formularios): asigne DQE - User.
• Usuario de aplicación Standalone: asigne DQE - Unify Application User.

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

1.2 Registro de 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 portal de Azure, vaya a Azure Active Directory → App registrations → New registration. Introduzca un nombre (por ejemplo, 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 pasos siguientes.
3. Opcional — vaya a API permissions → Add a permission → Microsoft APIs → Dynamics CRM. Seleccione user_impersonation y haga clic en Add permissions. Este paso no es obligatorio — consulte la nota a continuación.
4. Vaya a Manage → Authentication (Preview) y haga clic en + Add Redirect URL. Seleccione el tipo Web y, en el campo Redirect URL, introduzca su URL de ACI con el sufijo /dynamics/code:
   https://<your-aci-url>/dynamics/code

Nota: guarde en un lugar seguro el Directory (tenant) ID, el Application (client) ID y el Client Secret — se necesitan para los §1.3 y §2.5.

Nota: el permiso user_impersonation anterior no es necesario para el flujo de usuario de aplicación (S2S) descrito en el §1.3. El acceso a Dataverse del usuario de aplicación está regido íntegramente por su rol de seguridad (DQE - Unify Application User), no por este permiso de API de Azure AD. Si la política de seguridad de su organización restringe la concesión de permisos de API delegados, puede omitir este paso — un registro de aplicación con solo el permiso predeterminado User.Read en Microsoft Graph funciona correctamente. Consulte el artículo Roles y permisos de DQE One en Dynamics para más detalles.

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 otórguele los roles DQE necesarios.

1. En el 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 instalarse en el entorno de Dynamics Sales o Power Apps de destino antes de proceder con cualquier configuración siguiente.

2.2 Activación de la licencia

Introduzca la clave de licencia y active los webservices cubiertos por el contrato del cliente.

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

1. Haga clic en Save & Close.

2.3 URL de la API

La URL de la API DQE es la dirección del servidor de webservices DQE. La utilizan los plugins del backend de Dynamics para llamar a las API de validación (dirección, email, teléfono, nombre, empresa).

1. En DQE DataQ Settings → General, localice el campo Adresse de l'API DQE (este campo aparece etiquetado en francés de forma inesperada incluso en organizaciones en inglés/español — es un problema conocido de la etiqueta del producto, no un error suyo).
2. Introduzca la URL proporcionada por su jefe 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 Standalone

La URL Standalone apunta a la aplicación DQE Standalone externa. 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 jefe de proyecto DQE.
3. Haga clic en Save & Close.
4. Vaya a la pestaña Standalone de la aplicación DQE para comprobar 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 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 CORS y de firewall permiten el acceso desde las redes de los usuarios de Dynamics.

2.5 Credenciales Standalone

Para conectar la aplicación Standalone a su entorno de Dynamics 365, debe añadir una credencial de Dynamics directamente dentro de la interfaz Standalone. Estas credenciales las proporciona su jefe 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 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 requeridos:

1. Haga clic en Log In. El servidor Standalone se autentica frente a Dynamics y guarda 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 el Power Platform admin center.

Una vez configurado el paquete, continúe con la configuración de cada webservice individualmente en el editor de formularios. Consulte Configure address, email, phone and B2B validation in Dynamics.