Preguntas frecuentes sobre el servicio FHIR de datos de dispositivos

Utilice estas preguntas frecuentes para comprender cómo DDFS admite datos de dispositivos como recursos FHIR, cómo se relaciona con la plataforma IoT y cómo solucionar problemas comunes del flujo de trabajo de desarrollo.

Patrones de consulta y datos de FHIR

¿Cómo recuperan las aplicaciones los dispositivos asociados a un paciente?

Utilice el recurso DeviceAssociation de FHIR R6. Busque recursos DeviceAssociation mediante el parámetro de búsqueda patient o subject. Para una asociación paciente-dispositivo, represente al paciente en DeviceAssociation.subject. La API de DDFS actual no muestra un parámetro de búsqueda focus. Consulte Device Association.

¿Cómo recuperan las aplicaciones los datos de dispositivos de un paciente?

Los datos del dispositivo se representan como recursos FHIR Observation. Utilice la operación de búsqueda de observación para buscar por parámetros soportados, como category, code, date, device, encounter, patient y status.

¿Qué punto final de FHIR debo utilizar?

FHIR R6 es la versión recomendada para las nuevas integraciones. Los puntos finales de FHIR R4 también están soportados para flujos de trabajo que requieren compatibilidad con R4. Debido a que los recursos y capacidades soportados difieren entre versiones, revise la documentación específica de la versión antes de seleccionar un punto final.

¿Pueden las aplicaciones enviar valores de dispositivo no verificados o preliminares?

Sí. Las aplicaciones pueden crear observaciones con el estado FHIR adecuado. Representar el estado de verificación a través de Observation.status, como cambiar una observación de preliminary a final, según el flujo de trabajo de la aplicación.

¿Puede DDFS actualizar una observación después de que se haya escrito?

Sí. Las aplicaciones pueden actualizar un recurso de observación, por ejemplo, para cambiar Observation.status.

¿Cómo deben obtener los consumidores las diferencias o actualizaciones de DDFS?

Utilice el recurso Subscription de FHIR. DDFS admite la suscripción y el patrón previsto es crear una suscripción para que DDFS pueda enviar actualizaciones en función de los eventos o cambios solicitados en esa suscripción.

¿El DDFS elimina los datos preliminares?

Las aplicaciones gestionan el ciclo de vida de observación definiendo Observation.status y utilizando operaciones de actualización o supresión soportadas cuando un flujo de trabajo requiere un cambio.

¿Aplica DDFS la lógica de negocio de asociación de dispositivos, el manejo de colisiones o las reglas de un solo dispositivo a un solo paciente?

Nº DDFS expone el recurso DeviceAssociation, pero las aplicaciones son responsables de las reglas de asociación clínica, desasociación y colisión.

¿Deben las aplicaciones cliente de HCE duplicar los recursos Paciente, Episodio clínico y Ubicación en DDFS?

DDFS es un servidor FHIR. Las aplicaciones pueden decidir la cantidad de información de paciente, episodio clínico y ubicación que necesitan escribir. Los modismos FHIR, como los perfiles y las etiquetas, deben utilizarse para la interoperabilidad. Los equipos de HCE pueden optar por enviar Id. de cliente de HCE con información de asociación de dispositivos en lugar de replicar completamente todos los datos clínicos, según su flujo de trabajo.

Integración y flujo de datos de IoT

¿Cuál es la relación entre DDFS y la plataforma IoT?

DDFS y la plataforma IoT son plataformas independientes. IoT es una forma en que los datos pueden llegar a DDFS, pero esa ruta de transporte no debe ser relevante para los consumidores de HCE. Desde la perspectiva de la HCE, los datos de los dispositivos residen en DDFS, y la HCE debe conectarse a DDFS en lugar de directamente a IoT. La forma en que se transportan los datos a DDFS debe eliminarse de la HCE.

DDFS ya admite API POST mediante la implementación del estándar FHIR, que permite a sistemas como IoT publicar recursos FHIR en DDFS.

¿Cómo puede un sistema ascendente enviar datos a DDFS?

Las aplicaciones pueden utilizar las API de FHIR de DDFS para crear recursos de FHIR soportados. Un sistema ascendente, como una plataforma o un gateway de IoT, debe enviar solicitudes FHIR válidas al punto final de FHIR de DDFS adecuado. Para conocer los recursos admitidos y los requisitos de solicitud, consulte la documentación de la API de DDFS específica de la versión.

¿Proporciona DDFS una API POST para IoT?

Sí. DDFS implementa el estándar FHIR y puede aceptar POST de recursos FHIR. Para los flujos de trabajo de dispositivos, esto normalmente significa que los sistemas pueden publicar recursos como Observation, Device, DeviceAssociation, Patient, Encounter, Location y Provenance cuando esos recursos son necesarios para el flujo de trabajo.

¿Qué tipos de datos maneja IoT en comparación con DDFS y FHIR?

IoT maneja la telemetría del dispositivo y los datos del dispositivo operativo. Esto puede incluir mediciones de dispositivos raw o normalizados, eventos de dispositivos, alarmas, metadatos de gateway, identificadores de dispositivos, registros de hora de mensajes y otros detalles de nivel de transporte. La plataforma IoT recopila y enruta los datos emitidos por los dispositivos.

DDFS gestiona los datos sanitarios representados como recursos FHIR. Las mediciones de dispositivos se pueden representar como recursos de observación FHIR y se pueden vincular al contexto clínico, como Paciente, Episodio clínico, Dispositivo, Asociación de dispositivos, Ubicación, Profesional asistencial, Organización, Solicitud de servicio, Procedencia, Muestra e Informe de diagnóstico.

En resumen, IoT está orientado a mensajes y telemetría, mientras que DDFS está orientado a FHIR y recursos clínicos. La HCE debe consumir datos de dispositivos de DDFS mediante las API de FHIR soportadas. La ingesta de telemetría de dispositivos está fuera de este flujo de trabajo de la API de FHIR.

¿Cómo se manejan los pacientes, los episodios clínicos, los dispositivos y las particiones?

IoT puede particionar o enrutar datos por dispositivo, gateway, inquilino, tema, región, entorno o tiempo. DDFS y FHIR organizan los datos en torno a recursos clínicos y referencias, como Paciente, Episodio clínico, Dispositivo, Asociación de dispositivos, Ubicación y Observación. Las referencias de paciente y episodio clínico son las que hacen que una medición de dispositivo sea clínicamente significativa para la HCE.

La aplicación que crea recursos FHIR es responsable de proporcionar las referencias de paciente y episodio clínico adecuadas a su flujo de trabajo.

¿DDFS se integra directamente con relojes inteligentes o controladores específicos del dispositivo?

Nº DDFS expone las API de FHIR y no proporciona controladores o integraciones específicas del dispositivo. Los dispositivos, las aplicaciones, las puertas de enlace u otros sistemas se integran con DDFS mediante el envío de solicitudes compatibles con FHIR.

Preguntas sobre la autenticación y la autorización

¿Cómo puedo configurar la autenticación OAuth para el servicio de FHIR de datos de dispositivo (DDFS)?

DDFS utiliza dominios de identidad de OCI para emitir tokens de acceso de OAuth y validar JWT. En los dominios de identidad de OCI, configure un servidor de recursos protegido, defina los ámbitos system/... de FHIR de DDFS en el servidor de recursos y otorgue los ámbitos con prefijo ddfs necesarios a la aplicación cliente. DDFS no expone puntos finales de configuración de autorización, token o autenticación. Para obtener más información, consulte Crear aplicación integrada y Referencia de autenticación de DDFS.

¿Cómo puedo configurar una aplicación cliente para llamar a las API de DDFS?

Utilizar una aplicación cliente confidencial de dominios de identidad de OCI para integraciones de servidor. Siga el procedimiento de aplicación integrada para configurar la autenticación de cliente y proteger las credenciales y el material de clave privada utilizado por ese método. Otorgue al cliente solo los ámbitos de recursos de DDFS necesarios para su flujo de trabajo, solicite los ámbitos fijos con prefijo ddfs en la solicitud de token y almacene o rote las credenciales del cliente según su estándar de seguridad. Para obtener más información, consulte Creación de una aplicación integrada y Mejores prácticas de seguridad.

¿Por qué se muestran los ámbitos de OAuth de DDFS con y sin el prefijo ddfs ?

Las definiciones de ámbito de servidor de recursos de DDFS utilizan el formato canónico, como system/Device.rs. Los permisos de cliente y las solicitudes de token utilizan el formato fijo con prefijo ddfs, como ddfssystem/Device.rs. La reclamación scope del token emitido contiene la forma canónica, como system/Device.rs. El prefijo de ámbito es independiente del público del token. Para obtener más información, consulte Referencia de autenticación y autorización de DDFS.

¿Cómo puedo restringir el acceso a la API de DDFS con ámbitos con parámetros?

DDFS soporta ámbitos system/... restringidos agregando criterios de búsqueda de estilo FHIR soportados después de ?. Por ejemplo, un permiso de lectura y búsqueda de dispositivo puede estar limitado por el fabricante con system/Device.rs?manufacturer=Example. Defina ámbitos restringidos sin el prefijo ddfs orientado al cliente en el servidor de recursos DDFS y solicite el formulario con prefijo ddfs desde la aplicación cliente. No modele el acceso a la API de DDFS con ámbitos patient/... no admitidos o restricciones de ámbito _id o identifier del paciente, a menos que la documentación de DDFS muestre explícitamente esa restricción como admitida. Para obtener más información, consulte Autenticación y autorización de DDFS.

¿Por qué se rechaza mi token de acceso DDFS para el acceso a la API de FHIR?

DDFS rechaza los tokens que no coinciden con el emisor esperado, el emisor del inquilino, el público, el tipo de asunto o los formularios de ámbito admitidos. Los tokens de acceso FHIR deben contener los ámbitos de recursos canónicos admitidos system/... que requiere la solicitud. Los permisos de cliente y las solicitudes de token utilizan el formato con prefijo ddfs correspondiente. Para obtener más información, consulte Autenticación y autorización de DDFS y Solución de problemas.

¿Cómo puedo otorgar permiso para operaciones de eliminación directa de DDFS?

Las rutas de supresión de datos y depuración de DDFS requieren dos ámbitos en el token del emisor de llamada: el ámbito de supresión de datos personalizado canónico y un ámbito de supresión de recursos canónico coincidente, como system/Patient.d. Otorgue y solicite el ámbito de recurso correspondiente con el prefijo fijo, como ddfssystem/Patient.d. El ámbito de supresión estricta personalizado por sí solo no es suficiente y un ámbito de supresión normal por sí solo no permite $hardDelete ni $purgeDeleted. Para obtener más información, consulte Referencia: Depuración de estado de suscripción, Supresión estricta y Supresión eliminada.

Preguntas de suscripción

¿Cómo puedo crear un tema de suscripción R6 en DDFS?

Cree un FHIR R6 SubscriptionTopic con un recurso de disparador soportado y criterios de estilo FHIR válidos. DDFS necesita que la URL del tema sea única entre los recursos SubscriptionTopic actuales y no suprimidos y valida los recursos disparadores, los criterios de consulta y los parámetros canFilterBy antes de aceptar el tema. Para obtener más información, consulte Crear tema de suscripción y Tema de suscripción.

¿Por qué falló la validación de mi SubscriptionTopic de DDFS?

Un tema de suscripción de DDFS puede fallar la validación si su URL de tema ya está siendo utilizada por otro tema actual no suprimido, su recurso de disparador no está soportado, sus criterios de consulta no son válidos o no se admite un parámetro canFilterBy declarado para el recurso de disparador. DDFS devuelve un resultado de operación FHIR para recursos no admitidos o parámetros de búsqueda. Para obtener más información, consulte Tema de suscripción y Errores de OperationOutcome.

¿Cómo puedo crear una suscripción R6 en DDFS?

Cree un FHIR R6 Subscription con status definido en requested, un topic que se resuelva en un SubscriptionTopic existente, channelType definido en rest-hook y un punto final HTTPS enrutable públicamente que utilice el puerto 443. DDFS envía un establecimiento de comunicación de REST-hook y define el estado de suscripción en active si el establecimiento de comunicación se realiza correctamente. Para obtener más información, consulte Crear suscripción y Suscripción.

¿Por qué falló la validación de mi suscripción a DDFS?

Compruebe que la solicitud es un FHIR R6 Subscription válido, que su SubscriptionTopic de referencia existe y está activo y que la solicitud utiliza campos y operaciones de recursos soportados. Para conocer las referencias de flujo de trabajo y operación admitidas, consulte FHIR R6 Subscription Workflow.

¿Cómo puedo proteger un punto final de conexión REST de suscripción a DDFS?

Para la entrega de notificaciones autenticadas, utilice la extensión personalizada de OCI Vault de DDFS para hacer referencia a un secreto de autorización gestionado por el servidor. Consulte FHIR R6 Subscription OCI Vault Secret Extension.

¿Por qué se define el estado de mi suscripción a DDFS en Error después de la creación o actualización?

Un establecimiento de comunicación fallido cambia el estado de la suscripción a error. Utilice GET /api/fhir/r6-ballot4/Subscription/{rid}/$status para recuperar la información de estado de la suscripción. Una respuesta incorrecta a una notificación de evento posterior es un fallo de entrega y no es un nuevo resultado de establecimiento de comunicación.

Preguntas de eliminación y depuración

¿Cómo puedo eliminar de forma permanente un recurso FHIR suprimido temporalmente en DDFS?

Utilice primero la eliminación de FHIR estándar. Después de suprimir el recurso, un administrador autorizado puede llamar a POST /api/fhir/{r4|r6-ballot4}/{Resource}/{id}/$hardDelete para eliminar de forma permanente ese recurso suprimido. $hardDelete devuelve un resultado de operación de FHIR. Para obtener más información, consulte Escenario: Supresión, Depuración Suprimida y Supresión Fija y Referencia: Depuración Suprimida, Supresión Fija y Estado de suscripción.

Cómo depurar varios recursos de FHIR suprimidos en DDFS

Utilice POST /api/fhir/{r4|r6-ballot4}/{Resource}/$purgeDeleted para depurar los recursos suprimidos elegibles. Envíe before como Parameters.parameter.valueDateTime y limit opcional como Parameters.parameter.valueInteger en un cuerpo de solicitud de FHIR Parameters. La operación aplica el modelo de autorización de eliminación fija a cada candidato, devuelve un resultado de operación FHIR y limita limit a 50. Para obtener más información, consulte Referencia: Depuración de estado de suscripción, Supresión estricta y Supresión eliminada.

¿Por qué falló mi solicitud de eliminación o depuración de DDFS?

Una solicitud de supresión o depuración estricta de DDFS puede fallar si el recurso aún no se ha suprimido temporalmente, al token le falta el ámbito de supresión estricta personalizado, al token le falta el ámbito de supresión canónico coincidente system/... o un ámbito de supresión restringido no cubre el recurso candidato. Los permisos de cliente y las solicitudes de token utilizan el formulario ddfssystem/... correspondiente. Los fallos de autorización se rechazan antes de que se complete el comportamiento de depuración. Para obtener más información, consulte Referencia: Depuración y estado de operaciones y Referencia: errores de OperationOutcome.