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.
Preguntas sobre recursos de API, búsqueda y solución de problemas
- ¿Cómo puedo comprobar qué recursos y API de FHIR de DDFS están soportados?
Utilice el punto final
metadatade FHIR de DDFS para detectar información de capacidad para las API soportadas. DDFS expone los recursos en/api/fhir/r4y/api/fhir/r6-ballot4según la familia de recursos. DDFS no expone puntos finales de configuración de autorización, token o autenticación. Para obtener más información, consulte Sentencias de capacidad.- ¿Qué es Device Data FHIR Service (DDFS)?
Device Data FHIR Service (DDFS) es un servicio nativo de OCI para flujos de trabajo de FHIR de datos de dispositivos. DDFS expone las API de FHIR para los recursos R4 y R6 compatibles para que los clientes de API puedan trabajar con datos de dispositivos, pacientes, observación y atención médica relacionada. Para obtener más información, consulte Device Data FHIR Service Overview.
- ¿Cómo puedo empezar a utilizar las API de Device Data FHIR Service (DDFS)?
Comience por confirmar la información de instancia y punto final de DDFS, configurar el acceso de OAuth a través de los dominios de identidad de OCI, comprobar el punto final de metadatos de FHIR para conocer las capacidades soportadas y, a continuación, utilizar la ruta de acceso de API R4 o R6 para el flujo de trabajo de recursos que necesita. Para obtener más información, consulte Introducción.
- ¿Cómo puedo crear una instancia de DDFS y encontrar los puntos finales de API?
Cree o seleccione la instancia de servicio DDFS en OCI y, a continuación, utilice los detalles de la instancia o la información de integración de desarrolladores para buscar las URL base de la API de FHIR. DDFS expone los puntos finales de FHIR con versiones en
/api/fhir/r4y/api/fhir/r6-ballot4según la familia de recursos. Para obtener más información, consulte FHIR Endpoints Reference.- ¿Cómo puedo comprobar qué recursos de R4 y R6 FHIR admite DDFS?
Utilice el punto final de metadatos de FHIR de DDFS y la documentación de recursos de R4 y R6 para confirmar la lista de recursos admitida. El soporte de recursos difiere según la versión de FHIR, por lo que debe consultar la documentación específica de la versión antes de crear una integración. Para obtener más información, consulte Recursos de FHIR R4, Recursos de FHIR R6 y Sentencias de capacidad.
- ¿Cómo puedo buscar recursos FHIR en DDFS?
Utilice el punto final de búsqueda R4 o R6 específico de la versión para el recurso y solo los parámetros de búsqueda soportados por DDFS para ese recurso. Compruebe en el punto final de metadatos o en la documentación de recursos los filtros soportados, el comportamiento de paginación y parámetros como
_county_total. Para obtener más información, consulte FHIR R4 Search y FHIR R6 Search.- ¿Cómo puedo buscar recursos de dispositivos en DDFS?
Use el punto final de búsqueda de dispositivo DDFS para la versión de FHIR que está llamando. Compruebe en la documentación del dispositivo los parámetros admitidos, como el identificador, el fabricante (
Device?manufacturer=Example), el modelo, el estado, el tipo y el comportamiento de asociación o paciente específico de la versión. Para obtener más información, consulte Device y Device R6.- ¿Cómo puedo usar R6 DeviceAssociation en DDFS?
Utilice R6
DeviceAssociationcuando su flujo de trabajo necesite representar una asociación entre un dispositivo y otro tema, como un paciente. Consulte la documentación de R6DeviceAssociationpara conocer los campos admitidos, el comportamiento de búsqueda y cómo se relaciona con los flujos de trabajo de dispositivo y observación. Para obtener más información, consulte Asociación de dispositivos.- ¿Cómo puedo buscar las observaciones DDFS y los datos del dispositivo?
DDFS admite búsquedas de observación por
patient,deviceyencounteren las superficies de la API R4 y R6. Consulte la documentación de la API específica de la versión para conocer todos los parámetros soportados. Para obtener más información, consulte Search Observations, FHIR R4 Observation y FHIR R6 Observation.- ¿Cómo puedo buscar recursos de procedencia en DDFS?
Utilice la documentación del recurso Provenance para la versión FHIR que está llamando para comprender los parámetros de búsqueda de Provenance soportados. La procedencia ayuda a los clientes a inspeccionar el origen, la autoría y los metadatos relacionados con la auditoría asociados con los recursos de FHIR. Para obtener más información, consulte FHIR R4 Provenance y FHIR R6 Provenance.
- ¿Cómo puedo buscar por rango de fechas en DDFS?
Utilice los parámetros de búsqueda de fecha FHIR admitidos con prefijos de fecha FHIR, como mayor o menor que, cuando el recurso de destino y el parámetro admiten la búsqueda de estilo de rango. Compruebe la documentación de recursos específica de la versión antes de depender de un filtro de intervalo de fecha o fecha de nacimiento. Para obtener más información, consulte Referencia: Parámetros de búsqueda soportados.
- ¿Cómo puedo solucionar los errores de validación de DDFS y las respuestas OperationOutcome?
DDFS devuelve respuestas
OperationOutcomede FHIR para muchos fallos de validación y reglas de negocio. Compruebe el código de estado HTTP, la gravedad del problema, el diagnóstico y los parámetros de consulta o carga útil de la solicitud para identificar si el problema es un JSON no válido, criterios de búsqueda no soportados, fallo de autorización o un conflicto de estado de recurso. Para obtener más información, consulte Reference: OperationOutcome Errors y FHIR Status Codes.- ¿Cómo puedo usar extensiones primitivas FHIR en DDFS?
Utilice la documentación y los ejemplos específicos de recursos para confirmar dónde DDFS admite extensiones FHIR y extensiones primitivas. El soporte de extensión primitiva puede variar según el recurso, el campo, el tipo de dato y la versión de FHIR, por lo que debe validar el recurso de destino antes de enviar el contenido de extensión. Para obtener más información, consulte Reference: Primitive Extensions.
- ¿Cómo puedo configurar el acceso específico del fabricante a los datos de dispositivo y observación en DDFS?
Configure el acceso del fabricante combinando la autorización de dominios de identidad de OCI, los ámbitos de recursos de DDFS, las búsquedas soportadas de dispositivo u observación y los flujos de trabajo de suscripción R6 cuando se necesiten notificaciones de eventos. Para los datos de dispositivo, utilice la búsqueda de fabricante soportada, como
Device?manufacturer=Example. Para las observaciones relacionadas, utilice solo los parámetros de búsqueda de observación admitidos; cuando sea necesario filtrar por fabricante, utilice el formulario de búsqueda encadenado documentado, comoObservation?device.manufacturer=Example, si se admite para la versión FHIR de DDFS. Evite los ámbitospatient/...no admitidos y las restricciones de ámbito_idoidentifierdel paciente para el acceso del fabricante. Utilice los ámbitos con menos privilegios y la documentación de API específica de la versión para los recursos a los que debe acceder el fabricante. Para obtener más información, consulte Scenario: Device Manufacturer Access Device and Patient Data for FHIR R4 + R6.- ¿Cómo puedo solucionar los fallos de solicitud de la API de DDFS?
Comience por comprobar la ruta de acceso del punto final, la versión de FHIR, los ámbitos y público de token de OAuth, los parámetros de búsqueda y recursos soportados, la validez de la carga útil de solicitud y el diagnóstico de estado HTTP o
OperationOutcome. El punto final de metadatos de DDFS y la documentación de recursos específicos de la versión pueden ayudar a confirmar si la operación está soportada. Para obtener más información, consulte Troubleshooting y FHIR Status Codes.
Patrones de consulta y datos de FHIR
- ¿Cómo recuperan las aplicaciones los dispositivos asociados a un paciente?
-
Utilice el recurso
DeviceAssociationde FHIR R6. Busque recursosDeviceAssociationmediante el parámetro de búsquedapatientosubject. Para una asociación paciente-dispositivo, represente al paciente enDeviceAssociation.subject. La API de DDFS actual no muestra un parámetro de búsquedafocus. 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, comocategory,code,date,device,encounter,patientystatus. - ¿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 depreliminaryafinal, 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
Subscriptionde 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.statusy 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,LocationyProvenancecuando 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 prefijoddfsnecesarios 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
ddfsen 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 prefijoddfs, comoddfssystem/Device.rs. La reclamaciónscopedel token emitido contiene la forma canónica, comosystem/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 consystem/Device.rs?manufacturer=Example. Defina ámbitos restringidos sin el prefijoddfsorientado al cliente en el servidor de recursos DDFS y solicite el formulario con prefijoddfsdesde la aplicación cliente. No modele el acceso a la API de DDFS con ámbitospatient/...no admitidos o restricciones de ámbito_idoidentifierdel 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 prefijoddfscorrespondiente. 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, comoddfssystem/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$hardDeleteni$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
SubscriptionTopiccon un recurso de disparador soportado y criterios de estilo FHIR válidos. DDFS necesita que la URL del tema sea única entre los recursosSubscriptionTopicactuales y no suprimidos y valida los recursos disparadores, los criterios de consulta y los parámetroscanFilterByantes 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
canFilterBydeclarado 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
Subscriptionconstatusdefinido enrequested, untopicque se resuelva en un SubscriptionTopic existente,channelTypedefinido enrest-hooky 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 enactivesi 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
Subscriptionválido, que suSubscriptionTopicde 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}/$hardDeletepara eliminar de forma permanente ese recurso suprimido.$hardDeletedevuelve 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}/$purgeDeletedpara depurar los recursos suprimidos elegibles. EnvíebeforecomoParameters.parameter.valueDateTimeylimitopcional comoParameters.parameter.valueIntegeren un cuerpo de solicitud de FHIRParameters. La operación aplica el modelo de autorización de eliminación fija a cada candidato, devuelve un resultado de operación FHIR y limitalimita 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 formularioddfssystem/...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.