La fonction de script ApplyMap permet de mapper le résultat d'une expression à une table de mappage déjà chargée.
ApplyMap('map_name', expression [ , default_mapping ] )
double
| Argument | Description |
|---|---|
| map_name |
Nom d'une table de mappage créée précédemment à l'aide de l'instruction mapping load ou mapping select. Son nom doit être mis entre guillemets simples droits. Note AvertissementSi vous utilisez cette fonction dans une variable d'expansion de macro et faites référence à une table de mappage qui n'existe pas, l'appel de fonction se solde par un échec et aucun champ n'est créé.
|
| expression | Expression dont le résultat doit être mappé. |
| default_mapping |
Si l'argument est indiqué, cette valeur sera utilisée comme valeur par défaut lorsque la table de mappage ne contient pas de valeur correspondante pour expression. Si l'argument n'est pas précisé, la valeur de l'expression est renvoyée telle quelle. |
Dans cet exemple, nous chargeons une liste de représentants commerciaux accompagnés du code pays représentant leur pays de résidence. Nous utilisons une table mappant un code pays à un pays pour remplacer le code pays par le nom du pays. Seulement trois pays sont définis dans la table de mappage ; les autres codes pays sont mappés à l'entrée 'Rest of the world' (Autre pays).
La table résultante (Salespersons) a l'aspect suivant :
| Salesperson | Country |
|---|---|
| John | Sweden |
| Mary | Sweden |
| Per | Sweden |
| Preben | Denmark |
| Olle | Denmark |
| Ole | Norway |
| Risttu | Rest of the world |
