HL7DFDLInput

Use um nó do HL7DFDLInput para receber mensagens de clientes que se conectam ao broker usando o protocolo MLLP over TCP/IP.

Propósito

O nó do HL7DFDLInput atende a uma porta e quando um soquete do cliente conecta-se à porta, o soquete do servidor cria uma conexão para o cliente. Quando uma conexão é aberta, um registro dos dados é recebido e o fim do registro é detectado pela presença de um delimitador configurável. Se ocorrer um erro ao ler dados, por exemplo, um tempo limite enquanto está esperando dados ou o fechamento de uma conexão enquanto está esperando o registro integral, os dados são enviados ao terminal de Falha. Se o terminal Falha não estiver conectado, uma exceção será lançada. Se a propriedade Mecanismo de nova tentativa para o nó não estiver configurada como Falha, o nó tenta reconectar-se até que os dados sejam recuperados com sucesso ou até que o número de tentativas que é definido pela propriedade Limite de nova tentativa seja excedido.

O nó HL7DFDLInput requer que as mensagens usem o protocolo MLLP sobre TCP/IP. Se os bytes à esquerda MLLP não estiverem presentes, a mensagem será enviada ao terminal Falha.

O nó do HL7DFDLInput manipula mensagens que são definidas no domínio DFDL. O formato da mensagem do HL7 no modelo de mensagem DFDL é usado para analisar as mensagens. Se ocorrer um erro de análise ou se os campos obrigatórios MSH não estiverem presentes, a mensagem será passada para o terminal Falha. Para obter informações sobre modelos de mensagens, consulte Modelos de Mensagem na documentação do produto IBM® Integration Bus.

É possível configurar o nó do HL7DFDLInput para verificar duplicados. Cada mensagem recebida do HL7 possui um campo MessageControlID no segmento do cabeçalho MSH, que identifica o registro. Se a propriedade Verificar duplicatas estiver selecionada, todos os identificadores serão armazenados na fila de duplicatas com a confirmação (ACK) que foi retornada para o emissor. O identificador de uma mensagem recebida é verificado com relação a identificadores salvos para determinar se é uma duplicata. Quando uma duplicata é detectada, ela não é processada, mas a mesma confirmação que foi enviada com a primeira mensagem é retornada ao emissor. A fila de duplicatas é especificada como uma propriedade do nó.

Os identificadores são armazenados na fila de duplicatas para a duração que é definida pela propriedade Período de tempo de duplicata. Após esta duração ser decorrida, os identificadores são excluídos e as mensagens com o mesmo identificador não são mais tratadas como duplicatas. Você deve dimensionar a fila de duplicata para conter o número de pico de identificadores de mensagem que são esperados no período de tempo configurado.

Se uma mensagem recebida não for uma duplicata, a mensagem será passada para o terminal Externo do nó do HL7DFDLInput para processamento adicional. Se uma duplicata for detectada, o nó do HL7DFDLInput retornará a ACK ao solicitante. Se o relatório de duplicata for selecionado e uma duplicata for detectada, a mensagem será passada ao terminal Falha.

As mensagens são processadas sob controle transacional. Se o fluxo de mensagens for retrocedido, os identificadores de duplicata que foram incluídos na fila do identificador de duplicata serão removidos. Isso assegura que, se uma mensagem for reenviada, ela não será identificada como uma duplicata e será processada como uma nova mensagem.

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

O nó do HL7DFDLInput 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 de nó GenericHL7DFDLInput

Utilizando Este Nó em um Fluxo de Mensagens

Quando um nó do HL7DFDLInput é usado em um fluxo de mensagens, as mensagens passadas ao terminal Externo contêm mensagens analisadas do HL7 com bytes MLLP à esquerda e à direita removidos. A árvore de mensagens contém cabeçalhos MQMD e MQRFH2 para que a mensagem possa ser gravada diretamente em uma fila, se necessário. O corpo da mensagem contém uma mensagem do HL7 no domínio do DFDL. O fluxo de mensagens é responsável por retornar uma confirmação (ACK) ao solicitante.

Se houver uma falha no nó do HL7DFDLInput, a mensagem será passada para o 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 a ação que está sendo tomada quando ocorre o erro.
SendNACK Envie uma resposta de confirmação negativa (NACK).
EndConnection SIM: Feche a conexão.

NÃO: Não feche a conexão.

HL7RC Código de retorno do HL7.
ErrorCondition Texto de erro a incluir na NACK.
Se o campo SendNACK for configurado como SIM, uma NACK será retornada ao solicitante. O campo SendNACK é configurado como NÃO se uma das condições a seguir ocorrer:
  • A mensagem recebida não contém os delimitadores MLLP corretos, portanto, presume-se que o protocolo MLLP não seja suportado.
  • A mensagem é uma duplicata e a NACK foi retornada pelo nó do HL7DFDLInput.

Se a EndConnection for configurada como SIM, a conexão deverá ser fechada. Esta ação ocorre quando a mensagem recebida não continha os delimitadores MLLP corretos e é, portanto, presumido que o protocolo MLLP não seja suportado.

Os campos HL7RC (Código de retorno do HL7) e ErrorCondition estão disponíveis para fornecer informações na NACK que é retornada ao solicitante.

A tabela Erro a seguir indica os códigos de erro que podem ocorrer.
Marco do Fluxo Atingido Código de Retorno Texto de erro
DETECTDUPLICATE AR Erro ao verificar duplicatas
PARSE AE Uma mensagem de erro de análise DFDL é mostrada. A mensagem resume o problema.
BUILDACK AR Erro ao construir a mensagem ACK.

(Este erro ocorre quando uma ACK é retornada, pois é uma mensagem duplicada).

SENDACK AR Erro ao construir a mensagem ACK

(Este erro ocorre quando uma ACK é retornada, pois é uma mensagem duplicada).

DUPLICATEERROR AR Falha durante a detecção de duplicata. A fila de duplicatas está cheia.

Falha durante a detecção de duplicata. O processamento de mensagens falhou.

SAVINGDUPDATA AR Erro ao salvar dados de duplicata
DUPLICATE RECORD AR Registro duplicado detectado

O nó do HL7DFDLInput é transacional. Quando o fluxo de mensagens no qual ele é usado é encerrado com sucesso, todas as mensagens gravadas na transação são confirmadas. Se a mensagem for encerrada com uma exceção que não é capturada, todas as mensagens gravadas na transação serão retrocedidas, incluindo a mensagem. Esta ação inclui a mensagem na fila que salva IDs para detecção duplicada. Você deve determinar quais mensagens deseja que sejam retrocedidas nestas circunstâncias e assegurar que outras mensagens, por exemplo, mensagens de erro, não sejam gravadas na transação.

Configurando o Nó HL7DFDLInput

Quando tiver incluído uma instância de um nó do HL7DFDLInput em um fluxo de mensagens, será 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ó HL7DFDLInput são descritos na tabela a seguir.
Terminal Descrição
Falha O terminal de saída ao qual uma mensagem é encaminhada se ocorrer um erro.
Saída O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito de um recurso externo.
Capturar O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó. As exceções serão capturadas somente se o terminal estiver anexado.

As tabelas a seguir descrevem as propriedades do nó. A coluna titulada M indica se a propriedade é obrigatória (marcada com um asterisco se você dever inserir um valor quando nenhum padrão estiver definido); a coluna titulada C indica se a propriedade é configurável (é possível alterar o valor ao incluir o fluxo de mensagens no arquivo de archive do broker (BAR) para implementá-lo).

As propriedades Descrição para o nó do HL7DFDLInput são descritas na tabela a seguir.
Propriedade M A Default Descrição
Nome do Nó SIM Não HL7DFDLInput 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 Processamento de HL7 para o nó do HL7DFDLInput são descritas na tabela a seguir.
Propriedade M A Default Descrição
Verificar duplicatas Não Não Não Selecionada Determina se as mensagens duplicadas são detectadas, conforme determinado pelo identificador de mensagem exclusivo no cabeçalho do HL7 MSH.
Se uma duplicata for detectada, a ação a seguir será tomada:
  • Se a mensagem for recebida no período do tempo limite, a mensagem não será processada, mas a mesma ACK que foi enviada para a mensagem original será retornada ao emissor.
  • Após o período de tempo limite ter expirado, quaisquer mensagens duplicadas serão processadas como sempre.
Relatar duplicatas Não SIM Selecionada Determina se as mensagens duplicadas que chegam no tempo especificado geram uma mensagem de notificação de erro.
Período de tempo duplicado Não SIM 86400 Define (em segundos) por quanto tempo as mensagens do identificador são mantidas antes de expirar. Após este período de tempo, as duplicatas não são reconhecidas e são processadas como sempre. O padrão (86400) é igual a 24 horas.

Esta propriedade é obrigatória se Verificar duplicatas estiver selecionada.

Fila de identificadores de duplicata Não Não   Define a fila que retém a lista de IDs duplicados atuais em relação à qual as mensagens recebidas são verificadas.

Esta propriedade é obrigatória se Verificar duplicatas estiver selecionada.

Bytes MLLP à esquerda SIM Não 0B Define o byte à esquerda, que é parte do protocolo MLLP e qual é removido antes de a mensagem ser analisada e processada.
Enviar confirmações Não SIM Selecionada Determina se as mensagens de confirmação são enviadas quando as mensagens duplicadas são detectadas.
As propriedades Básicas para o nó HL7DFDLInput estão descritas na tabela a seguir.
Propriedade M A Default Descrição
Detalhes da Conexão SIM SIM 1111 A conexão de TCP/IP para o aplicativo de origem no formato hostname:port
Tempo limite que aguarda pelo registro de dados (segundos) SIM SIM 60 A duração de tempo que o nó atende a uma conexão para mais dados após o primeiro byte de dados chegar. É possível especificar qualquer período de tempo em segundos. O padrão é de 60 segundos. Quando o tempo especificado é excedido, todos os dados disponíveis são enviados ao terminal Falha.
As propriedades Detecção de Registro para o nó do HL7DFDLInput são descritas na tabela a seguir.
Propriedade M A Default Descrição
Delimitador SIM 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 removidos pelo nó do HL7DFDLInput.
As propriedades Nova Tentativa para o nó do HL7DFDLInput são descritas na tabela a seguir.
Propriedade M A Default Descrição
Tentar mecanismo novamente Sim Não Intervalo de Repetição curto (segundos) Como o nó manipula uma falha de fluxo. As opções válidas são:
  • Falha
  • Intervalo de Repetição curto (segundos)
  • Repetição Curta e Longa
Intervalo de Repetição curto (segundos) SIM SIM 0 O intervalo, em segundos, entre cada repetição, se Limite de Repetição não for zero.
Tentar limite novamente Sim SIM 0 O número de vezes para tentar novamente a transação do fluxo quando o Mecanismo de nova tentativa tem Intervalo de nova tentativa curto (segundos).
Intervalo de Repetição longo (segundos) Sim SIM 300 O intervalo entre as novas tentativas se o Mecanismo de Nova Tentativa for Nova Tentativa Curta e Longa e o limite de novas tentativas tiver sido exaurido.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 2011, 2014Copyright IBM Corporation 2011, 2014.

        
        Última atualização
        
        Última atualização : 2014-03-20 23:33:11


Tópico de ReferênciaTópico de Referência | Versão 3.0.0.0 | ha05110