Processador Map fields
Última atualização: 2026-11-03Pesquisa valores em uma tabela de mapeamento e substitui ou adiciona um campo
O processador Mapear campos permite padronizar ou enriquecer um campo, comparando seus valores com uma tabela de pesquisa, sem escrever script. É o equivalente sem código de carregar uma tabela de mapeamento e aplicá-la com a função ApplyMap no Qlik script.
Uso
O processador Mapear campos requer dois fluxos de entrada:
-
Tabela de origem (fluxo superior): Uma tabela contendo os dados que você deseja mapear para valores na tabela de mapeamento.
-
Tabela de mapeamento (fluxo inferior): Uma tabela contendo os valores a serem consultados e substituídos na tabela de origem.
Mapear campos gera um único fluxo de saída.
Propriedades
Propriedades a serem configuradas para mapear seus campos usando Mapear campos.
| Propriedade | Configuração |
|---|---|
| Campos para aplicar o mapeamento |
Selecione um ou mais campos da tabela de origem cujos valores você deseja consultar na tabela de mapeamento. |
| Mapa do campo |
Selecione o campo na tabela de mapeamento que contém os valores para corresponder aos campos selecionados em Campos para aplicar o mapeamento. Este é o campo chave, ou primeiro, da tabela de mapeamento. |
| Mapear para campo |
Selecione o campo na tabela de mapeamento que contém os valores a serem substituídos na saída. Este é o campo de valor, ou segundo, da tabela de mapeamento. |
| Criar novo campo |
Ative esta opção para gravar os valores correspondentes em um novo campo com nome personalizado, em vez de substituir os valores nos Campos para aplicar mapeamento selecionados. Esta opção está oculta quando mais de um campo é selecionado em Campos para mapear. |
| Valor padrão |
Valor substituído na saída quando um valor de Campos para aplicar o mapeamento não é encontrado no Campo de origem do mapeamento da tabela de mapeamento. |
Para renomear o processador ou editar sua descrição, aponte o mouse sobre o nome ou a descrição a ser alterada no painel Propriedades e clique no ícone 
Editar.
Exemplo
Os dados usados como fonte neste exemplo contêm pedidos de clientes com um campo de duas letras CountryCode que você deseja substituir pelo nome completo do país.
| OrderID | Customer | CountryCode |
|---|---|---|
| 1001 | A. Smith | US |
| 1002 | M. Dupont | FR |
| 1003 | T. Nakamura | JP |
| 1004 | R. Costa | BR |
| Code | CountryName |
|---|---|
| US | United States |
| FR | France |
| JP | Japan |
Conecte ambas as tabelas a um Mapear campos processador e configure as propriedades da seguinte forma:
-
Campos para aplicar mapeamento: Código do País
-
Mapear do campo: Código
-
Mapear para campo: Nome do País
-
Criar novo campo: habilitado, nomeado País
O fluxo de saída mantém todos os campos originais da Tabela de Origem e adiciona um novo campo País. Registros com um CountryCode encontrado na tabela de mapeamento, como US, FR, ou JP, recebem o nome completo do país correspondente. O registro com CountryCode BR, que não está na tabela de mapeamento, recebe o valor padrão Desconhecido.
| OrderID | Customer | CountryCode | Country |
|---|---|---|---|
| 1001 | A. Smith | US | United States |
| 1002 | M. Dupont | FR | France |
| 1003 | T. Nakamura | JP | Japan |
| 1004 | R. Costa | BR | Britain |
