For the complete documentation index, see llms.txt. This page is also available as Markdown.

HL7 Message Transformer

Saiba mais sobre o conector HL7 Message Transformer e como usá-lo na Digibee Integration Platform.

O HL7 Message Transformer converte mensagens HL7 para e a partir do formato JSON, facilitando transformações de dados eficientes em integrações de sistemas de saúde.

Parâmetros

A tabela abaixo lista todos os parâmetros de configuração do conector. Parâmetros que suportam expressões Double Braces estão marcados com ✅ na coluna Suporta DB.

Parâmetro
Descrição
Tipo de dado
Suporta DB
Valor padrão
Visível quando

Output Format

O formato para o qual a mensagem ou objeto deve ser convertido. Opções: JSON e HL7.

String

JSON

Message (DB)

A mensagem HL7 ou o objeto JSON que será convertido.

String

N/A

Fail On Error

Se a opção for ativada, a execução do pipeline com erro será interrompida. Caso contrário, a execução do pipeline continua, mas o resultado mostrará um valor falso para a propriedade "success".

Boolean

false

Raw Pass Through

Quando ativado, retorna a mensagem HL7 original sem alterações em "data", ignorando completamente o ciclo de parse e encode: sem normalização de escape, sem remoção de campos/componentes vazios no final e sem regeneração do MSH-2. Use essa opção quando a mensagem precisa chegar ao destino byte a byte (por exemplo, quando o sistema de destino faz seu próprio parse). Deixe desativado para o comportamento padrão, que faz o parse e reconstrói a mensagem, um processo normalizador que não garante fidelidade byte a byte.

Boolean

false

Output Format é JSON

Parâmetro
Description
Tipo de dado
Suporta DB
Valor padrão

Documentation

Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.

String

N/A

Informações adicionais

Versões suportadas

As versões de mensagem HL7 suportadas são:

  • 2.1

  • 2.2

  • 2.3

  • 2.3.1

  • 2.4

  • 2.5

  • 2.5.1

  • 2.6

  • 2.7

  • 2.8

  • 2.8.1

Alterações de formato em conversões HL7-JSON

Ao converter uma mensagem HL7 para JSON e depois de volta para HL7, a mensagem final pode diferir da original.

Por exemplo, um segmento que termina em |ABC|||| será exibido como |ABC. Da mesma forma, campos com valores como |^^| ou |ABCˆˆ serão representados como || e |ABC, respectivamente.

Isso ocorre porque esses caracteres funcionam como separadores de campo (|) ou caracteres de codificação (^^), e não como valores reais. Esse comportamento segue os padrões HL7 e não afeta a integridade da mensagem. A estrutura JSON utilizada na conversão também está em conformidade com os padrões HL7.

Exemplos de uso

HL7 para JSON

Configuração do conector:

  • Output Format: JSON

  • Data:

Saída do conector:

JSON para HL7

Configuração do conector:

  • Output Format: HL7

  • Data:

Saída do conector:

Exemplos de mensagem HL7

ADT_A01

Mensagem HL7:

Representação em JSON:

RDE_O01

Mensagem HL7:

Representação em JSON:

VXU_V04

Mensagem HL7:

Representação em JSON:

DFT_P03

Mensagem HL7:

Representação em JSON:

Atualizado

Isto foi útil?