ApplyMap - scriptfunctie
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. WaarschuwingWanneer u deze functie gebruikt in een variabele die met een macro is uitgebreid en verwijst naar een toewijzingstabel die niet bestaat, mislukt het aanroepen van de functie 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 (Salespersons) ziet er als volgt uit:
Salesperson | Country |
---|---|
John | Sweden |
Mary | Sweden |
Per | Sweden |
Preben | Denmark |
Olle | Denmark |
Ole | Norway |
Risttu | Rest of the world |