Configuración de salida HL7v2

Enviar resultados a un EMR u otro sistema externo requiere una licencia EMR válida. Para obtener ayuda con la configuración de la salida HL7v2, póngase en contacto con Soporte técnico.

Abrir ajustes

Para configurar la salida HL7v2, abra la aplicación AGNES Connect y presione el ícono de Configuración en la parte inferior izquierda.

Seleccione el elemento respectivo

Busque y seleccione la entrada denominada Dispositivos.

Seleccione HL7v2

Busque y seleccione la entrada denominada HL7v2.

Editar configuración

Haga clic en la configuración para editar.

Aplicar o cancelar

Haga clic en Aplicar para guardar los cambios.

Presione ESC para cancelar sin guardar.

Configuración de HL7

Ajustes	Descripción
`enabled`	Establece en `true` para habilitar la salida HL7. Establece en `false` para desactivar la salida HL7.
`allowQuery`	Establece a `true` para habilitar las consultas del paciente.
`allowVitals`	Establece en `true` para permitir enviar instantáneas de vitales. Establece en `false` para bloquear el envío de instantáneas vitales.
`allowDocuments`	Establece en `true` para permitir el envío de documentos, tales como informes PDF y instantáneas de vídeo.
`allowedExtensions`	Lista de extensiones de archivo para permitir la exportación.
`destination`	Destinación de los mensajes vitales de HL7. Acepta una URI `mllp://`, `mllps://`, `http://`, `https://`, o `file://`.
`fileDestination`	Destinación de los mensajes del archivo HL7. Acepta una URI `mllp://`, `mllps://`, `http://`, `https://`, o `file://`.
`queryDestination`	Destination of HL7 patient info queries. Acepta una URI `mllp://`, `mllps://`, `http://`, o `https://`. Habilita la pestaña Búsqueda del paciente en AGNES cuando esté definida.
`receivingApplication`	Poland el campo “Recibiendo Aplicación” de todos los mensajes salientes de HL7.
`receivingFacility`	Poblan el campo “Recibir Instalaciones” de todos los mensajes salientes de HL7.
`rawFileUpload`	Establece en `true` para subir archivos sin un envoltorio HL7.
`requiredPatientFields`	Lista de campos que AGNES debería requerir antes de enviar mensajes HL7, tales como `patientId`, `firstName`, `lastName`, `middleInitial`, `birthDate`, y/o `sex`.
`timestampFormat`	Formato para la marca de tiempo. Por defecto es el estándar HL7v2.
`hl7_vitals_msg`	Configurar segmentos individuales de mensajes vitales. Puede anular valores en los segmentos `MSH`, `PID`, `OBR`, y `OBX`.
`hl7_document_msg`	Configurar segmentos de mensajes de documentos individuales. Puede anular valores en los segmentos `MSH`, `PID`, `OBR`, y `OBX`.
`queryPatientMessage`	Configurar los segmentos de las consultas salientes HL7. Puede anular valores en los segmentos `MSH` y `QPD`.

Consulta del paciente

Los usuarios pueden consultar una lista de pacientes de un EMR sobre HL7 si el sistema EMR lo admite. El usuario puede proporcionar una cadena de búsqueda parcial para limitar los resultados.

Extremo de consulta HL7

Una vez que se haya definido queryEndpoint , se habilitará la pestaña de búsqueda de pacientes en AGNES. Para habilitar la pestaña de búsqueda del paciente, defina la dirección del servidor a la que conectarse en la configuración HL7 como queryEndpoint. Una sección de QPD tendrá que definirse en la configuración de HL7 basada en la configuración del EMR conectado.

Permitir Consulta de Paciente

La funcionalidad de búsqueda en AGNES se habilita una vez que se define queryEndpoint. Esto se puede deshabilitar configurando allowQuery en falso.


        allowQuery: false

Copy to clipboard

Personalizar segmentos HL7

AGNES produce señales HL7v2 válidas y completas de forma predeterminada, pero algunos usuarios pueden desear datos adicionales o cambios en la salida. Los valores de cada segmento y cada campo en él pueden ser reemplazados usando la configuración hl7_vitals_msg (para observaciones de vitales discretas), hl7_documents_msg (para documentos), y queryPatientMessage (para consultas).

Para personalizar un segmento, agregue el código del segmento como clave bajo la configuración asociada del mensaje. A partir de ahí, los campos individuales se pueden personalizar utilizando su número con un guión bajo. Por ejemplo, _1 anulará el primer campo del segmento. Los campos anidados también se modifican siguiendo el mismo esquema. Los campos sólo serán sobreescritos si se especifica.

Como ejemplo, las siguientes configuraciones sólo se mayúsculas sobre el apellido del paciente al guardar observaciones:

Copy to clipboard


          hl7_vitals_msg:
  PID:
    _5:
      _0:
        _1: {{ patient.lastName.value.toUpperCase() }}

En algunos casos, un campo en un segmento HL7 puede tener un tipo de variable, como en el tercer campo del segmento QPD (“Parámetros de usuario”). En estos casos, AGNES permite definir la estructura del mensaje usando las teclas _def para definir estructuras personalizadas, para que el mensaje se adapte a las necesidades de la solicitud receptora. Por ejemplo, pasar parámetros de búsqueda de consultas definiendo el campo “Parámetros de usuario” del segmento QPD:

Copy to clipboard


          queryPatientMessage:
  QPD:
    _3:
      _0:
        _1:
          _def:
            dt: ST
            opt: R
            rep: 0
          _0: Status
        _2:
          _def:
            dt: ST
            opt: R
            rep: true
          _0: Active

Las claves _def deben contener las siguientes propiedades:

Propiedad	Descripción
`dt`	Tipo de datos HL7v2. Consulte el estándar HL7 para ver los valores válidos.
`desc`	Descripción del campo. No transmitido.
`opt`	Opcionalidad. `R` para requerido, `O` para opcional.
`rep`	Repetibilidad. `0` o `falso` para no repetir.

Variables de plantilla disponibles

Al reemplazar segmentos HL7 o calcular el punto final de la solicitud, las siguientes variables de plantilla están disponibles.

Variable	Devoluciones
`{{document.source}}`	Módulo AGNES que agregó el documento
`{{document.data}}`	Datos del documento
`{{document.timestamp}}`	Marca de tiempo del document con formato
`{{document.key}}`	Clave única asignada al documento
`{{document.ext}}`	Ampliación de documento
`{{document.filename}}`	Nombre de archivo del documento
`{{document.isValid}}`	Booleano
`{{document.mime}}`	MIME tipo de archivo
`{{document.thumbnail}}`	Ruta del archivo de miniatura utilizado
`{{document.editable}}`	Booleano
`{{patient.sex.value}}`	Sexo del paciente
`{{patient.patientId.value}}`	Identificación del paciente (no visible desde el portal)
`{{patient.middleInitial.value}}`	Inicial del segundo nombre del paciente
`{{patient.extra.value}}`	Campo adicional del paciente (no visible desde el portal) utilizado para pasar valores arbitrarios
`{{patient.birthDate.value}}`	Fecha de nacimiento del paciente
`{{patient.patientExternalId.value}}`	Identificación externa del paciente (visible para el usuario)
`{{patient.firstName.value}}`	Nombre
`{{patient.lastName.value}}`	Apellido del paciente
`{{user.firstName}}`	Nombre del remitente
`{{user.lastName}}`	Apellido del remitente
`{{user.username}}`	Nombre de usuario del remitente
`{{user.org}}`	ID de la organización del remitente
`{{user.sub}}`	ID de usuario del remitente
`{{user.npi}}`	ID EMR del presentador
`{{user.fullName}}`	Nombre completo del remitente
`{{timestamp}}`	Marca de tiempo de la operación de guardado en formato HL7v2
`{{docTimestamp}}`	Marca de tiempo de creación de documentos en formato HL7v2

Configuraciones de ejemplo

Configuracion basica

Copy to clipboard


          enabled: true

keepOpen: true
destination: file:///hl7/message-{{document.timestamp}}.hl7
fileDestination: file:///hl7/message-{{document.timestamp}}.hl7

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# This option will disable the HL7 wrapper for file destinations
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# If you require certain patient fields to be present, specify them here
#requiredPatientFields:
#        - 'patientId'

allowedExternalExtensions:
    - jpg
    - txt
    - pdf
    - tif

timestampFormat: YYYYMMDDHHmmss

hl7_vitals_msg:
    MSH:
    PID:
    OBR:
    OBX:

hl7_document_msg:
    MSH:
    PID:
    OBR:
    OBX:

Ejemplo con Variables

Copy to clipboard


          enabled: true

keepOpen: true
destination: file:///hl7/vitals-{{docTimestamp}}.hl7
fileDestination: file:///hl7/file-{{docTimestamp}}.hl7

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# This option will disable the HL7 wrapper for file destinations
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# If you require certain patient fields to be present, specify them here
#requiredPatientFields:
#        - 'patientId'

allowedExternalExtensions:
    - jpg
    - txt
    - pdf
    - tif

timestampFormat: YYYYMMDDHHmmss

hl7_vitals_msg:
    MSH:
        '_3': '3)Doc_Timestamp={{document.timestamp}}'
        '_4': '4)Timestamp={{timestamp}}'
        '_5': '5)Patient_Birthdate={{patient.birthDate.value}}'
    PID:
        '_1': '1)Patient_ID={{patient.patientId.value}}'
        '_8': '8)Patient_First_Name={{patient.firstName.value}}'
        '_9': '9)Patient_Middle_Initial={{patient.middleInitial.value}}'
        '_10': '10)Patient_Last_Name={{patient.lastName.value}}'
    OBR:
        '_2': '2)Document_Timestamp={{document.timestamp}}'
        '_3': '3)Document_Filename={{document.filename}}'
        '_4': '4)Patient_Sex={{patient.sex.value}}'
    OBX:
        '_1': '1)User_Full_Name={{user.fullname}}'
        '_4': '4)User_Username={{user.username}}'
        '_7': '7)User_First_Name={{user.firstname}}'
        '_8': '8)User_Last_Name={{user.lastname}}'
        '_10': '10)User_Org={{user.org}}'
        '_11': '11)User_Sub={{user.sub}}'
        '_13': '13)User_Meta={{user.meta}}'
        '_15': '15)User_NPI={{user.npi}}'

hl7_document_msg:
    MSH:
        '_3': '3)Doc_Timestamp={{document.timestamp}}'
        '_4': '4)Timestamp={{timestamp}}'
        '_5': '5)Patient_Birthdate={{patient.birthDate.value}}'
        '_6': '6)User_NPI={{user.npi}}'
    PID:
        '_1': '1)Patient_ID={{patient.patientId.value}}'
        '_8': '8)Patient_First_Name={{patient.firstName.value}}'
        '_9': '9)Patient_Middle_Initial={{patient.middleInitial.value}}'
        '_10': '10)Patient_Last_Name={{patient.lastName.value}}'
    OBR:
        '_2': '2)Document_Timestamp={{document.timestamp}}'
        '_3': '3)Document_Filename={{document.filename}}'
        '_4': '4)Patient_Sex={{patient.sex.value}}'
        '_14': '14)User_First_Name={{user.firstname}}'
        '_15': '15)User_Last_Name={{user.lastname}}'
        '_10': '10)User_Org={{user.org}}'
        '_11': '11)User_Sub={{user.sub}}'
        '_13': '13)User_Meta={{user.meta}}'
    OBX:
        '_1': '1)User_Full_Name={{user.fullname}}'
        '_4': '4)User_Username={{user.username}}'

Ejemplo de consulta de paciente

Copy to clipboard


          enabled: true

keepOpen: true
destination: mllps://192.168.1.238:6007
fileDestination: mllps://192.168.1.238:6007
queryEndpoint: mllps://192.168.1.238:6007

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# This option will disable the HL7 wrapper for file destinations
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# If you require certain patient fields to be present, specify them here
#requiredPatientFields:
#        - 'patientId'

allowedExternalExtensions:
    - jpg
    - txt
    - pdf
    - tif

timestampFormat: YYYYMMDDHHmmss

queryPatientMessage:
    MSH:
        '_2': 'TeleHealth'
        '_5': 'ApplicationName'
        '_6': 'Facility'
    QPD:
        '_3':
            '_0':
                '_1':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Family Name Segment'
                        'opt': 'R'
                        'rep': 0
                    '_0': 'PID-5-0'
                '_2':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Family Name'
                        'opt': 'O'
                        'rep': 0
                    '_0': '{{patient.lastName}}*'
            '_1':
                '_1':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Given Name Segment'
                        'opt': 'R'
                        'rep': 0
                    '_0': 'PID-5-1'
                '_2':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Given Name'
                        'opt': 'O'
                        'rep': 0
                    '_0': '{{patient.firstName}}*'
            '_2':
                '_1':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Segment'
                        'opt': 'R'
                        'rep': 0
                    '_0': 'PID-2-1'
                '_2':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Patient ID'
                        'opt': 'O'
                        'rep': 0
                    '_0': '{{patient.patientExternalId}}*'

hl7_vitals_msg:
    MSH:
        'ReceivingApplication': 'ApplicationName'
        'ReceivingFacility': 'Facility'
    PID:
    OBR:
    OBX:

hl7_document_msg:
    MSH:
        'ReceivingApplication': 'ApplicationName'
        'ReceivingFacility': 'Facility'
    PID:
    OBR:
    OBX: