Поддерживаемые примитивные типы данных для формул электронной отчетности
В этой статье содержится информация о примитивных типах данных, которые поддерживаются в выражениях электронной отчетности (ER). Ниже приведен список примитивных типов данных:
Логический
Примитивный тип данных логический содержит значение, которое вычисляется как true или false. Зарезервированные ключевые слова-литералы True и False можно использовать везде, где предполагается выражение типа логический. Значение по умолчанию равно false.
Внутреннее представление типа логический является типом целое число. Значение 0 (ноль) типа целое число вычисляется как false, а любые другие значения типа целое число вычисляются как true. При проверке настроенного выражения, которое возвращает значение типа логический в конструкторе формул электронной отчетности, панель результата проверки показывает 0 (ноль), когда выражение возвращает значение false. В противном случае на панели результатов проверки представлено значение 1.
Тип логический не имеет неявных преобразований. Однако для явного преобразования логического значения типа логический в значение типа строка можно использовать функцию TEXT:
- Значение false преобразуется в текстовую строку False.
- Значение true преобразуется в текстовую строку True.
Примечание
Это преобразование не зависит от указанного языка и контекста культуры.
Операторы сравнения — это единственный тип оператора, который может использоваться с типом данных логический. Для сравнения двух значений типа логический можно использовать следующие операторы: <> и =.
Дата
Примитивный тип данных дата содержит информацию о дне, месяце и годе. Даты могут быть инициированы с помощью следующих функций:
Тип данных дата может содержать даты между 1 января, 1900 года и 31 декабря 2154 года. Значение по умолчанию — null, а внутреннее представление — это дата 1 января 1900 года.
Тип дата не имеет неявных преобразований. Однако можно использовать следующие функции явного преобразования:
Функция ADDDAYS позволяет добавлять и вычитать дни из дат. Таким образом можно переместить дату на конкретное количество дней в будущее и в прошлое. Функция DAYS позволяет вычитать даты друг из друга и рассчитать разницу в днях. Дополнительные сведения о преобразовании значений типа дата см. в разделе Список функций электронной отчетности в категории "Дата и время".
Операторы сравнения — это единственный тип оператора, который может использоваться с типом данных дата. Для сравнения двух значений типа дата можно использовать следующие операторы: <>, <, <=, =, > и >=.
Дата и время
Примитивный тип данных дата и время объединяет тип дата и значение, представляющее время, прошедшее с полуночи. Время выражается в часах, минутах, секундах и долях секунды. Значение дата и время также содержит сведения о часовом поясе.
Тип данных дата и время может содержать даты между 1 января 1900 года (1900-01-01T00:00:00.0000000+00:00 в круговом формате) и 31 декабря 2154 года (2154/12/31T11:59:59.9999999+00:00 в круговом формате). Наименьшая единица времени в типе дата и время составляет одну десятимиллионную долю секунды.
Примечание
Когда спецификаторHH используется для часов, значения времени более 12:59:59:9999999 не могут интерпретироваться как допустимое время.
Когда спецификатор HH используется для часов, значения времени более 23:59:59:9999999 не могут интерпретироваться как допустимое время.
Значение по умолчанию — null, а внутреннее представление — это дата 1 января 1900 (1900-01-01T00:00:00.0000000+00:00 в круговом формате).
Значения даты и времени могут быть инициированы с помощью следующих функций:
Тип дата и время не имеет неявных преобразований. Однако можно использовать следующие функции явного преобразования:
Дополнительные сведения о преобразовании значений типа дата и время см. в разделе Список функций электронной отчетности в категории "Дата и время".
Операторы сравнения — это единственный тип оператора, который может использоваться с типом данных дата и время. Для сравнения двух значений типа дата и время можно использовать следующие операторы: <>, <, <=, =, > и >=.
Перечисление
Примитивный тип данных перечисление представляет собой список литералов. Можно использовать перечисления, определенные в исходном коде приложения. Можно также представить собственные перечисления в модели данных электронной отчетности и компонентах формата электронной отчетности.
Перечисление приложений может использоваться в выражениях с любым сопоставлением модели электронной отчетности и формата электронной отчетности.
На следующем рисунке показано, как можно добавить перечисление модели CustVendCorrectiveReasonCode к редактируемой модели данных электронной отчетности.
Перечисление моделей может использоваться в выражениях любого сопоставления модели электронной отчетности и формата электронной отчетности, которые были созданы в модели данных, в которой было введено перечисление.
На следующем рисунке показано, как можно добавить перечисление формата Список подкатегорий удержания с покупателей Natura для редактируемого формата электронной отчетности.
Перечисление форматов может использоваться только в выражениях формата электронной отчетности, в котором было введено перечисление.
Необходимо использовать соответствующий тип источников данных электронной отчетности, чтобы ввести определенное перечисление в настроенный компонент электронной отчетности в качестве константы или в качестве значения, которое пользователь, запускающий решение электронной отчетности, определил в диалоговом окне во время выполнения.
Перечисления приложений могут быть доступны с помощью источников данных Dynamics 365 for Operations\Перечисление и Общие\Входные параметры пользователя. На следующем рисунке показано, как можно добавить к редактируемому формату электронной отчетности источники данных appenumNoYes и uipNoYes, которые ссылаются на перечисление приложения NoYes.
Перечисления моделей данных могут быть доступны с помощью источников данных Модель данных\Перечисление и Модель данных\Входные параметры пользователя перечисления. На следующем рисунке показано, как можно добавить к редактируемому формату электронной отчетности источник данных CustVendCorrectiveReasonCode, который ссылается на перечисление модели данных CustVendCorrectiveReasonCode.
Перечисления форматов могут быть доступны с помощью источников данных Формат\Перечисление и Формат\Входные параметры пользователя перечисления. На следующем рисунке показано, как можно добавить к редактируемому формату электронной отчетности источник данных NaturaReverseCharge, который ссылается на перечисление формата Подкатегории удержания с покупателей Natura.
Тип перечисление не имеет неявных преобразований. Однако можно использовать функцию преобразования TEXT для преобразования типа перечисление в текстовую строку. Это преобразование не зависит от языка. Чтобы узнать, как можно связать значение типа перечисление с соответствующими метками для определенного языка, см. примеры использования функций LISTOFFIELDS и GETENUMVALUEBYNAME.
Операторы сравнения — это единственный тип оператора, который может использоваться с типом данных перечисление. Для сравнения двух значений перечисление можно использовать следующие операторы: <> и =.
Guid
Примитивный тип данных guid содержит значение глобального уникального идентификатора (GUID). GUID — это значение, которое может использоваться всеми компьютерами и сетями везде, где требуется уникальный идентификатор. Маловероятно, чтобы номер был дублирован. Допустимый идентификатор GUID соответствует всем следующим спецификациям:
- Должно быть 32 шестнадцатеричных цифры.
- Кроме того, должно быть четыре знака дефиса, которые встраиваются в следующие местоположения: 8-4-4-4-12.
- Кроме того, в начале и конце строки могут быть добавлены необязательные скобки {}. Например, {2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212} и 2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212 являются допустимыми строками GUID.
- Таким образом, в зависимости от того, добавлены ли скобки, должно быть всего 36 или 38 символов.
- Буквы, используемые в качестве шестнадцатеричных цифр, могут быть прописными (A–F), строчными (a–f) или смешанными.
Можно использовать следующие функции явного преобразования:
Операторы сравнения — это единственный тип оператора, который может использоваться с типом данных guid. Для сравнения двух логических значений guid можно использовать следующие операторы: <> и =.
Целое число
Примитивный тип данных целое число представляет число, не имеющее дробных десятичных знаков. Целые числа используются как переменные управления в повторяющихся инструкциях или в качестве индексов в списках записей.
Литерал типа целое число — это целое число, которое вводится непосредственно в выражение (формулу) электронной отчетности, например 12345. Тип целое число имеет длину 32 бита. Значение по умолчанию равно 0, а внутреннее представление — длинное число. Тип целое число автоматически преобразуется в тип вещественное число.
Кроме того, можно использовать следующие функции явного преобразования:
Диапазон значений типа целое число: [-2 147 483 647 : 2 147 483 647]. Все целые числа этого диапазона могут использоваться как литералы.
Для типа данных целое число могут использоваться все операторы сравнения и математические операторы.
Int64
Примитивный тип данных int64 представляет число, не имеющее дробных десятичных знаков. Значения Int64 используются как переменные управления в повторяющихся инструкциях или в качестве идентификаторов записей.
Целое число int64 имеет длину 64 бита. Значение по умолчанию равно 0, а внутреннее представление — длинное число. Целое число int64 автоматически преобразуется в тип вещественное число.
Кроме того, можно использовать следующие функции явного преобразования:
Диапазон значений типа int64: [-9,223,372,036,854,775,807 : 9,223,372,036,854,775,807].
Для типа данных int64 могут использоваться все операторы сравнения и математические операторы.
Действующий
Примитивный тип данных вещественное число может содержать десятичные значения в дополнение к целым числом. Десятичные литералы можно использовать везде, где ожидается вещественное значение вещественное число. Десятичный литерал — это десятичное число, введенное непосредственно в коде, например 2,19.
Примечание
В выражениях электронной отчетности точка (.) всегда используется в качестве десятичного разделителя.
Вещественные числа могут использоваться во всех выражениях и использоваться в операторах сравнения и арифметических операторах. Точность типа вещественное число равна 16 значащим цифрам. Значение по умолчанию для типа вещественное число равно 0,0, а внутреннее представление — это число в двоичной кодировке (BCD). Кодировка BCD обеспечивает точное представления значений, кратных 0,1. Диапазон значений переменной типа вещественное число составляет от -(10)127 до (10)127. Все вещественные числа в этом диапазоне могут использоваться как литералы в выражениях электронной отчетности.
Тип вещественное число не имеет неявных преобразований. Однако можно использовать следующие функции для явного преобразования значений типа вещественное число в другие типы данных и других типов данных в тип вещественное число:
Для типа данных вещественное число могут использоваться все операторы сравнения и математические операторы.
Строка
Примитивный тип данных строка представляет собой последовательность символов, используемых в качестве текстов, номеров счетов, адресов и телефонных номеров.
Строковые литералы — это символы, заключенные в кавычки (""). Строковые литералы типа могут использоваться везде, где ожидается использование значений типа строка в выражениях электронной отчетности. Строки можно использовать в логических выражениях, например в сравнениях. Кроме того, можно сцеплять значения типа строка, используя оператор & или функцию CONCATENATE.
Примечание
Если объединяются два значения типа строка и требуется, чтобы результирующее значение типа строка занимало более одной строки, используйте разделитель разрыва строки между значениями. Для вывода TEXT этот разделитель может быть символом, созданным с использованием выражения CHAR(10) или CHAR(13). Для HTML это может быть тег <br>.
Значением по умолчанию для типа строка является пустая текстовая строка, которая не содержит символов, а внутреннее представление представляет собой список символов.
Автоматические преобразования для строк отсутствуют. Однако можно использовать следующие функции явного преобразования:
Дополнительные сведения о преобразовании значений типа строка см. в разделе Список функций электронной отчетности в категории "Текст".
Значение типа строка может содержать неограниченное количество символов.
Для типа данных строка могут использоваться все операторы сравнения.
Дополнительные ресурсы
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по