# ApplyMap - função de script

A função de script ApplyMap é usada para mapear a saída de uma expressão para uma tabela de mapeamento carregada anteriormente.

Sintaxe:

ApplyMap('map\_name', expression [ , default\_mapping ] )

Tipo de dados de retorno: dual

Argumentos:

Argumentos ApplyMap

| Argumento | Descrição |
| --- | --- |
| map\_name | O nome de uma tabela de mapeamento que foi criada anteriormente com a declaração mapping load ou mapping select. O nome deve estar entre aspas simples.<br><br>Nota de advertênciaSe você usar essa função em uma variável de macro expandida e fizer referência a uma tabela de mapeamento que não existe, a chamada de função falhará, e um campo não será criado. |
| expression | A expressão cujo resultado deve ser mapeado. |
| default\_mapping | Se indicado, esse valor será usado como um valor padrão, se a tabela de mapeamento não contiver nenhum valor correspondente a expression. Se nada for indicado, o valor de expression será retornado como está. |

Nota de advertênciaO campo de saída de ApplyMap não deve ter o mesmo nome que um dos campos de entrada. Isso pode causar resultados inesperados. Exemplo para não usar: ApplyMap('Map', A) como A.

Exemplo:

Neste exemplo, carregamos uma lista de vendedores com um código de país representando seu país de residência. A tabela é usada para mapear o código de um país a um país para substituir o código pelo nome do país. Somente três países estão definidos na tabela de mapeamento, outros códigos de países estão mapeados para 'Rest of the world'.

```
// Load mapping table of country codes: map1: mapping LOAD *  Inline [ CCode, Country Sw, Sweden Dk, Denmark No, Norway ] ;  // Load list of salesmen, mapping country code to country // If the country code is not in the mapping table, put Rest of the world Salespersons: LOAD *,  ApplyMap('map1', CCode,'Rest of the world') As Country  Inline [ CCode, Salesperson  Sw, John Sw, Mary Sw, Per  Dk, Preben Dk, Olle No, Ole  Sf, Risttu ] ;  // We don't need the CCode anymore Drop Field 'CCode';
```

A tabela resultante tem a seguinte aparência:

Example 1

| Salesperson | Country |
| --- | --- |
| John | Sweden |
| Mary | Sweden |
| Per | Sweden |
| Preben | Denmark |
| Olle | Denmark |
| Ole | Norway |
| Risttu | Rest of the world |

## Saiba mais

* [](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptPrefixes/Mapping.htm)[Mapping](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptPrefixes/Mapping.htm)
* [Usando aspas no script](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/use-quotes-in-script.htm)