HL7DFDLOutput

Use um nó do HL7DFDLOutput para preparar uma mensagem para o aplicativo de destino.

Propósito

O nó do HL7DFDLOutput recebe uma mensagem do HL7 no domínio do DFDL e abre conexões com um aplicativo de destino que está atendendo em uma porta TCP/IP. Quando a conexão é estabelecida, a mensagem do HL7 é enviada com um fim de registro que é configurado para o delimitador de propriedade Bytes MLLP à direita, que possui um valor padrão de 1C0D. Se os dados não foram enviados com sucesso no limite de tempo especificado pela propriedade Limite de tempo que envia registro de dados (segundos) para o nó, a mensagem é passada para o terminal Falha.

Após enviar a mensagem com sucesso, o nó do HL7DFDLOutput aguarda uma confirmação (ACK) do aplicativo de destino. Uma confirmação do HL7 é dividida em bytes MLLP, analisada e o código de retorno é verificado. Se ocorrer um erro no nó do HL7DFDLOutput, a mensagem é passada para o terminal Nova Tentativa de Log ou o terminal Falha.

Se a entrega for bem-sucedida e um código AR for retornado na confirmação, e se o limite de nova tentativa não tiver sido excedido, a mensagem será transmitida ao terminal de Nova tentativa de log.

Se a mensagem for entregue e um código AE for retornado na reconhecimento ou se nenhuma confirmação válida for recebida, a mensagem será passada para o terminal Falha.

Se a mensagem não for entregue, será assumido que o destino não está disponível; e se o limite de nova tentativa não tiver sido excedido, a mensagem será transmitida ao terminal de Nova tentativa de log.

Se o terminal Nova Tentativa de Log não estiver conectado ou se o caminho acabar bem-sucedido, a entrega será tentada novamente. Se o terminal Nova Tentativa de Log estiver conectado e uma exceção for lançada como recebimento de dados, não haverá tentativa de envio da mensagem novamente e a mensagem será passada ao terminal Falha.

Se o terminal Falha não estiver conectado, uma exceção será lançada.

Para obter informações sobre o HL7, consulte Health Level Seven International.

O nó do HL7DFDLOutput está contido na gaveta Assistência Médica da paleta de nó do fluxo de mensagens e será representado no IBM® Integration Toolkit pelo ícone a seguir:

Ícone do nó GenericHL7DFDLOutput

Utilizando Este Nó em um Fluxo de Mensagens

Um exemplo de como usar o nó do HL7DFDLOutput é mostrado no padrão integrado do Assistência Médica: HL7 para HL7 na categoria Assistência Médica no visualização Explorador de Padrões.

Quando um nó do HL7DFDLOutput é usado em um fluxo de mensagens, o nó espera localizar uma mensagem na árvore do DFDL que foi analisada com relação à mensagem do HL7 no modelo de mensagem DFDL. É possível usar o modelo genérico ou o modelo específico para o tipo de mensagem que está definido na mensagem (especifique o formato configurando a propriedade do nó Usar modelo genérico no nó HL7DFDLInput em seu fluxo de mensagem). Se não estiver certo de que as mensagens passadas para o nó do HL7DFDLOutput estão corretas, é possível configurar a propriedade Validar para forçar a análise antes de o processamento começar. Se a mensagem for enviada com sucesso para o destino configurado e uma confirmação do processamento bem-sucedido for retornada do destino, a confirmação será passada para o terminal Externo do nó.

Se desejar que o nó tente enviar a mensagem novamente após uma falha, você deverá configurar o valor da propriedade Limite de novas tentativas para o número de vezes que deseja que o nó tente enviar a mensagem. O nó tenta novamente a cada 10 segundos, mas é possível alterar o intervalo alterando a propriedade Intervalo de nova tentativa (segundos). Se você também desejar registrar cada tentativa, deverá selecionar a propriedade Nova tentativa de log. Quando a propriedade Nova tentativa de log for selecionada, a mensagem será passada para o terminal Nova Tentativa de Log para cada tentativa. O ambiente retém os valores que podem ser usados em sua mensagem de log, consulte a tabela Ambiente a seguir.

Se conectar ao terminal Nova Tentativa de Log, o encadeamento de fluxo de mensagens terminará com sucesso e haverá tentativas adicionais para enviar a mensagem. Se exceções não capturadas forem lançadas neste encadeamento, as novas tentativas não continuarão.

Se uma mensagem for passada para o terminal Falha, seu fluxo de mensagens atuará de acordo com seus procedimentos de manipulação de erros. O terminal Falha deve estar conectado para que o erro seja registrado e os dados salvos, uma exceção lançada ou ambos. Se o terminal Falha não estiver conectado, o erro causará uma falha silenciosa, nenhuma exceção será lançada e nenhum evento será registrado no log de eventos. Para códigos de erro e outras informações que podem ser usados em sua manipulação de erros, consulte a tabela Erro a seguir.

Se ocorrer uma falha no nó do HL7DFDLOutput, a mensagem será passada ao terminal Falha. LocalEnvironment.HL7 contém os campos mostrados na tabela Ambiente a seguir. Esses campos dão informações que são usadas para construir uma confirmação negativa (NACK) ou criar uma mensagem de erro.

Campo Descrição
FlowMilestoneReached Indica onde ocorreu o erro
Tentar Novamente Indica se esta ação pode ser tentada novamente
ErrorCondition Dá uma descrição textual do erro
Tentativa Se o erro ocorrer em um loop de nova tentativa, esta variável conterá o texto a seguir: Attempt <i> of <n>
RetryCount Indica a tentativa atual
RetryLimit Indica o número de tentativas permitidas

A tabela Erro a seguir indica os códigos de erro que podem ocorrer.

Erro Terminal Tentar Novamente Código Texto do erro
O nó falhou ao analisar a mensagem recebida usando o modelo de mensagem DFDL e o formato da mensagem do HL7. Falha Não BADHL7 MESSAGE A mensagem HL7 recebida não pode ser analisada.
O nó falhou ao enviar a mensagem para o destino configurado. Nova Tentativa de Log Sim SENDHL7 Erro de TCP/IP. A mensagem HL7 não foi enviada.
O nó falhou ao analisar a confirmação. Falha Não ACKPARSE ERROR Erro de MSH enquanto a mensagem ACK estava sendo analisada.
A confirmação foi recebida, mas nenhum código de confirmação está presente. Falha Não ACKERROR Erro de análise ou validação de MSA: MSA 1. O código de confirmação é nulo. A ACK contida na mensagem de erro a seguir: error_message
A confirmação foi recebida, mas nenhum ID de controle de mensagem está presente. Falha Não ACKERROR Erro de análise ou validação de MSA: MSA 2. O MessageControlID é nulo. A ACK enviou a mensagem de erro a seguir: error_message
Nenhuma confirmação foi recebida no período de tempo limite. Falha Não TIMEOUT O nó falhou ao receber a mensagem ACK no tempo limite especificado.
O nó falhou ao receber a confirmação. Falha Não RECEIVE ACK Erro de TCPIP. O nó falhou ao receber a mensagem ACK.
O nó tentou entregar a mensagem, mas atingiu o limite de novas tentativas configurado. Falha Não SENDHL7 TOOMANY REPEATS O nó falhou ao receber a mensagem ACK.
O nó recebeu confirmações de AR, mas atingiu o limite de novas tentativas configurado. Falha Não ACKAR TOOMANY REPEATS O nó tentou enviar a mensagem e não pode entregar a mensagem com sucesso.

Configurando o Nó HL7DFDLOutput

Depois de incluir uma instância de um nó HL7DFDLOutput em um fluxo de mensagens, é possível configurá-lo

Todas as propriedades obrigatórias para as quais é necessário inserir um valor (propriedades que não possuem um valor-padrão definido) são marcadas com um asterisco.

Terminais e Propriedades

Os terminais do nó HL7DFDLOutput são descritos na tabela a seguir.
Terminal Descrição
In O terminal de entrada que aceita uma mensagem do HL7 para que o nó processe.
Falha O terminal de saída ao qual a mensagem é encaminhada se o nó falhar em enviar com sucesso a mensagem e falhar em receber uma confirmação de processamento bem-sucedido.
Saída O terminal de saída ao qual a confirmação é encaminhada se uma mensagem for enviada com sucesso ao destino e uma confirmação do processamento bem-sucedido for recebida.
Nova Tentativa de Log O terminal de saída ao qual a mensagem é encaminhada se o nó falhar em envia com sucesso a mensagem ou falhar em receber uma confirmação de processamento bem-sucedido e a contagem de nova tentativa não estiver excedida.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição para o nó do HL7DFDLOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Nome do Nó Não Não HL7DFDLOutput O nome do nó.
Descrição curta Não Não   Uma breve descrição do nó.
Descrição detalhada Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.
As propriedades Básicas para o nó HL7DFDLOutput estão descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Detalhes da Conexão Sim Sim localhost:2222 A conexão de TCP/IP para o aplicativo de destino no formato hostname:port
Registro de dados de envio de tempo limite (segundos) Sim Sim 60 O tempo em segundos que o nó aguarda quando se tenta enviar dados ou receber uma confirmação.
Byte de MLLP final Sim Sim 0B O byte MLLP à esquerda, que é incluído em registros de saída do HL7 e removidos de confirmações recebidas.
Limite de nova tentativa Sim Sim 5 O número máximo de vezes que o nó tenta entregar uma mensagem do HL7 ao aplicativo de destino.
Intervalo de novas tentativas (segundos) Sim Sim 10 O intervalo, em segundos, entre cada tentativa de entregar uma mensagem do HL7 para o aplicativo de destino.
Nova tentativa de log Não Sim Selecionados Especifica se cada tentativa de entregar uma mensagem é passada para o terminal de Nova Tentativa de Log para permitir a criação de log.
As propriedades Detecção de Registro para o nó do HL7DFDLOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Delimitador Não Não Delimitador customizado Esta propriedade não é editável.
Bytes MLLP à direita Sim Sim 1C0D Os bytes MLLP à direita que são usados como um delimitador de registro do HL7. Esses bytes MLLP à direita são incluídos pelo nó do TCPIPClientOutput.
As propriedades Detecção de Registro (Confirmação) para o nó do HL7DFDLOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Delimitador Não Não Delimitador customizado Esta propriedade não é editável.
Bytes MLLP à direita (Confirmação) Sim Não 1C0D O delimitador do HL7 que é usado para detectar o fim de confirmações recebidas.
As propriedades Validação para o nó do HL7DFDLOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Validar Não Sim Nenhum(a) Esta propriedade determina o nível de validação da mensagem de entrada do HL7 no domínio DFDL. Valores válidos são:
  • Nenhum(a)
  • Content
  • Conteúdo e Valor
Copyright IBM Corporation 2011, 2015Copyright IBM Corporation 2011, 2015.

        
        Última atualização
        
        Última atualização : 2015-06-23 08:49:05


Tópico de ReferênciaTópico de Referência | Versão 4.0.0.0 | ha05120