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: dual
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 zostanie utworzone odniesienie do tabeli mapowania, która nie istnieje, wówczas wywołanie funkcji nie powiedzie się, a 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'.
Tabela wynikowa (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 |