De scriptfunctie ApplyMap wordt gebruikt voor het toewijzen van de uitvoer van een uitdrukking aan een eerdere geladen toewijzingstabel.
Syntaxis:
ApplyMap('map_name', expression [ , default_mapping ] )
Retourgegevenstypen: dual
Argumenten:
| Argument | Beschrijving |
|---|---|
| map_name |
De naam van een toewijzingstabel die eerder is gemaakt met de opdracht mapping load of mapping select. De naam moet tussen enkele, rechte aanhalingstekens staan. WaarschuwingAls u deze functie gebruikt voor een variabele die is uitgebreid met een macro en verwijst naar een toewijzingstabel die niet bestaat, geeft de functie een fout weer en wordt er geen veld gemaakt.
|
| expression | De uitdrukking waarvan het resultaat moet worden toegewezen. |
| default_mapping |
Als de uitdrukking is opgegeven, wordt deze waarde gebruikt als standaardwaarde als de toewijzingstabel geen overeenkomstige waarde bevat voor expression. Als de uitdrukking niet is opgegeven, wordt de waarde van expression ongewijzigd geretourneerd. |
Voorbeeld:
In dit voorbeeld laden wij een lijst met verkopers waarbij een landcode het land aangeeft waar zijn wonen. Wij gebruiken een tabel waarin een landcode wordt toegewezen aan een land ter vervanging van de landcode door de landnaam. Er zijn slechts drie landen gedefinieerd in de toewijzingstabel, andere landcode worden toegewezen aan 'Rest of the world'.
De resulterende tabel (Verkopers) ziet er als volgt uit:
| Salesperson | Country |
|---|---|
| John | Sweden |
| Mary | Sweden |
| Per | Sweden |
| Preben | Denmark |
| Olle | Denmark |
| Ole | Norway |
| Risttu | Rest of the world |