Este tópico contém as seguintes seções:
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:
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.
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:
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.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas 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. |