Nó Extract

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

Finalidade

Utilize o nó Extract para extrair o conteúdo da mensagem de entrada que deseja que seja processado por nós posteriores no fluxo de mensagens. Utilizando o nó Extract, você pode criar uma nova mensagem de saída que contém apenas um subconjunto do conteúdo da mensagem de entrada. A mensagem de saída inclui apenas os elementos da mensagem de entrada que você especifica para inclusão durante a configuração do nó Extract, definindo instruções de mapeamento.

O nó Extract é representado no workbench pelo seguinte ícone:

 Ícone do nó Extract

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 toda a mensagem para finalidades de auditoria (no nó Warehouse), mas propagar apenas uma pequena parte da mensagem (talvez informações do pedido) para processamento adicional.

Você recebe pedidos de novos clientes e deseja coletar seus nomes e endereços para promoções futuras. Para fazer isso, utilize o nó Extract para obter essas informações de cada pedido e envie-as como uma nova mensagem para a administração. Essas mensagens são processadas na matriz para que os detalhes dos clientes possam ser incluídos na próxima campanha de marketing.

Configurando o Nó Extract

Quando tiver colocado uma instância do nó Extract em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito do mouse no nó da tela do editor e selecione Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades mandatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó Extract da seguinte forma:

  1. Em Módulo de Mapeamento, identifique a rotina de mapeamento associada, que deve ser executada nesse nó. Por padrão, o nome atribuído à rotina de mapeamentos é idêntica ao nome do arquivo de mapeamentos no qual essa rotina é definida. O nome padrão para o arquivo é o nome do fluxo de mensagens concatenado com o nome do nó quando você incluí-lo no fluxo de mensagens (por exemplo, MFlow1_Extract.mfmap para o primeiro nó Extract no fluxo de mensagens do MFlow1). Você não pode especificar um valor que inclui espaços.

    Se você clicar em Procurar próximo ao campo de entrada,um diálogo é exibido, listando todas as rotinas de mapeamento disponíveis, acessíveis por esse nó. Selecione a rotina desejada e clique em OK.O nome da rotina é definida em Módulo de Mapeamento.

    Para trabalhar com a rotina de mapeamentos associada a esse nó, clique com o botão direito do mouse no nó e selecione 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, você poderá abrir o arquivo <flow_name>_<node_name>.mfmap na visualização Navegador.

    Uma rotina de mapeamento é específica ao tipo de nó com o qual está associada; você não pode utilizar uma rotina de mapeamento que tenha desenvolvido para um nó Extract com qualquer outro nó que utilize os mapeamentos (por exemplo, o 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.

  2. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  3. Clique em Aplicar para fazer as alterações no nó Extract sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Terminais e Propriedades

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 é mandatória (marcado com um asterisco no diálogo de propriedades 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 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. A rotina é exclusiva para esse tipo de nó.

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

Propriedade M C Padrão Descrição
Descrição Breve 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.
Referências relacionadas
Nó Database
Nó Datalnsert
Nó Mapping
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04710_