DICOMOutput

Use um nó DICOMOutput para receber mensagens XML DICOM, combinar os metadados das mensagens XML DICOM com os dados de pixel armazenados no sistema e enviar a imagem DICOM resultante para um SCP.

Propósito

O nó DICOMOutput é um nó Service Class User (SCU) para a classe de serviço de armazenamento. O nó obtém metadados de uma mensagem XML DICOM, combina-os com a imagem digitalizada (dados de pixel) (e qualquer outro atributo não na mensagem XML DICOM) do sistema de arquivos. O resultado é enviado para um aplicativo Service Class Provider (SCP), por exemplo, um DICOM Picture Archiving System (PACS) usando o comando DICOM C-STORE.

O nó do DICOMOutput 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ó DICOMOutput

Utilizando Este Nó em um Fluxo de Mensagens

O nó DICOMOutput recebe as mensagens XML DICOM em seu terminal de entrada. A mensagem XML DICOM é recombinada com a imagem digitalizada (dados de pixel) armazenada no sistema de arquivos e a imagem DICOM resultante é enviada para um SCP de destino. O SCP de destino é configurado usando as propriedades do nó e essa configuração não pode ser substituída no ambiente local. A mesma imagem DICOM pode ser enviada diversas vezes para o mesmo SCP de destino. O SCP de destino pode verificar o identificador SOP, que identifica exclusivamente a imagem DICOM para determinar se a imagem DICOM já foi recebida.

Se uma transferência de imagem DICOM for bem-sucedida, a mensagem XML DICOM será propagada para o terminal de saída do nó DICOMOutput para processamento adicional no fluxo de mensagens. Se uma transferência de imagem DICOM falhar, um erro será produzido.

O processo de combinar metadados da mensagem XML DICOM com a imagem digitalizada (dados de pixel) chama-se codificação. A configuração do nó inclui opções para você alterar a codificação de uma imagem DICOM. Portanto, a codificação de uma imagem DICOM recebida por um nó DICOMInput pode ser diferente da codificação da imagem DICOM enviada para um aplicativo de destino.

O DICOM padrão requer que duas entidades de aplicativo sejam identificadas ao se conectarem. A identificação é feita usando um Application Entity Title (AET), que é uma sequência de texto com até 16 caracteres. O nó DICOMOutput deve ser configurado com seu próprio AET e também com o AET do SCP ao qual ele se conecta. O nó DICOMOutput não se conectará, a menos que o AET do SCP de destino corresponda exatamente ao valor configurado no nó DICOMOutput. A conexão com o SCP de destino é estabelecida quando uma mensagem chega no terminal de entrada do nó DICOMOutput. Se a conexão não puder ser estabelecida, um erro será produzido.
Nota: O nó DICOMOutput não mantém as conexões de uma transferência de mensagem para outra.
Confirmação de Armazenamento

É possível configurar o nó DICOMOutput para solicitar mensagens de resposta de confirmação de armazenamento do SCP de destino para o qual ele envia as imagens DICOM. O nó DICOMOutput pode ser configurado com uma porta na qual receber essas mensagens de resposta assíncronas. Se a porta não estiver configurada, o nó não solicitará respostas de confirmação de armazenamento. Se a porta estiver configurada, o nó não propagará mensagens para seu terminal de saída, até que as mensagens de resposta de confirmação de armazenamento sejam recebidas. Também é possível configurar um tempo limite que defina o tempo máximo de espera da mensagem de resposta de confirmação de armazenamento. Se uma resposta não for recebida nesse período, um erro será produzido.

Diretório de processamento

Configure o nó DICOMOutput com um diretório no sistema de arquivos para processar imagens DICOM (recombinando os metadados na mensagem XML com os dados de pixel). Esse diretório é especificado na propriedade de nó Diretório de Processamento. Esse diretório não pode ser usado por outro nó, a menos que você esteja usando uma configuração de várias instâncias. Em uma configuração de várias instâncias, o mesmo fluxo de mensagens é configurado no nó de integração ativo e passivo. Apenas um fluxo de mensagens fica sempre ativo e o diretório do sistema de arquivo compartilhado fornece o estado para o nó DICOMOutput passivo quando o fluxo de mensagens é ativado.

Esquema de mensagens
Um único esquema é usado para descrever todas as mensagens XML DICOM que são enviadas e recebidas pelos nós DICOM. Contudo, apenas um dos tipos complexos que são definidos no esquema é usado para estruturar cada tipo de mensagem. O tipo complexo DICOM é usado para definir as mensagens XML DICOM que chegam ao terminal de entrada e que são enviadas do terminal de saída do nó DICOMOutput.
Para obter mais informações sobre o esquema, consulte Esquema de Mensagem do DICOM.
As transações DICOM
As execuções de processos do nó DICOMOutput dentro da transação ativa para o encadeamento que processa a imagem DICOM. Se um erro ocorrer, o nó DICOMOutput produzirá um erro. Dependendo da lógica de manipulação de exceção no fluxo de mensagens de contenção, o erro poderá fazer com que a transação atual seja retrocedida.

Entradas do log de atividades

A tabela a seguir detalha as entradas do log de atividades que são gravadas pelo nó DICOMOutput, em que os nomes a seguir são usados nos exemplos:
  • BROKERAE é o nome da entidade de aplicativo do DICOMOutput.
  • REMOTEAE é o nome da entidade de aplicativo remoto.
  • hostname:2222 é o nome do host e o número da porta da entidade de aplicativo remoto.
Condição Descrição Tipo Exemplo Recomendações
Início do envio Uma imagem DICOM está sendo preparada para envio a uma entidade aplicativo remoto.
Nota: O envio de uma imagem DICOM é conhecido no DICOM como um comando C-STORE.
Informações BIP12068 Starting DICOM C-STORE operation (BROKERAE,REMOTEAE,hostname:2222)

O Identificador de Objeto (OID) da imagem DICOM é registrado no campo FILENAME no log de atividades.

Nenhuma ação é necessária.
Término do envio A imagem DICOM foi enviada com êxito para uma entidade de aplicativo remoto.

Se a confirmação de armazenamento estiver ativada, essa entrada do log de atividades sinalizará que a mensagem de resposta de confirmação de armazenamento solicitada foi recebida.

Informações BIP12068 Finished DICOM C-STORE operation (BROKERAE,REMOTEAE,hostname:2222)

O OID da imagem DICOM é registrado no campo FILENAME no log de atividades.

Nenhuma ação é necessária.
Falha no envio Um envio DICOM falhou (comando C-STORE). Um erro é produzido pelo nó DICOMOutput. Erro BIP12070 Failed DICOM C-STORE operation (BROKERAE,REMOTEAE,hostname:2222)

O OID da imagem DICOM é registrado no campo FILENAME no log de atividades.

Verifique a conectividade de rede entre o nó de integração e o SCP remoto.

Verifique se o tipo de dados que estão sendo transferidos (classe SOP e sintaxe de transferência) é compatível com o SCP remoto.

Verifique se os nomes da entidade do aplicativo e os números da porta correspondem exatamente ao SCP remoto.

Verifique se o SCP remoto está online e pronto para aceitar conexões e transferências de dados.

Verifique os detalhes do erro para obter mais informações sobre ele.

Início do envio de solicitação de confirmação de armazenamento O nó DICOMOutput está enviando uma mensagem de solicitação de confirmação de armazenamento para o SCP remoto. Informações BIP12068 Sending storage commit request message (BROKERAE,REMOTEAE,hostname:2222) Nenhuma ação é necessária.
Término do envio de solicitação de confirmação de armazenamento A mensagem de solicitação de confirmação de armazenamento foi enviada com sucesso para o SCP remoto. Informações BIP12068 Finished sending storage commit request message (BROKERAE,REMOTEAE,hostname:2222) Nenhuma ação é necessária.
Falha no envio da solicitação de confirmação de armazenamento O nó DICOMOutput não pôde enviar uma mensagem de solicitação de confirmação de armazenamento para o SCP remoto. Erro BIP12070 Failed to send storage commit request message (BROKERAE,REMOTEAE,hostname:2222) Verifique a conectividade de rede entre o nó de integração e o SCP remoto.

Verifique se o aplicativo remoto suporta a classe SOP de confirmação de armazenamento.

Verifique se os nomes e os números de porta da entidade do aplicativo correspondem exatamente com o SCP remoto.

Verifique se o SCP remoto está online e pronto para aceitar conexões e transferências de dados.

Verifique os detalhes do erro para obter mais informações sobre ele.

Envio da solicitação de confirmação de armazenamento atingiu o tempo limite A mensagem de resposta de confirmação de armazenamento não foi recebida pelo nó DICOMOutput dentro do limite de tempo configurado. Erro BIP12070 Timed out waiting for storage commit response message (BROKERAE,REMOTEAE,hostname:2222) Verifique a conectividade de rede entre o nó de integração e o SCP remoto.

Verifique se o aplicativo remoto suporta a classe SOP de confirmação de armazenamento.

Verifique se os nomes da entidade do aplicativo e os números da porta correspondem exatamente ao SCP remoto.

Verifique se o SCP remoto está online e pronto para aceitar conexões e transferências de dados.

Verifique os detalhes do erro para obter mais informações sobre ele.

Archive da imagem DICOM Uma imagem DICOM está sendo arquivada pelo nó DICOMOutput Informações BIP12068 Archiving DICOM instance from DICOMOutput node (BROKERAE)

O OID da imagem DICOM é registrado no campo FILENAME no log de atividades.

Nenhuma ação é necessária.
Exclusão da imagem DICOM Uma imagem DICOM está sendo excluída do archive DICOMOutput Informações BIP12068 Deleting DICOM instance from DICOMOutput node archive (BROKERAE)

O OID da imagem DICOM é registrado no campo FILENAME no log de atividades.

Nenhuma ação é necessária.

Configurando o Nó DICOMOutput

Quando tiver incluído uma instância de um nó do DICOMOutput 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ó DICOMOutput são descritos na tabela a seguir.
Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Saída O terminal de saída para o qual a mensagem será roteada se a imagem tiver sido transferida com sucesso para o SCP de destino.

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 DICOMOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Nome do Nó Sim Não DICOMOutput 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ó DICOMOutput estão descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Detalhes da Conexão Sim Sim localhost:2222 O nome do host e porta para o SCP de entidade de aplicativo ao qual o nó se conecta.
Título da entidade do aplicativo (AET) Sim Sim BROKERAE O nome para este terminal DICOM SCU. Uma sequência de texto com até 16 caracteres que permite que as entidades do aplicativo sejam identificadas ao se conectarem.
Diretório de processamento Sim Sim Output Um diretório do sistema de arquivos que o nó pode usar para processar imagens DICOM de saída. Esse diretório deve ser exclusivo para esse nó.
Nota: Se a propriedade do nó for um nome de diretório relativo, por exemplo, Output, ela será anexada ao caminho de trabalho do IBM Integration Bus para obter um diretório absoluto. Se a propriedade do nó contiver um nome de diretório absoluto, por exemplo, C:\DICOM\Output), ela será usada diretamente como local do sistema de arquivos.
Título da entidade do aplicativo remoto (AET) Sim Sim REMOTEAE O nome do terminal SCP DICOM ao qual o nó se conecta.
Arquivar imagens DICOM muitas horas depois que elas são enviadas Sim Sim 72 As imagens DICOM são movidas do diretório de processamento para um subdiretório denominado Archive após muitas horas.
Excluir imagens DICOM muitas horas depois que elas chegam Sim Sim 72 As imagens DICOM são excluídas do subdiretório Archive muitas horas depois de arquivadas.
As propriedades Avançadas do nó DICOMOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Tempo limite de conexão (segundos) Sim Sim 60 A duração do tempo, em segundos, que o nó aguarda para estabelecer uma conexão com o SCP.
Prioridade da operação (LOW, NORMAL, HIGH) Sim Sim NORMAL A prioridade para a transferência da imagem para o SCP. Não é obrigatório que o aplicativo de recebimento atue nesta prioridade.
Sequências de codificação com comprimento explícito Não Sim Não selecionado Especifica se as sequências na imagem DICOM são codificadas com um comprimento explícito.
Itens de sequências vazias de codificação com comprimento explícito Não Sim Não selecionado Especifica se os itens de sequência na imagem DICOM são codificados com um comprimento explícito.
Incluir atributos de comprimento do grupo Não Sim Não selecionado Especifica se os grupos de atributos DICOM têm um comprimento especificado.
Sequências vazias de codificação com comprimento explícito Não Sim Selecionados Especifica se as sequências vazias na imagem DICOM são codificadas com um comprimento explícito.
Itens da sequência vazia de codificação com comprimento explícito Não Sim Selecionados Especifica se os itens de sequência vazia na imagem DICOM são codificados com um comprimento explícito.
As propriedades de Confirmação de Armazenamento do nó DICOMOutput são descritas na tabela a seguir.
Propriedade M A Padrão Descrição
Tempo de espera máximo para respostas de confirmação de armazenamento (segundos) Não Sim 60 O tempo máximo de espera por mensagens de resposta de confirmação de armazenamento. Se uma resposta não for recebida nesse período, o nó produzirá um erro.
Receber respostas de confirmação de armazenamento na porta Não Sim 2223 A porta que recebe mensagens de resposta de confirmação de armazenamento. Se este campo estiver em branco, o nó não solicitará mensagens de resposta de confirmação de armazenamento.
Copyright IBM Corporation 2011, 2015Copyright IBM Corporation 2011, 2015.

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


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