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