Типы переменных

В данном разделе приведены типы данных, используемые в Платформе при описании объектов, параметров и свойств. Типы данных определяют формат хранения значений и правила их обработки. В отдельных разделах документации могут быть указаны дополнительные ограничения или особенности применения типов данных для конкретных объектов.

• Простые типы:

  • Int.

  • Boolean.

  • String.

  • Decimal.

  • DateTime.

  • Guid.

• Типы данных.

• Внешние типы данных.

• Перечисления.

• Базовые модели.

• Ссылки на базовые модели.

• Пользователи:

  • Пользователь.

  • Роль.

  • Папка пользователей.

• Прочие:

  • Сложное поле.

  • Словарь.

  • Контейнер.

  • Коллекция свойств.

  • Сообщение.

• Пользовательский тип.

• Ссылки.

Простые типы

Простые типы используются для хранения и обработки базовых значений данных, таких как числа, строки, логические значения и дата/время. Каждый простой тип определяет формат хранения значения и допустимые операции над ним.

• Int: целочисленный тип данных, предназначенный для хранения целых чисел без дробной части.

• Boolean: логический тип данных, принимающий одно из двух значений: true или false. При отправке запроса через коннектор Веб-сервис значение параметра автоматически приводится к нижнему регистру (true / false).

• String: строковый тип данных, предназначенный для хранения текстовых значений.

  Параметры типа String:

  • Длина (integer): указывается максимально допустимое количество символов в строке. По умолчанию 50.

  • Max (boolean): при установке флага Платформа позволит хранить длинные строки (больше 50 из примера настройки). По умолчанию флаг не установлен (действует значение из параметра Длина).

  • Обрезать автоматически (boolean): если флаг установлен, то строка автоматически обрезается до допустимого числа символов (параметр Длина). По умолчанию флаг не установлен (если фактическая длина превышает значение настройки Длина, выведется ошибка).

  

• Decimal: числовой тип данных с плавающей точкой, предназначенный для хранения чисел с дробной частью.

  Параметры типа Decimal:

  • Точность (integer): указывается общее количество цифр, которые могут храниться в числе — как до запятой, так и после нее. По умолчанию 5, то есть число может содержать максимум 5 цифр.

  • Масштаб (integer): указывается количество знаков после запятой, которые допускаются в числе (например, если в настройке 2 = 123.12). По умолчанию 0, то есть число хранится как целое (без значений после запятой).

  • Округлять автоматически (boolean): флаг определяет, что делать, если значение имеет больше знаков после запятой, чем указано в масштабе. Если включен, то значение автоматически округляется (например, Масштаб 2, значение пришло 123.126, то будет округлено - 123.13; если Масштаб 0 - 124). По умолчанию флаг не установлен (значение не будет округляться).

  

• DateTime: тип данных, предназначенный для хранения даты и времени. При преобразовании из внешнего типа данных значения с годом меньше 1900 автоматически приводятся к значению 1900-01-01T00:00:00.

  Параметры типа DateTime:

  • Тип данных (enum): настройка формата вывода времени, если не выбран Тип данных, то выводятся все значения.

  • Без часового пояса: указываются дата и время с локальным часовым поясом (то есть время будет указываться, но без учета принадлежности к UTC).

  • UTC: дата и время приводятся к универсальному координированному времени.

  • Локальное: указываются дата и время с локальным часовым поясом.

  • Обрезать автоматически (boolean): если установлен флаг, Платформа сама приводит значение к допустимому формату, если во входящих данных были дополнения. По умолчанию флаг не установлен (сохраняет входные данные без изменения).

  

• Guid: тип данных, представляющий глобально уникальный идентификатор объекта.