ApplyMap — функция скрипта
Функция скрипта ApplyMap используется для сопоставления результата выражения с ранее загруженной таблицей сопоставления.
Синтаксис:
ApplyMap('map_name', expression [ , default_mapping ] )
Возвращаемые типы данных: двойное значение
Аргументы:
Аргумент | Описание |
---|---|
map_name |
Имя таблицы сопоставления, созданной ранее с помощью операторов mapping load или mapping select. Имя таблицы должно быть заключено в одинарные прямые кавычки. Примечание к предупреждениюЕсли функция используется в развернутой переменной макроса со ссылкой на несуществующую таблицу сопоставления, происходит сбой вызова функции и поле не создается.
|
expression | Выражение, результат которого должен быть сопоставлен. |
default_mapping |
Если это значение задано, оно будет использовано как значение по умолчанию, если таблица сопоставления не содержит совпадающего значения для параметра expression. Если значение не задано, то значение параметра expression выводится как есть. |
Пример:
В этом примере мы загружаем список продавцов с кодом страны, представляющим их страну проживания. Мы используем таблицу, соответствующую коду страны, для той страны, код которой будет заменен ее названием. В таблице сопоставления указаны только три страны, коды других стран указаны в параметре 'Rest of the world'.
Полученная таблица («Менеджеры по продажам») выглядит следующим образом:
Salesperson | Country |
---|---|
John | Sweden |
Mary | Sweden |
Per | Sweden |
Preben | Denmark |
Olle | Denmark |
Ole | Norway |
Risttu | Rest of the world |