Функция ER LISTOFFIELDS
Функция LISTOFFIELDS возвращает значение Список записей, созданное на основе структуры указанного аргумента типа Перечисление или Контейнер (запись).
Синтаксис 1
LISTOFFIELDS (path)
Синтаксис 2
LISTOFFIELDS (path, language)
Аргументы
path: Ссылка на источник данных
Действительный путь ссылки источника данных одного из следующих типов данных:
- Перечисление модели
- Перечисление форматов
- Перечисление приложений
- Контейнер (запись)
language: Строка
Текст, представляющий код языка.
Возвращаемые значения
Список записей
Полученный список записей.
Примечания по использованию
Созданный список состоит из записей, которые имеют следующие поля:
- Имя (тип данных Строка)
- Метка (тип данных Строка)
- Описание (тип данных Строка)
- IsTranslated (тип данных Логический)
Если аргумент path относится к источнику данных типа Контейнер (запись), для каждого поля записи контейнера, на которую есть ссылка , новая запись добавляется в созданный список. Для каждой созданной записи поле Имя возвращает имя поля записи контейнера, на которую ест ссылка, для которого была создана текущая запись.
Если аргумент path относится к источнику данных одного из типов Перечисление, для каждого значения перечисления, для которого есть ссылка , новая запись добавляется в созданный список. Для каждой созданной записи поле Имя возвращает значение перечисления, на которое есть ссылка, для которого была создана текущая запись, поле Описание возвращает описание этого перечисления, а поле Метка возвращает метку этого перечисления.
Во время выполнения, когда используется синтаксис 1, поля Метка и Описание должны возвращать значения, основанные на настройках языка формата электронной отчетности (ER), который используется:
- Если доступны метки и описания для запрашиваемого языка, поля Метка и Описание возвращают значения, основанные на этом языке, и поле IsTranslated возвращает True.
- Если метки и описания для запрашиваемого языка недоступны, поля Метка и Описание возвращают значения, основанные на языке по умолчанию EN-US, и поле IsTranslated возвращает False.
Во время выполнения, когда используется синтаксис 2, поля Метка и Описание должны возвращать значения, основанные на языке, который задан как второй аргумент вызываемой функции:
- Если доступны метки и описания для запрашиваемого языка, поля Метка и Описание возвращают значения, основанные на этом языке, и поле IsTranslated возвращает True.
- Если метки и описания для запрашиваемого языка недоступны, поля Метка и Описание возвращают значения, основанные на языке EN-US, и поле IsTranslated возвращает False.
Пример 1
На следующем рисунке показано перечисление, введенное в модели данных ER.
Следующая иллюстрация показывает эти детали:
- Перечисление модели, вставленное в отчет в качестве источника данных.
- Выражение ER использует перечисление модели как параметр функции
LISTOFFIELDS. - Источник данных типа Список записей вставляется в отчет с помощью созданного выражения ER.
В следующем примере показано элементы формата электронной отчетности, которые привязаны к источнику данных типа Список записей, который был создан с помощью функции LISTOFFIELDS.
На следующем рисунке показан результат выполнения созданного формата.
Примечание
На основе параметров языка родительских элементов формата FILE и FOLDER переведенный текст для меток и описаний вводится в выходные данные формата электронной отчетности.
Пример 2
Можно использовать тип источника данных Вычисляемое поле для настройки источников данных enumType_de и enumType_deCH для перечисления модели данных enumType.
- enumType_de =
LISTOFFIELDS (enumType, "de") - enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
В этом случае можно использовать следующее выражение для получения метки значения перечисления на немецком языке (Швейцария), если этот перевод доступен. Если перевод со швейцарского на немецкий не поддерживается, подпись появляется на немецком языке.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)