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:
| 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. 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á. |
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'.
A tabela resultante (Salespersons) se parece com isto:
| Salesperson | Country |
|---|---|
| John | Sweden |
| Mary | Sweden |
| Per | Sweden |
| Preben | Denmark |
| Olle | Denmark |
| Ole | Norway |
| Risttu | Rest of the world |