Configure Dataverse Healthcare APIs
Este artículo proporciona una guía paso a paso para configurar las Dataverse Healthcare APIs.
Conceder acceso a una aplicación de Azure al entorno de Dataverse
El primer paso para habilitar el acceso a Dataverse Healthcare APIs es otorgar un permiso de aplicación de Azure al entorno de Dataverse. Estos pasos le guiarán a través de la configuración de un registro de aplicación en Azure y luego le otorgarán acceso a esa aplicación en Dataverse mediante la configuración de un usuario de aplicación.
Registrar una aplicación en la plataforma de identidad de Microsoft. Después de configurar el registro de la aplicación, asegúrese de capturar el ID de la aplicación/cliente.
En el centro de administración de Power Platform, seleccione su entorno de Dataverse.
En el panel de acciones, seleccione Configuración.
En Usuarios + permisos, seleccione Usuarios de la aplicación.
En el panel de acciones, seleccione Nuevo usuario de aplicación.
En el panel que se abre, seleccione Agregar una aplicación.
Busque usando su id. de aplicación/cliente, seleccione su aplicación y luego seleccione Agregar.
Seleccione su Unidad de negocio.
Seleccione el rol de seguridad Usuario de registro de la aplicación Administración de sincronización para FHIR y luego seleccione Guardar.
Seleccione Crear.
Configurar las opciones de integración
Las configuraciones de integración del kit de herramientas de integración de datos le ofrecen acceso a las variables de entorno de Dataverse que puede usar para configurar las API de atención médica de Dataverse.
Con soporte de reescritura, puede configurar mapas de entidades para registros de Dataverse que se volverán a escribir en el servidor remoto. Después de la configuración, los nuevos registros creados en Dataverse, o registros creados con las Dataverse Healthcare APIs entrantes se pueden actualizar y publicar en el punto de conexión remoto.
Además de los pasos de configuración, la siguiente sección también describe los ajustes de integración necesarios para conectarse al punto de conexión remoto para eventos de reescritura. Para obtener acceso a la configuración de integración en el kit de herramientas de integración de datos:
Inicie sesión en Microsoft Power Apps.
En el panel Entornos, seleccione el entorno donde implementó el kit de herramientas de integración de datos.
En el panel izquierdo, seleccione Aplicaciones, y después seleccione Kit de herramientas de integración de datos.
En Configuración de la aplicación, seleccione Configuración de integración y luego seleccione Dataverse Healthcare API.
Establezca las variables con valores para el entorno.
Los ajustes para las Dataverse Healthcare API se clasifican en las dos secciones siguientes:
- Configuración general: cubre la configuración de registro e ingesta.
- Configuración de reescritura: cubre los ajustes de conectividad y reintentos para el punto de conexión de reescritura remota.
Configuración general
La siguiente tabla describe la configuración general de las variables de entorno:
| Nombre | Descripción | valor |
|---|---|---|
| Nivel de registro | Controla el nivel de información registrada en Dataverse tanto para Dataverse Healthcare API de entrada y para los eventos de reescritura. De manera predeterminada, el valor se establece como Deshabilitado. Para obtener más información, vaya a Revisar registros de Dataverse Healthcare API. |
Utilice uno de los siguientes valores: Solo información: detalles de registro marcados como información. Solo advertencia: detalles de registro marcados como advertencia. Solo excepción: detalles de registro marcados como error o excepción. Detalles: registra todos los detalles. Deshabilitado: deshabilita el registro. |
| Límite de tamaño de la agrupación de FHIR para upsert | Número máximo de recursos de una agrupación. De forma predeterminada, el valor es 100. | Usa un valor de 1 a 500 para controlar el número máximo de recursos en un paquete válido. Si el tamaño del paquete supera el límite configurado, la API del paquete upsert responde con un error. |
Configuración de reescritura
Los mensajes de reescritura se pueden publicar en un punto de conexión alternativo en lugar del servicio FHIR, como una aplicación lógica de Azure o una función de Azure que admita la autorización abierta (OAuth). La configuración de escritura diferida le permite proporcionar detalles de conexión para el punto de conexión FHIR y un punto de conexión de salida alternativo (si está disponible) para los mensajes enviados. Necesita los valores del servicio FHIR para la validación y para construir los mensajes FHIR salientes. Estos valores de conexión son opcionales y, si se proporcionan, los mensajes se publican como un paquete FHIR a este punto de conexión.
Las siguientes secciones describen la configuración de las variables de entorno para la configuración de la solución de reescritura. Puede seleccionar qué valores configurar según su escenario de uso.
Configuración de servicio de FHIR
Estas configuraciones constituyen las configuraciones específicas de un servicio FHIR, como un servicio de FHIR de Azure Health Data Services.
| Nombre | Descripción | valor |
|---|---|---|
| Id. de aplicación/cliente | El ID de usuario de registro de la aplicación configurado para el servicio de FHIR al que se conecta el servicio de reescritura. | Id. de usuario de registro de la aplicación (GUID) |
| Secreto de cliente | El secreto del cliente asociado con el ID de usuario de registro de la aplicación. Nota: Por seguridad, no puede usar las herramientas de administración para acceder al valor secreto del cliente después de guardarlo. |
Secreto de cliente (cadena) |
| Recurso | La cadena de recurso o alcance del servicio de FHIR utilizado para adquirir el token de autenticación. Para el servicio de FHIR de Azure Health Data Services, este valor suele ser el mismo que la URL del punto de conexión. |
Cadena o URL con el formato adecuado |
| Dirección URL base de punto de conexión | La URL del servicio de FHIR al que se conecta el servicio de reescritura. | URL con el formato correcto |
| URL de autoridad | La URL del proveedor de autoridad OAuth, incluido el Id. del inquilino. El servicio de reescritura utiliza esta URL para adquirir el token de autenticación para el Id. y el secreto del cliente determinados. | URL con el formato correcto |
Ajustes de punto de conexión de salida alternativo
Estos ajustes constituyen la configuración específica de un punto de conexión de escritura alternativo, como una aplicación lógica. El punto de conexión saliente alternativo debe admitir la autenticación a través de OAuth 2.0 mediante un Id. de cliente y un secreto de cliente y deberían configurarse con un desencadenador HTTP.
| Nombre | Descripción | valor |
|---|---|---|
| Id. de aplicación/cliente | El id. de usuario de registro de la aplicación configurado para el punto de conexión remoto al que se conecta el servicio de reescritura. | Id. de usuario de registro de la aplicación (GUID) |
| Secreto de cliente | El secreto del cliente asociado con el ID de usuario de registro de la aplicación. Nota: Por seguridad, no puede usar las herramientas de administración para acceder al valor secreto del cliente después de guardarlo. |
Secreto de cliente (cadena) |
| Recurso | La cadena de recurso o alcance del servicio del punto de conexión remoto utilizado para adquirir el token de autenticación. Para el servicio de FHIR de Azure Health Data Services, este valor suele ser el mismo que la URL del punto de conexión. | Cadena o URL con el formato adecuado |
| Dirección URL base de punto de conexión | La URL del punto de conexión remoto al que se conecta el servicio de reescritura. | URL con el formato correcto |
| URL de autoridad | La URL del proveedor de autoridad OAuth, incluido el Id. del inquilino. El servicio de reescritura utiliza esta URL para adquirir el token de autenticación para el Id. y el secreto del cliente determinados. | URL con el formato correcto |
Importante
Cuando utilice un punto de conexión alternativo, como una función Azure o una Logic App, asegúrese de configurar el punto de conexión con un desencadenador de HTTP. Cuando el servicio de escritura diferida publica en esta ubicación, también envía un paquete FHIR que contiene el recurso FHIR que se crea o actualiza y un mensaje de procedencia FHIR.
El servicio de escritura diferida espera un paquete de retorno que contenga respuesta del servicio FHIR remoto como respuesta desde el punto de conexión FHIR remoto. Este respuesta es necesaria para actualizar el registro de Dataverse con el nuevo ID de la versión FHIR y los últimos valores modificados. Para ver ejemplos de respuestas esperadas, consulte Escritura diferida en un punto de conexión alternativo.
Configuración de reescritura general
| Nombre | Descripción | valor |
|---|---|---|
| Tiempo de espera máximo de reintento | El número máximo de minutos entre reintentos automáticos antes de que falle un mensaje. | Tiempo de espera de reintento (minutos) Valor predeterminado: 5 |
| Número máximo de reintentos | El número máximo de reintentos antes de fallar un mensaje. | Número de reintentos (recuento) Valor predeterminado: 3 |
| Id. de usuario de registro de la aplicación FHIR | El ID de usuario de registro de la aplicación configurado para el procesamiento de mensajes entrantes. Esta variable permite que el procesador de reescritura filtre los mensajes entrantes y evite el procesamiento circular. | Id. de usuario de registro de la aplicación (GUID) |
Configurar la ingesta de datos
Después de actualizar los ajustes de integración, puede publicar paquetes FHIR directamente en el punto de conexión de la API personalizada. O bien, puede implementar una aplicación lógica para ayudar a transmitir los datos entre Dataverse y el servicio de FHIR de Azure Health Data Services. Para obtener más información, consulte:
- Publique datos directamente en API de Dataverse Healthcare.
- Cree una Logic App mediante la configuración manual para sincronizar datos entre Dataverse API de atención médica y Azure Health Data Services.
- Implemente un grupo de aplicaciones lógicas utilizando una plantilla para orquestar la ingesta de paquetes FHIR en Dataverse API de atención médica y Azure Health Data Services.