mensajería hl7 v3 - e-salud - estrategia e-salud minsal · según especificación hl7 v3, un...

Mensajería HL7 V3

Mensajería ElectrónicaMensajería Electrónica

Características de la especificación de

mensajería HL7 V3

[HL7 V3]

Autor: Mario Enrique Cortés M.datasalud IT Ltda – Colombiamario.cortes@datasalud.net

Parte 2Parte 2

Características de HL7 v3Características de HL7 v3

Modelo de Información de Referencia.

Uso de sintaxis XML.

Énfasis en el uso de vocabularios controlados.

Metodología formal y uso de UML.

Las características de desarrollo de HL7 v3, hacen del mismo un estándar más específico y robusto.

Desarrollo de mensajeDesarrollo de mensaje

Cómo preparar un Cómo preparar un mensaje HL7 v3mensaje HL7 v3

Ingredientes:

RIM.

D-MIM.

R-MIM.

HMD.

CMETs.

Vocabularios.

OIDs.

Interacciones.

Evento disparador.

Estados.

Mezclar todo y presentar empleando sintaxis XML.

Preparar de acuerdo al escenario.

El RIM HL7El RIM HL7

Fuente: http://www.hl7.org/v3ballot/html/infrastructure/rim/Graphics/RIM_NormativeContent.gif

Las clases fundacionales Las clases fundacionales del RIMdel RIM

Del RIM a los mensajesDel RIM a los mensajes

Los casos de uso de interoperabilidad se agrupan en Dominios.

Modelo de información particular derivado del RIM.

Modelo gráfico D-MIM [Domain Message Information Model].

...Del RIM a los mensajes...Del RIM a los mensajes

De los D-MIM, se hacen refinamientos adicionales para construir modelos de información de mensajes.

Modelo gráfico R-MIM [Refined Message Information Model].

El R-MIM es una estructura de información que representa las necesidades de un conjunto de mensajes.

...Del RIM a los mensajes...Del RIM a los mensajes

Las descripciones jerárquicas de los mensajes HMD [Hierarchical Message Description] son la principal estructura normativa de los mensajes HL7 V3.

Son especificaciones exactas de los campos de un mensaje y su agrupación, secuencia, opcionalidad y cardinalidad.

Fuente: http://www.hl7.org/v3ballot/html/domains/uvor/editable/POOR_HD200999UV-NoEdit.htm

Proceso de refinamiento de Proceso de refinamiento de mensajes a partir del RIMmensajes a partir del RIM

Fuente: http://www.hl7.org/v3ballot/html/infrastructure/conformance/graphics/ConstraintCycle.gif

Fuente: http://www.hl7.org/v3ballot/html/infrastructure/conformance/graphics/ConstraintCycle2.gif

Lectura de modelos gráficos Lectura de modelos gráficos refinados a partir del RIMrefinados a partir del RIM

ACTOAtributo mandatorioAtributo opcional

ROLAtributo mandatorioAtributo opcional

ENTIDADAtributo mandatorioAtributo opcional

PARTICIPACIÓNAtributo mandatorioAtributo opcional

VÍNCULO ENTRE ACTOSAtributo mandatorioAtributo opcional

VÍNCULO ENTRE ACTOSAtributo mandatorioAtributo opcional

Punto de entradaIdentificaciónDescripción

Nota:

ACTO FOCAL

CARDINALIDAD

CARDINALIDAD

CARDINALIDAD

CARDINALIDAD

Entidad enmarcando Rol

Entidad desempeñando Rol

CARDINALIDAD

Elección entre Actos Elección entre RolesElección entre Entidades

CMET CMET CMET

Restricción

Elementos ComunesElementos Comunes

Los CMETs [Common Message Element Types].

Son fragmentos de mensajes o estructuras de elementos de datos reutilizables, que se emplean en diversos tipos de mensajes.

Por ejemplo, el Elemento Común “Persona”.

PERSONA IDENTIFICADA - CONFIRMABLEElemento Común de Mensaje

Vocabularios controladosVocabularios controlados

Son índices o listas pre-aprobadas de términos que se usan en un ámbito determinado y emplean un código de identificación para reducir la ambigüedad del lenguaje natural.

El uso de vocabularios controlados es fundamental en la construcción de mensajes HL7.

Las HMD sugieren vocabularios controlados para algunos elementos de dato.

Ver vocabularios empleados y sugeridos en HL7 V3

Identificadores Globales Identificadores Globales de Objetosde Objetos

OID [Object IDentifier].

Son atributos semánticos de algunos elementos del mensaje que permiten reducir la ambigüedad en el uso de vocabularios controlados o identificadores, a través de una raíz (root) que identifica de forma unívoca el sistema de codificación o identificación a nivel global.

Es una cadena única en el mundo compuesta por números y puntos.

De acuerdo con la norma ISO, los números delimitados por los puntos representan rutas en una estructura de árbol.

Las interaccionesLas interacciones

Son flujos de información en un sentido (dirección) que soporta una requerimiento de información expresado en un escenario.

Define:

Evento Disparador.

Capa de Transmisión.

Capa de Control de Actos.

Tipo de Mensaje.

Roles de Aplicación.

...Las interacciones...Las interacciones

Para facilitar la descripción de los escenarios suelen emplearse representaciones gráficas estándarizadas UML [Unified Modeling Language] como diagramas de actividades, casos de uso, etc.

En el caso de las secuencias de las interacciones se emplean los diagramas UML del mismo nombre.

Evento disparadorEvento disparador

Es un evento que cuando se registra en una aplicación, indica la necesidad de un flujo de información entre una o más aplicaciones.

Genera una o más interacciones.

Por ejemplo:

Una solicitud de Rayos X.

Una orden de requerimiento de servicios.

La obtención de un resultado de laboratorio.

EstadosEstados

Un estado el nombre de la condición de un mensaje o un acto.

Por ejemplo, una orden asumir el estado de “en proceso”, “suspendida”, “completa”, etc.

HL7 emplea la representación gráfica estandarizada UML para los diagramas de estado.

Uso de XMLUso de XML

eXtensible Markup Language.

Es un metalenguaje, simple pero estricto, que emplea una sintaxis de formato de texto basada en etiquetas.

XML juega un papel fundamental en el intercambio de una gran variedad de datos. Y por ello ha sido adoptado por varios estándares de intercambio electrónico de datos, entre ellos HL7 V3.

...Uso de XML...Uso de XML

Se asume que los asistentes al curso ya está familiarizados con la tecnología XML.

Como introducción a XML se recomiendan los siguientes documentos:

En inglésXML 1.1

XML SchemaXML namespace

En españolXML en 10 puntosXML 1.0

Xpath 1.0

Esquema XML

Construcción de mensajesConstrucción de mensajes

Fuente: http://www.hl7.org/v3ballot/html/infrastructure/its_r2/its_r2Spec.htm#hl7cho

El nombre del mensajeEl nombre del mensaje

Está dado por el identificador (id) de la interacción.

Es el nombre del elemento raíz de la estructura XML

Ejemplo:

POOR_IN200901UV

PO = Dominios Clínicos Subsección Operaciones

OR = Dominio Ordenes

IN = Interacción [Interaction]

200901 = Número asignado por el CT

UV = Uso Universal

Mensajería ElectrónicaMensajería Electrónica

El dominio de Infraestructura de

transmisión

Dominio de Dominio de infraestructura de transmisióninfraestructura de transmisión

El estándar HL7 V3 cuenta con un dominio de infraestructura de transmisión, que aborda el entorno de las comunicaciones y es común para todas las implementaciones de mensajes.

Componentes de un Componentes de un mensaje HL7 v3mensaje HL7 v3

Según especificación HL7 V3, Un mensaje se compone de 2 partes:

Una capa o envoltorio (wrapper) de transmisión HL7 [Siempre]

El contenido de transmisión HL7 [Opcional]

El envoltorio de El envoltorio de transmisióntransmisión

Un envoltorio de transmisión HL7 (HL7 transmission wrapper) contiene información necesaria para el envío del mensaje.

Existen dos formas de envoltorio de transmisión:

Envoltorio de transmisión de mensaje.

Envoltorio de transmisión de lote (Batch).

Infraestructura de TransmisiónModelo de Información de Mensajes del Dominio D-MIM

Fuente: http://www.hl7.org/v3ballot/html/domains/uvci/editable/MCCI_DM000000UV.htm

Estructura del envoltorio Estructura del envoltorio de transmisiónde transmisión

Descripción Jerárquica:

Enlace a la versión html

Enlace a la versión Excel

Elementos del Elementos del envoltorio de transmisiónenvoltorio de transmisión

Id: Número de identificación del mensaje. MANDATORIO [1..1]

CreationTime: Fecha y hora de generación del mensaje. MANDATORIO [1..1]

SecurityText: Texto de seguridad (Atributo no especificado en la documentación del estándar HL7 V3). OPCIONAL [0..1]

ResponseModeCode: Código de modo de respuesta. MANDATORIO [1..1]

VersionCode: Código de la versión del estándar HL7, empleada en el mensaje. OPCIONAL [0..1]

InteractionId: Identificación del tipo de mensaje (segun la interacción) que se está empleando. MANDATORIO [1..1]

...Elementos del ...Elementos del envoltorio de transmisiónenvoltorio de transmisión

ProfileId: dentificador del perfil que restringe la transmisión. OPCIONAL [0..*]

ProcessingCode: Código de tratamiento para el procesamiento del mensaje. MANDATORIO [1..1]

ProcessingModeCode: Código de definición de modo de procesamiento del mensaje. MANDATORIO [1..1]

AcceptAckCode: Código de condicionamiento de respuestas ACK. MANDATORIO [1..1]

SequenceNumber: Indice del mensaje en una secuencia. OPCIONAL [0..1]

Receiver: Set de datos de información del receptor. MANDATORIO [1..1]

...Elementos del ...Elementos del envoltorio de transmisiónenvoltorio de transmisión

RespondTo: Set de datos de localización para la respuesta (ACK). OPCIONAL [0..*]

Sender: Set de datos de información del emisor. MANDATORIO [1..1]

Device: Set de datos del sistema emisor/receptor del mensaje. MANDATORIO [1..1]

AsAgent: (ROL) Set de datos de la organización a la cual representa el emisor/receptor del mensaje. OPCIONAL [0..1]

RepresentedOrganization: (Entidad) Set de datos de la organización a la cual representa el emisor/receptor del mensaje. OPCIONAL [0..1]

AsLocatedEntity: (ROL) Set de datos de la entidad localizada a la cual representa el emisor/receptor del mensaje. OPCIONAL [0..*]

...Elementos del ...Elementos del envoltorio de transmisiónenvoltorio de transmisión

Location: (Entidad) Set de datos de la entidad localizada a la cual representa el emisor/receptor del mensaje. OPCIONAL [0..1]

AttentionLine: Set de datos de parámetros adicionales de transmisión. OPCIONAL [0..*]

Attachment: Set de datos adjuntos. OPCIONAL [0..*]

Vocabularios controlados Vocabularios controlados usados en el envoltorio de usados en el envoltorio de transmisióntransmisión

Modo de respuesta: Especifica el modo (inmediato, diferido o en cola) en que el receptor deberá comunicar su respuesta (ACK)

ResponseMode.

OID 2.16.840.1.113883.19.5.1

Versión del estándar HL7: Determina la versión de la especificación que se ha empleado en el mensaje.

HL7StandardVersionCode

OID 2.16.840.1.113883.5.1092

Tratamiento del mensaje: Especifica si el mensaje se trata de una interacción en producción, de depuración o entrenamiento.

ProcessingID

OID 2.16.840.1.113883.5.100

...Vocabularios controlados ...Vocabularios controlados usados en el envoltorio de usados en el envoltorio de transmisióntransmisión

Modo de procesamiento: Especifica el modo de procesamiento del mensaje.

ProcessingMode

OID 2.16.840.1.113883.5.101

Condicionamiento de respuesta: Determina cuando debe emitirse una respuesta (ACK). Siempre, Nunca, Únicamente cuando hay error.

AcknowledgementCondition

OID 2.16.840.1.113883.5.1050

Ejemplo de envoltorio de Ejemplo de envoltorio de transmisióntransmisión

Ver ejemplo adjunto del envoltorio de transmisión.

El contenido de El contenido de transmisióntransmisión

El contenido de transmisión HL7 consta de 2 partes:

Un “Acto de control del evento disparador”. (Requerido para todos los mensajes excepto los ACK)

El “Contenido HL7 según el dominio” (Requerido para cada acto de control del evento disparador).

Infraestructura del Acto de ControlModelo de Información de Mensajes del Dominio D-MIM

Fuente: http://www.hl7.org/v3ballot/html/domains/uvai/editable/images/MCAI_DM700200UV.png

Infraestructura del Acto de ControlModelo Refinado de Información de Mensajes R-MIM

Fuente: http://www.hl7.org/v3ballot/html/domains/uvai/editable/images/MCAI_RM700200UV.png

Estructura de la capa de Estructura de la capa de acto de controlacto de control

Descripción Jerárquica:

Enlace a la versión html

Enlace a la versión Excel

Elementos de la Elementos de la capa de acto de controlcapa de acto de control

controlActProcess: Set de datos del acto de control de proceso. MANDATORIO [1..1]

Id: Identificación del acto. OPCIONAL [0..*]

Code: Código del evento disparador. OPCIONAL [0..1]

Text: Texto descriptivo del acto. OPCIONAL [0..1]

EffetiveTime: Fecha y hora del acto de control. OPCIONAL [0..1]

PriorityCode: Código de prioridad del acto de control. OPCIONAL [0..*]

ReasonCode:Código de razón o justificación del acto de control. OPCIONAL [0..*]

...Elementos de la ...Elementos de la capa de acto de controlcapa de acto de control

LanguageCode: Código de lenguaje del mensaje. Valor por defecto “es-co”. OPCIONAL [0..1]

Overseer: Set de datos del supervisor del acto. OPCIONAL [0..*]

AuthorOrPerformer: Set de datos del autor del acto. OPCIONAL [0..*]

DataEnterer: Set de datos del transcriptor o digitador de la información del acto. OPCIONAL [0..*]

InformationRecipient: Set de datos de la persona receptora del mensaje. OPCIONAL [0..*]

Subject: Set de datos del asunto del mensaje. Contiene la estructura de datos específica de acuerdo al dominio del mensaje. OPCIONAL [0..*]

Vocabularios controlados Vocabularios controlados usados en la capa de usados en la capa de acto de controlacto de control

Código del evento disparador: Especifica el evento disparador de la interacción.

TriggerEventID.

OID 2.16.840.1.113883.1.18

Código de prioridad: Especifica la prioridad del acto.

ActPriority.

OID 2.16.840.1.113883.5.7

Código de Justificación: Especifica la razón o justificación del acto.

ActReason.

OID 2.16.840.1.113883.5.8

...Vocabularios controlados ...Vocabularios controlados usados en la capa de usados en la capa de acto de controlacto de control

Código de lenguaje : Especifica el lenguaje en que está escrito el mensaje.

HumanLanguage

OID 2.16.840.1.113883.1.11.11526

Código de modalidad : Especifica la modalidad de ejecución del acto.

ParticipationMode

OID 2.16.840.1.113883.5.1064

Código de signatura : Especifica el estado del mensaje con respecto al uso de la firma.

ParticipationSignature

OID 2.16.840.1.113883.5.89

...Vocabularios controlados ...Vocabularios controlados usados en la capa de usados en la capa de acto de controlacto de control

Código tipo de entidad : Especifica el tipo de entidad de acuerdo a una clasificación previa.

OrganizationEntityType

OID 2.16.840.1.113883.1.11.19608

Código de estado de entidad : Especifica el estado de la entidad.

EntityStatus

OID 2.16.840.1.113883.5.1061

Código CIIU : Especifica la clasificación industrial de una organización de acuerdo a la codificación internacional aceptada en Colombia.

CIIU

OID 2.16.840.1.113883.1.11.16039

...Vocabularios controlados ...Vocabularios controlados usados en la capa de usados en la capa de acto de controlacto de control

Código tipo de cobertura : Especifica el tipo de rol de cobertura de salud.

CoverageSponsorRoleType

OID 2.16.840.1.113883.1.11.19877

Código de estado del rol : Especifica el estado de un rol.

RoleStatus

OID 2.16.840.1.113883.5.1068

Código postal : Especifica el código postal para las localizaciones dentro del territorio Colombiano.

PostalCode

...Vocabularios controlados ...Vocabularios controlados usados en la capa de usados en la capa de acto de controlacto de control

Código de país : Especifica un país de acuerdo a la codificación ISO alfanumérica de 2 caracteres.

ISO 3166-1 alfa-2

OID 1.0.3166.1

Código de lugar : Especifica el tipo de lugar de una localización (cama, habitación, piso, edificio, etc).

PlaceEntityType

OID 2.16.840.1.113883.1.11.16100

Código DIVIPOLA : Especifica división político administrativa en Colombia (departamento, municipio).

DIVIPOLA DANE

CMETs del acto de controlCMETs del acto de control

Persona Asignada: Es un Rol que desempeña una persona, que le ha sido asignado por una entidad del tipo organización.

R_AssignedPerson universal

COCT_MT090300UV01

Dispositivo Asignado: Es un Rol desempeñado por una máquina o dispositivo, que funciona al interior o para una entidad del tipo organización.

R_AssignedDevice universal

COCT_MT090300UV01

PERSONA ASIGNADA UNIVERSALModelo Gráfico del Elemento Común del Mensaje

Fuente: http://www.hl7.org/v3ballot/html/domains/uvct/editable/images/COCT_RM090100UV.png

DISPOSITIVO ASIGNADO UNIVERSALModelo Gráfico del Elemento Común del Mensaje

Fuente: http://www.hl7.org/v3ballot/html/domains/uvct/editable/images/COCT_RM090300UV.png

Ejemplo de capa de acto Ejemplo de capa de acto de controlde control

Ver ejemplo adjunto de la capa de acto de control.

El contenido HL7 El contenido HL7 según el dominiosegún el dominio

Es el fragmento del mensaje que contiene la información específica de acuerdo a un dominio que satisface un caso de uso específico de mensajería HL7.

RevisiónRevisión

Ya sabemos:

Qué es el estándar de mensajería HL7 v3.

Cuáles son los ingredientes que se emplean en el diseño de mensajes HL7 v3.

Cómo representar un mensaje en sintaxis XML.

Cuáles son las capas (envoltorios) de un mensaje.

Qué son las capas de transmisión y acto de control.

En la siguiente presentación entraremos en el detalle de la capa de contenido del mensaje.

Gracias por tomarse el tiempo para Gracias por tomarse el tiempo para aprender más acerca de HL7.aprender más acerca de HL7.

Para más información visite: hl7.org.co

Material en idioma español, para uso de la comunidad

HL7 Iberoamericana.[2009]

HL7 en Español es una red de trabajo cuyos objetivos son:Publicar y compartir información y contenido en idioma español o castellano.Extender el uso del estándar a todos los países de la región.Comunicar proyectos e iniciativas relacionadas con el uso de los estándares HL7 en los países de Iberoamérica.

HL7 Argentina

http://www.hl7argentina.org.ar/

HL7 Chile

http://www.hl7chile.cl/

HL7 Colombia

http://www.hl7.org.co/

HL7 España

http://www.hl7spain.org

HL7 México

http://personales.com/mexico/mexico/hl7mexico/

HL7 Uruguay

http://www.sueiidiss.org/

Derechos de usoDerechos de uso

Nada en esta licencia menoscaba o restringe los derechos morales del autor.

Queda permitida la reproducción total o parcial de los textos contenidos en este documento, excepto en caso de publicaciones con ánimo de lucro o por voluntad explícita del autor.

Al reutilizar o distribuir la obra, tiene que dejar bien claro los términos de la licencia de esta obra.

Alguna de estas condiciones puede no aplicarse si se obtiene el permiso del titular de los derechos de autor.

El reconocimiento del autor no debe hacerse de una manera que sugiera que tiene su apoyo o apoya el uso que hace de su obra.

Material educativo.

Esta presentación es una publicación del Comité Técnico de órdenes y resultados de laboratorio de la Fundación HL7 Colombia, como fuente de consulta, para uso de la comunidad de HL7 en Iberoamérica.

LA OBRA ESTÁ PROTEGIDA POR DERECHOS DE AUTOR Y/U OTRAS LEYES APLICABLES. QUEDA PROHIBIDO CUALQUIER USO QUE SE HAGA DE LA OBRA QUE NO CUENTE CON LA AUTORIZACIÓN PERTINENTE DE CONFORMIDAD CON LOS TÉRMINOS DE ESTA LICENCIA Y DE LA LEY DE DERECHO DE AUTOR.

USTED ES LIBRE DE COPIAR, DISTRIBUIR Y COMUNICAR PÚBLICAMENTE ESTA OBRA, PARA USO NO COMERCIAL.

No alterar los contenidos: Si distribuye esta obra, no debe alterarla ni realizar cambios sin el consentimiento explícito del autor.

Compartir bajo la misma licencia: Si genera una obra derivada, sólo puede distribuir la obra generada bajo una licencia idéntica a ésta.

Reconocimiento: Debe reconocer los créditos de la obra de la manera especificada por el autor, mencionando título, nombre del autor, correo electrónico del autor y como fuente: Mensajería Electrónica Parte 2, Características de la especificación de mensajería HL7 V3 .