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 primero lo 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 de Dataverse mediante la configuración de un usuario de la aplicación.
Registrar una aplicación de Azure. Después de configurar el registro de la aplicación, asegúrese de capturar la ID de la aplicación/cliente para los siguientes pasos.
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
El área de configuración de integración en el kit de herramientas de integración de datos le da acceso a variables de entorno de Dataverse que puede utilizar para configurar Dataverse Healthcare APIs.
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 disponibles 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 del registro marcados como información. Solo advertencia: detalles del registro marcados como advertencia. Solo excepción: detalles del registro marcados como error o excepción. Detallado: registre todos los detalles. Deshabilitado: desactiva 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
Esta colección de ajustes 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.
Los valores del servicio FHIR son necesarios para la validación y para construir los mensajes FHIR salientes. Si solo proporciona estos valores de conexión, los mensajes también se publican en este punto de conexión.
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). Estos valores son opcionales y, si se proporcionan, los mensajes se publican como un paquete FHIR.
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 tener acceso al valor del secreto del cliente utilizando las herramientas de administración 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 dirección URL 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.
| 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 tener acceso al valor del secreto del cliente utilizando las herramientas de administración después de guardarlo. |
Secreto de cliente (cadena) |
| Recurso | La cadena de recurso o ámbito 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 |
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.
Consulte también
¿Qué es Microsoft Cloud for Healthcare?
Descripción general del kit de herramientas de integración de datos
Descripción general de Dataverse Healthcare APIs
Vista general de escritura diferida de Dataverse Healthcare APIs
Usar las Dataverse Healthcare APIs