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.
Este tópico contém as seguintes seções:
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.
O nó Extract está contido no repositório Banco de Dados da paleta e é representado no ambiente de trabalho 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 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.
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. Para exibir as propriedades do nó no diálogo Propriedades, clique com o botão direito do mouse no nó e clique em 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 |
---|---|
In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Failure | O terminal de saída para o qual a mensagem de entrada será roteada se for detectado um defeito durante a extração. |
Out | 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ó. |
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. |
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, você também pode abrir o arquivo flow_name_node_name.msgmap na visualização Desenvolvimento do Intermediário. 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 Desenvolvendo Mapeamentos de Mensagens. |