Поля

В Платформе есть возможность управлять набором полей в объектах:

Клиент;
Транзакция/Чек;
Строка транзакции;
Продукт;
Категория.

Список полей

В разделе Поля выводится список полей в системе.

Поля объединены в группы. Например, поля объекта Клиент разбиты на группы:

Клиент;
Контакты;
Бонусы;
Скоринг.

Для каждого поля выводится:

Наименование – название поля, которые видят пользователи;
Код поля (системное имя) – имя поля, которые используется для обращения к нему через REST API;
Тип поля (строка, целое, дата и т.д.);
Системное/пользовательское:
- Системные поля изначально присутствуют в системе;
- Пользовательские поля – созданные пользователем.

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

Порядок полей

Порядок полей и групп объекта можно менять с помощью перетаскивания.

Поля в построителе сегментов выводятся в том же порядке, что и в списке полей.

Порядок полей в профиле клиента задаётся через настройку представления профиля клиента. Подробнее об этом – в статье Управление представлениями.

Фильтрация по названию полей

Доступна фильтрация по названию полей:

Видимость объектов в профиле клиента

Объекты Транзакции/Чеки и Строки транзакций можно скрыть в профиле клиента.

Чтобы скрыть транзакции, нажмите Скрыть транзакции во вкладке Транзакции:

Блок Заказы в профиле клиента, когда транзакции видимы:

Когда транзакции скрыты, блок Заказы не выводится в профиле клиента:

Чтобы скрыть строки транзакций, нажмите Скрыть строки транзакций во вкладке Строки транзакций:

Строки транзакций выводятся при нажатии на номер чека во вкладке Заказы в профиле клиента.

Добавление группы полей

Добавление новой группы полей осуществляется по кнопке Добавить группу:

Для группы полей необходимо указать наименование:

Добавление поля

Добавление нового поля осуществляется по кнопке Добавить поле:

Необходимо заполнить свойства поля:

У полей могут быть различные свойства в зависимости от типа поля. Необходимо заполнить общие свойства поля и свойства, присущие его типу:

Общие свойства

Наименование группы – к какой группе полей относится;
Наименование поля – название поля, которые видят пользователи;
Код поля – системное имя поля, используется для обращения к нему через REST API;
Описание;
Тип данных:

Операторы. Для некоторых полей актуальны не все операторы. Например, для пола актуальны только эти:

Именно эти операторы будут выводиться в построителе сегментов при формировании условия для этого поля:

Поле видимо.
- Видимое поле будет выводиться в профиле клиента и в построителе сегментов.
- Невидимые поля выводятся светло-серыми в списке полей.

Показывать в сводных таблицах. Позволяет использовать поле в сводных таблицах в разделе Аналитика – Отчёты. Например, чтобы использовать в сводной таблице чеков атрибут клиента Город, выполните действия:

В разделе Клиенты перейдите к редактированию поля Город:

2. В разделе Показывать в сводных таблицах отметьте галочкой Чеки/Транзакции:

Тип: поле/метрика.

Свойства целых полей

Для целых полей доступно дополнительное свойство – Элемент управления:

Для каждого элемента управления есть свой набор дополнительных свойств.

Элемент управления – поле ввода

В поле ввода можно ввести значение:

Для полей ввода доступны дополнительные свойства:

Минимальное значение;
Максимальное значение;
Инкремент – на этот параметр может увеличиваться значение поля;
Значение по умолчанию – это значение будет автоматически выводиться в построителе сегментов.

Элемент управления – значение

В поле можно будет выбрать вариант из списка.

Доступны дополнительные поля:

Представление;
Набор вариантов.

Для поля Набор вариантов возможно 2 варианта:

Список опций позволяет указать возможные значения поля прямо в настройках поля.

Данные из БД позволяет выбирать в поле значение из базы данных. Например, построитель сегментов построит список всех уникальных значений, которые хранятся в БД в этом поле, и выведет их:

Возможные представления:

Выпадающий список;

Автодополнение – при вводе значения предлагаются все подходящие варианты;

Радиокнопки.

Элемент управления – справочник

В поле можно будет выбрать вариант из справочника.

Доступны дополнительные поля:

Представление;
Справочник.

Возможные представления описаны выше (для полей с элементом управления – значение):

Выпадающий список;
Автодополнение;
Радиокнопки.

В поле Справочник доступны варианты:

Если в системе существует нужный справочник, необходимо указать его название в поле Наименование справочника.

Подробнее о справочниках – в разделе Настройки – Справочники.

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

Наполнение и редактирование справочника осуществляется в разделе Настройки --> Справочники.

Свойства дробных полей

Для дробных полей доступны дополнительные свойства:

Минимальное значение;
Максимальное значение;
Инкремент – на этот параметр может увеличиваться значение поля. Например, при минимальном значении поля "1", максимальном – "2" и инкременте "0.5" поле может принимать значения: "1", "1.5", "2";
Значение по умолчанию – это значение будет автоматически выводиться при формировании запроса в построителе сегментов.

Свойства поля с типом "строка"

Для полей с типом строка доступно дополнительное свойство – Элемент управления:

Для каждого элемента управления есть свой набор дополнительных свойств.

Элемент управления – Поле ввода

Дополнительные свойства:

Максимальная длина – ограничение на длину значения поля;
Значение по умолчанию.

Элемент управления – значение

В поле можно будет выбрать вариант из списка. Подробнее о настройке дополнительных полей – в разделе Элемент управления – значение.

Элемент управления – справочник

В поле можно будет выбрать вариант из списка. Подробнее о настройке дополнительных полей – в разделе Элемент управления – справочник.

Свойства поля с типом "дата"

Для полей с типом дата доступно свойство Добавить поле с расстоянием до даты.

Поле с расстоянием до даты позволяет рассчитать, сколько времени прошло с этой даты.

Поле будет выводиться в профиле клиента;
Поле можно использовать при построении запросов в построителе сегментов.

Например, есть поле Дата свадьбы. Добавим дополнительное поле – Дней с даты свадьбы:

Новое поле можно использовать в построителе сегментов:

Свойства логических полей

У полей с типом "логическое" нет дополнительных свойств.

Для полей этого типа доступны только 3 оператора:

Равно;
Пусто;
Не пусто.

Редактирование группы полей

Редактирование группы полей осуществляется по кнопке редактирования справа от названия группы:

Можно отредактировать только наименование группы.

Редактирование поля

Редактирование поля осуществляется по кнопке редактирования справа от названия поля:

В пользовательском поле доступны для редактирования все свойства, описанные в разделе Добавление поля. В системном поле лишь часть свойств доступна для редактирования: