ApplyMap — funkcja skryptu
Funkcja skryptu ApplyMap służy do mapowania danych wyjściowych wyrażenia na wcześniej załadowaną tabelę mapowania.
Składnia:
ApplyMap('map_name', expression [ , default_mapping ] )
Typ zwracanych danych: podwójny
Argumenty:
Argument | Opis |
---|---|
map_name |
Nazwa tabeli mapowania, która została utworzona przy użyciu instrukcji mapping load lub mapping select. Nazwa musi być ujęta w pojedyncze proste cudzysłowy. OstrzeżenieJeśli ta funkcja zostanie użyta w zmiennej rozszerzonej przez makro i będzie się odwoływać do nieistniejącej tabeli mapowania, wówczas wywołanie funkcji zakończy się niepowodzeniem i pole nie zostanie utworzone.
|
expression | Wyrażenie, którego wynik powinien być mapowany. |
default_mapping |
W przypadku określenia tej wartości będzie ona używana jako wartość domyślna, jeśli tabela mapowania nie zawiera pasującej wartości wyrażenia expression. Jeśli nie zostanie określona, wartość expression zostanie zwrócona w istniejącej formie. |
Przykład:
W tym przykładzie ładowana jest lista sprzedawców z kodem kraju reprezentującym ich kraj zamieszkania. Używana jest tabela mapująca kod kraju na kraj, aby zastąpić kod kraju jego nazwą. W tabeli mapowania zdefiniowano tylko trzy kraje, inne kody krajów są mapowane na wartość 'Rest of the world'.
Otrzymana tabela (Salespersons) wygląda następująco:
Salesperson | Country |
---|---|
John | Sweden |
Mary | Sweden |
Per | Sweden |
Preben | Denmark |
Olle | Denmark |
Ole | Norway |
Risttu | Rest of the world |