WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Extract

Utilize o nó Extract para extrair o conteúdo da mensagem de entrada que deve ser processada por nós posteriores no fluxo de mensagens.

Restrição: As funções fornecidas por esse nó foram substituídas por um Nó Mapeamento revisado. Se você importar um fluxo de mensagens que contenha o nó Extract, poderá continuar visualizando-o e implementando-o, mas não poderá modificá-lo.

Este tópico contém as seguintes seções:

Finalidade

Utilizando o nó Extract, você pode criar uma nova mensagem de saída que contenha somente um subconjunto do conteúdo da mensagem de entrada. A mensagem de saída é composta apenas por aqueles elementos da mensagem de entrada que você especifica para inclusão durante a configuração do nó Extract, definindo instruções de mapeamento.

Utilizando este nó em um fluxo de mensagens

Você pode achar este nó útil se precisar apenas de um subconjunto da mensagem após o processamento inicial de toda a mensagem. Por exemplo, talvez você queira armazenar a mensagem inteira para fins de auditoria (no nó Warehouse), e propagar somente uma pequena parte da mensagem (informações sobre ordem, talvez) para processamento futuro.

Por exemplo, você recebe pedidos de novos clientes e deseja coletar seus nomes e endereços para promoções futuras. Utilize o nó Extract para obter essa informação de cada ordem e enviá-la como uma nova mensagem para a matriz. Essas mensagens são processadas na matriz para que os detalhes dos clientes possam ser incluídos na próxima campanha de marketing.

Terminais e Propriedades

Quando tiver colocado uma instância do nó Extract em um fluxo de mensagens, você poderá configurá-lo. Para obter informações adicionais, consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. (Se você der um clique duplo no nó Extract, abrirá a caixa de diálogo Novo Mapa de Mensagem.) Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

Os terminais do nó Extract são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem de entrada será roteada se for detectado um defeito durante a extração.
Saída O terminal de saída para o qual a mensagem transformada será roteada se a mensagem de entrada for processada com êxito.

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 no arquivo BAR para implementá-lo).

As propriedades Descrição do nó Extract são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não Extract O nome do nó.
Short description Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó Extract são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Módulo de mapeamento Sim Não Extract O nome da rotina de mapeamento que contém as instruções a serem executadas na árvore de mensagens.

Por padrão, o nome designado à rotina de mapeamento é idêntico ao nome do arquivo de mapeamentos no qual a rotina é definida. O nome padrão para o arquivo é o nome do fluxo de mensagens concatenado com o nome do nó quando você o inclui no fluxo de mensagens (por exemplo, MFlow1_Extract.msgmap para o primeiro nó Extract no fluxo de mensagens MFlow1). Você não pode especificar um valor que inclui espaços.

Para trabalhar com a rotina de mapeamentos associada a esse nó, clique com o botão direito do mouse no nó e clique em Abrir Mappings. Se a rotina de mapeamento não existir, ela será criada com o nome padrão no arquivo padrão. Se o arquivo já existir, será possível também abrir o arquivo flow_name_node_name.msgmap no Visualização Desenvolvimento do Broker.

Uma rotina de mapeamento é específica para o tipo de nó ao qual ela está associada; você não pode utilizar uma rotina de mapeamento que você desenvolveu para um nó Extract com qualquer outro nó que utilize mapeamentos (por exemplo, um nó DataInsert). Se você criar uma rotina de mapeamento, não será possível chamá-la a partir de outra rotina de mapeamento, embora seja possível chamá-la a partir de uma rotina ESQL.

Para obter informações adicionais sobre o trabalho com os arquivos de mapeamento, e a definição de seu conteúdo, consulte Usando Mapas de Dados Gráficos.

As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:18


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04710_