Типы данных

Когда вы добавляете поле в тип сущности, вы выбираете один из девяти типов данных. Тип данных определяет, какое значение хранит поле и какие параметры для него доступны.

В интерфейсе поле называется «типом данных». В REST API то же самое называется переменной. На этой странице используется «тип данных», как в интерфейсе.

Справочник по типам данных

Тип данных Поддерживает импорт строк данных Описание и параметры

Строка

Да

Произвольный текст.

Целое

Да

Целое число.

Дробное

Да

Десятичное число (с плавающей точкой).

Дата-время

Да

Дата или дата со временем. Параметр Точность определяет, хранит поле только дату или дату со временем: + * День — только дата, без времени. * Секунда — дата и время с точностью до секунды. + Точность можно изменить после создания поля, но изменение у поля, которое уже используется, может повлиять на интеграции, получающие это значение.

Ссылка

Да

Ссылка на одну запись другого типа сущности. Когда вы добавляете поле-ссылку, вы выбираете целевой тип сущности — вид записи, на которую указывает поле. + Поле-ссылка может также указывать на файл. Тогда поле становится элементом загрузки файла. + О том, как поля-ссылки связаны с автозаполнением, см. выражения.

Набор

Нет

Набор из нескольких значений. Тип элементов задаётся в общих настройках поля. Элементами могут быть примитивы (строки, числа, даты) или ссылки на записи сущностей. Набор из строковых элементов работает как значение «да/нет» или как фиксированный список вариантов, например «Да» и «Нет».

Коллекция

Нет

Набор из нескольких ссылок на записи определённого типа сущности. Целевой тип сущности задаётся в общих настройках поля.

Сопоставление

Нет

Набор пар «ключ — значение». Тип ключа и тип значения задаются в общих настройках поля. Ключами могут быть примитивы или ссылки на сущности и поля.

Выражение

Нет

Вычисляемое поле, значение которого берётся из других полей той же записи или связанных записей. Поля-выражения доступны только для чтения — пользователи не вводят в них значения. + Синтаксис выражений и правила вычисления описаны в разделе выражения.

Обобщённые поля

Четыре из девяти типов данных — «Ссылка», «Набор», «Коллекция» и «Сопоставление» — обобщённые: для них нужна дополнительная настройка, которая задаёт тип содержимого.

Для поля типа «Ссылка» обобщённая настройка — это целевой тип сущности (или «Файл»).

Для поля типа «Набор» обобщённая настройка — это тип элементов: один из примитивных типов (целое, дробное, строка, дата-время, выражение) или ссылка на сущность.

Для поля типа «Коллекция» обобщённая настройка — это целевой тип сущности, записи которого хранит коллекция.

Для поля типа «Сопоставление» обобщённая настройка включает тип ключа (примитив или ссылка на сущность или поле) и тип значения.

Общие параметры полей

Каждый тип данных поддерживает следующие параметры.

Обязательное поле

Если параметр включён, у поля должно быть значение, прежде чем запись можно сохранить.

Уникальное значение

Если параметр включён, у двух записей одного типа сущности не может быть одинакового значения этого поля. Когда вы включаете флаг уникальности, система проверяет существующие записи; если дубликаты уже есть, изменение отклоняется.

Проверка уникальности действует для типов сущностей, которые относятся к супертипам «Документ», «Контрагент», «Справочник», «Задача», «Группа сотрудников» или «Предложение».
Описание

Необязательное текстовое описание, которое показывается как подсказка к полю.

Каждое поле новой записи пустое, пока его не заполнит выражение или автозаполнение.

Системные переменные

Кроме пользовательских полей, которые задаёт администратор, у каждого встроенного типа записей (сделка, документ, контрагент, конструкция, клиент, контакт, сотрудник и других) есть фиксированный набор системных переменных. Системные переменные — это поля только для чтения, которыми управляет продукт, например этап сделки, автор документа или адрес конструкции.

Администратор не может изменять, удалять или добавлять системные переменные. Они показываются в списках и конструкторах фильтров вместе с пользовательскими полями, поэтому оба вида полей можно одинаково использовать для сортировки, фильтрации и отображения.

О том, как системные переменные и пользовательские поля работают вместе в списках, см. колонки и фильтры.