HL7v2 Output Configuration

El envío de 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, comuníquese con Atención al cliente de AMD al 978-937-9021

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.

Seleccionar sección de dispositivos

Encuentre y seleccione los dispositivos etiquetados.

Seleccione HL7v2

Busque y seleccione la entrada denominada HL7v2.

Editar configuración

Haga clic en la configuración para editar.

Aplicar o cancelar

Presiona el botón Aplicar para guardar tus cambios.

Presione ESC para cancelar sin guardar.

Variables HL7

Variable	Devoluciones
{{document.source}}	Se agregó el archivo de forma a AGNES
{{document.data}}	Datos del documento
{{document.timestamp}}	Marca de tiempo del documento con formato
{{document.key}}	Clave única asignada al documento
{{document.ext}}	Ampliación de documento
{{document.filename}}	Nombre de archivo del documento
{{document.isValid}}	Bool
{{document.mime}}	Mime tipo de archivo
{{document.thumbnail}}	Ruta del archivo de miniatura utilizado
{{document.editable}}	Bool
{{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 del paciente
{{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}}	Proveedor Nacional Identificador del remitente
{{user.fullName}}	Nombre completo del remitente
{{timestamp}}	Marca de tiempo del mensaje
{{docTimestamp}}	Marca de tiempo numérica (sin caracteres de formato)

Configuración de muestra HL7

Configuracion basica

habilitado: verdadero

keepOpen: verdadero
destino: file:///hl7/message-{{document.timestamp}}.hl7
fileDestination: file:///hl7/message-{{document.timestamp}}.hl7

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# Esta opción deshabilitará el envoltorio HL7 para destinos de archivo
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# Si necesita que ciertos campos de pacientes estén presentes, especifíquelos aquí
#requiredPatientFields:
# - 'id del paciente'

extensiones externas permitidas:
  - jpg
  - txt
  - pdf
  - tif

formato de marca de tiempo: AAAAMMDDHHmmss

hl7_vitals_msg:
    MSH:
    PID:
    OBR:
    OBX:


    :
    MSH:
    PID:
    OBX:

Ejemplo con Variables

enabled: true

keepOpen: true
destination: file:///hl7/vitals-{{document.timestamp}}.hl7
fileDestination: file:///hl7/file-{{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 the​m 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}}'

Configuración de HL7

habilitado : establezca en verdadero para habilitar la salida HL7. Establezca en falso para deshabilitar la salida HL7.

keepOpen : true para mantener la conexión abierta. Establezca en falso para cerrar la conexión después de cada mensaje.

destino - Destino de los mensajes vitales de HL7. Puede ser mllp: //, mllps: //, http: //, https: //u file: //.

fileDestination - Destino de los mensajes del archivo HL7. Puede ser mllp: //, mllps: //, http: //, https: //u file: //.

queryDestination - Destino de las consultas de información del paciente HL7. Puede ser mllp: //, mllps: //, http: //o https: //. Si se define destino de consulta , se habilitará la pestaña Búsqueda de pacientes en AGNES.

allowQuery : establezca en true para permitir que la pestaña de búsqueda de pacientes se habilite en AGNES una vez que se haya definido queryDestination. Establézcalo en falso para anular la aparición de la pestaña Búsqueda de pacientes una vez que se haya definido destino de consulta.

allowExternalDocuments : true para permitir el envío de archivos agregados a Session Docs desde fuentes externas. Establezca en falso para bloquear el envío de archivos desde fuentes externas.

allowVideoSnapshots : true para permitir el envío de instantáneas capturadas por AGNES. Establezca en falso para bloquear el envío de instantáneas capturadas por AGNES.

allowPDFReport : true para permitir el envío de informes PDF creados por AGNES. Configure en falso para bloquear el envío de informes PDF creados por AGNES.

rawFileUpload : verdadero para cargar archivos sin un contenedor HL7.

allowVitals : true para permitir el envío de instantáneas de signos vitales. Configure en falso para bloquear el envío de instantáneas de vitals.

mixedVitalsField : indica el campo que se utilizará para los signos vitales. La especificación HL7 requiere 'OBX'.

requiredPatientFields - Lista de campos que AGNES debe requerir antes de enviar mensajes HL7. Puede ser PatientId, firstName, lastName, middleInitial, birthDate, sex.

allowedExternalExtensions : lista de extensiones de archivo para permitir la exportación.

timestampFormat : formato para la marca de tiempo. Sigue el estándar ISO 8601.

hl7_vitals_msg : configura segmentos de mensajes vitales individuales.

hl7_document_msg : configura segmentos de mensajes de documentos individuales.

Segmentos HL7

Se pueden agregar texto o variables a segmentos de mensajes individuales. Si desea personalizar la MSH: , puede agregar esto:

MSH:
    '_2': 'TeleSalud'
    '_5': 'AGNES'
    '_6': '{{timestamp}}'
    '_8': 'ORU ^ R01 ^ ORU ^ R01'
    '_10': 'P'
    ' _11 ':' 2.3 '

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

Para habilitar la pestaña Búsqueda de pacientes, debe definir la dirección del servidor al que desea conectarse en la Configuración de HL7 como queryEndpoint. Una vez que se haya definido queryEndpoint , se habilitará la pestaña de búsqueda de pacientes en AGNES. Será necesario definir una sección de QPD en su configuración de HL7 en función de la configuración de su EMR.

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: falso

Ejemplo de consulta de paciente

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:​