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:
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 |