Die Skriptfunktion ApplyMap wird verwendet, um das Ergebnis einer Formel einer zuvor geladenen Mapping-Tabelle zuzuordnen.
Syntax:
ApplyMap('map_name', expression [ , default_mapping ] )
Rückgabe Datentyp: dual
Argumente:
| Argument | Beschreibung |
|---|---|
| map_name |
Der Name einer Mapping-Tabelle, die durch den Befehl mapping load oder mapping select erstellt wurde. Der Name muss in einfachen Anführungszeichen stehen. WarnhinweisWenn Sie diese Funktion in einer makroerweiterten Variablen verwenden und auf eine nicht vorhandene Mapping-Tabelle verweisen, schlägt der Funktionsaufruf fehl, und das Feld wird nicht erstellt.
|
| expression | Die Formel, deren Ergebnis zugeordnet werden sollte. |
| default_mapping |
Sofern angegeben, wird dieser Wert als Standardwert verwendet, wenn die Mapping-Tabelle keine mit expression übereinstimmenden Werte enthält. Bei fehlender Angabe bleibt der Wert von expression unverändert. |
Beispiel:
In diesem Beispiel wird eine Liste von Verkäufern mit einem Ländercode geladen, der den Wohnsitzstaat enthält. Eine Tabelle, in der die Ländercodes den einzelnen Ländern zugeordnet sind, wird dazu verwendet, den Ländercode durch den tatsächlichen Namen des jeweiligen Landes zu ersetzen. Nur drei Länder sind in Mapping-Tabelle definiert, die anderen Ländercodes sind 'Rest of the world' zugeordnet.
Die sich ergebende Tabelle (Salespersons) sieht folgendermaßen aus:
| Salesperson | Country |
|---|---|
| John | Sweden |
| Mary | Sweden |
| Per | Sweden |
| Preben | Denmark |
| Olle | Denmark |
| Ole | Norway |
| Risttu | Rest of the world |