HL7v2 Output Configuration

O envio de resultados para um EMR ou outro sistema externo requer uma licença EMR válida. Para obter assistência na configuração da saída HL7v2, entre em contato com o Suporte ao Cliente AMD em 978-937-9021

Abrir configurações

Para configurar a saída HL7v2, abra o aplicativo AGNES-Connect e pressione o ícone Configurações no canto inferior esquerdo.

Seção Selecionar dispositivos

Localize e selecione a entrada Dispositivos.

Selecione HL7v2

Encontre e selecione a entrada rotulada HL7v2.

Editar configuração

Clique na configuração para editar.

Aplicar ou cancelar

Pressione o botão Apply para salvar suas alterações.

Pressione ESC para cancelar sem salvar.

Variáveis HL7

Variável	Devoluções
{{document.source}}	Forma como o arquivo foi adicionado a AGNES
{{document.data}}	Dados do documento
{{document.timestamp}}	Timestamp do documento com formatação
{{document.key}}	Chave única atribuída ao documento
{{document.ext}}	Extensão do documento
{{document.filename}}	Nome de arquivo do documento
{{document.isValid}}	Bool
{{document.mime}}	Tipo de arquivo MIME
{{document.thumbnail}}	Caminho do arquivo de miniatura usado
{{document.editable}}	Bool
{{patient.sex.value}}	Sexo Paciente
{{patient.patientId.value}}	ID do paciente (não visível no portal)
{{patient.middleInitial.value}}	Paciente inicial do meio
{{patient.extra.value}}	Campo Extra do Paciente (não visível no portal) usado para passar valores arbitrários
{{patient.birthDate.value}}	Data de Nascimento do Paciente
{{patient.patientExternalId.value}}	ID externa do paciente (visível para o usuário)
{{patient.firstName.value}}	Nome do Paciente
{{patient.lastName.value}}	Sobrenome do paciente
{{user.firstName}}	Nome do remetente
{{user.lastName}}	Sobrenome do remetente
{{user.username}}	Nome de usuário do remetente
{{user.org}}	ID da organização do remetente
{{user.sub}}	ID de usuário do remetente
{{user.npi}}	Identificador do provedor nacional do remetente
{{user.fullName}}	Nome completo do remetente
{{timestamp}}	Timestamp da mensagem
{{docTimestamp}}	Carimbo de data / hora numérico (sem caracteres de formatação)

HL7 Sample Config

Configuração básica

enabled: true

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

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# Esta opção desabilitará o wrapper HL7 para destinos de arquivo
#rawFileUpload: true

allowVitals: true
CombineVitalsField: 'OBX'

# Se você precisar que certos campos de paciente estejam presentes, especifique-os aqui
#requiredPatientFields:
# - 'patientId'

permitidoExternalExtensions:
  - jpg
  - txt
  - pdf
  - tif

timestampFormat: YYYYMMDDHHmmss

hl7_vitals_msg:
    MSH:
    PID:
    OBR:
    OBX:

hl7_document_msg:
    MSH: 298 PID:
    OBR: 25 OBX:
    hl7_document_OBR:
    OBX:

Exemplo com variáveis

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}}'

Configurações HL7

habilitado - Defina como verdadeiro para habilitar a saída HL7. Defina como falso para desativar a saída HL7.

keepOpen - Defina como true para manter a conexão aberta. Defina como false para fechar a conexão após cada mensagem.

destino - Destino das mensagens vitais HL7. Pode ser mllp: //, mllps: //, http: //, https: //ou arquivo: //.

fileDestination - Destino das mensagens do arquivo HL7. Pode ser mllp: //, mllps: //, http: //, https: //ou arquivo: //.

queryDestination - Destino das consultas de informações do paciente HL7. Pode ser mllp: //, mllps: //, http: //ou https: //. Se for definido queryDestination , a guia Patient Search no AGNES será habilitada.

allowQuery - Defina como true para permitir que a guia Patient Search seja habilitada no AGNES assim que queryDestination for definido. Defina como false para anular a exibição da guia Patient Search assim que queryDestination for definido.

allowExternalDocuments - Defina como true para permitir o envio de arquivos adicionados ao Session Docs de fontes externas. Defina como false para bloquear o envio de arquivos de fontes externas.

allowVideoSnapshots - Defina como true para permitir o envio de instantâneos capturados por AGNES. Defina como false para bloquear o envio de instantâneos capturados por AGNES.

allowPDFReport - Defina como true para permitir o envio de relatórios em PDF criados por AGNES. Defina como false para bloquear o envio de relatórios PDF criados por AGNES.

rawFileUpload - Defina como true para fazer upload de arquivos sem um wrapper HL7.

allowVitals - Defina como true para permitir o envio de instantâneos de sinais vitais. Defina como false para bloquear o envio de instantâneos vitais.

CombinadoVitalsField - Denote o campo a ser usado para sinais vitais. A especificação HL7 exige 'OBX'.

requiredPatientFields - Lista de campos que o AGNES deve exigir antes de enviar mensagens HL7. Pode ser PatientId, firstName, lastName, middleInitial, birthDate, sex.

allowedExternalExtensions - Lista de extensões de arquivo para permitir a exportação.

timestampFormat - formato para carimbo de data / hora. Segue o padrão ISO 8601.

hl7_vitals_msg - Configurar segmentos de mensagens vitais individuais.

hl7_document_msg - Configurar segmentos de mensagem de documento individuais.

Segmentos HL7

Texto ou variáveis podem ser adicionados a segmentos de mensagens individuais. Se você quiser personalizar a MSH: , poderá adicionar:

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

Consulta do Paciente

Os usuários podem consultar uma lista de pacientes de um EMR sobre HL7 se o sistema EMR for compatível. O usuário pode fornecer uma string de pesquisa parcial para restringir os resultados.

Ponto de extremidade de consulta HL7

Para habilitar a guia Patient Search, você deve definir o endereço do servidor ao qual deseja se conectar na configuração do HL7 como queryEndpoint. Uma vez definido queryEndpoint , a aba Patient Search no AGNES será habilitada. Uma seção QPD precisará ser definida em sua configuração HL7 com base nas configurações em seu EMR.

Permitir consulta do paciente

A funcionalidade de pesquisa no AGNES é habilitada quando queryEndpoint é definido. Isso pode ser desabilitado configurando allowQuery para false.

allowQuery: false

Exemplo de consulta do 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:​