Etapa Procurar

A etapa Procurar pesquisa um valor-chave em uma base de dados e traz as colunas correspondentes para a saída, de forma similar ao PROCV. Use quando precisar enriquecer um conjunto de dados com informações que estão em outra fonte. A Procurar fica na categoria Combinação da barra de ferramentas.

Como configurar

A etapa precisa de duas transições de entrada: a base onde a procura é feita (Porta B) e a fonte com o valor a ser procurado (Porta P). Defina a regra de procura e escolha as colunas que devem aparecer na saída.

• Regra de Procura: define como o valor é pesquisado, combinando três campos. Você pode criar mais de uma regra no botão + e remover uma regra pelo ícone de lixeira. O status da chave pode ser Válido ou Inválido.

• Valor do Campo Base: campo com todas as colunas da transição de entrada que servem de referência para a procura.

• Operador: define o critério da comparação, entre Igual, Contém, Maior ou Igual, Menor e Menor ou Igual.

• Campo de Procura: indica a coluna pesquisada. Ela precisa ter o mesmo tipo de dado do Valor do Campo Base.

• Selecionar Colunas de Resultado: define e, se quiser, renomeia as colunas que farão parte da saída da etapa.

• Selecionar: escolhe uma ou mais colunas que farão parte da regra de procura. Por padrão, todas as colunas vêm selecionadas.

• Status da Coluna: indica se a coluna está Válido ou Inválido. O status fica Inválido quando a coluna usada na configuração é excluída na etapa de entrada, ou quando o tipo de dado dela é alterado na etapa de entrada. Nesse status, a plataforma permite excluir a coluna.

• Entrada: identifica a qual porta a coluna pertence, B (dados base) ou P (dados de procura).

• Nome na Origem: mostra todas as colunas da etapa de entrada de cada porta. Os valores dessa coluna não são editáveis.

• Renomear Coluna: permite alterar o nome que a coluna terá na saída da etapa.

• Botão Fechar: fecha a tela sem salvar e volta ao Designer.

• Botão Salvar: salva as configurações.

Exemplo de utilização

Considere duas fontes de entrada. A base (Porta B) tem as colunas Negócio, Data, Conta, Valor e Descrição, com quatro registros (dois do negócio A e dois do negócio B). A fonte de procura (Porta P) tem as colunas Negócio, Descrição e Departamento, com dois registros do negócio A (Despesas 1 e Creditos 1).

O objetivo é procurar na Porta P as informações que correspondem à base. Para isso, configure duas regras com o operador Igual: Negócio confrontado com Negócio, e Descrição confrontada com Descrição. Em seguida, selecione as colunas de resultado Negócio, Data, Conta, Valor, Descrição e Departamento.

A saída repete os quatro registros da base, agora acrescidos da coluna Departamento sempre que houve correspondência: os registros do negócio A recebem Contas a Pagar e Contas a Receber, enquanto os registros do negócio B permanecem sem departamento por não terem correspondência.

Artigos relacionados

• Etapa Mesclar

• Etapa Consolidar