Как создать дополнительное поле

Дополнительные поля подходят для хранения данных, которые не входят в список основных полей.

Чтобы создать дополнительное поле:

1. Перейдите в раздел Настройки → Системные → Дополнительные поля:

   

2. Нажмите «Создать» → «Дополнительное поле»:

   

3. Заполните настройки:

   

   Общие настройки:

   • Сущность — к какой сущности будет относиться поле. Доступны: клиент, действие, точка контакта, продукт, линия списка продуктов, заказ, промоакция, позиция заказа, зона, дисконтная карта.
   • Имя — название, которое будет отображаться в фильтрах на проекте.
   • Системное имя — имя, которое будет передаваться в импортах и сервисах.
   • Тип поля:
     • Строковый — любое значение, принимается до 1000 символов;
     • Логический — да/нет;
     • Целочисленный — принимается целое число, например, 123456;
     • Десятичный — 12345,67;
     • Дата — 12.03.2021;
     • Дата и время — 12.03.2021 16:30;
     • Перечисление — выбор варианта из списка, подробнее в статье;
     • Уникальный идентификатор — повторная регистрация с таким идентификатором запрещается;
     • Идентификатор — повторная регистрация с таким идентификатором допускается.

   Правила валидации для всех типов дополнительных полей.

   • Действие при объединении (для типов Целочисленный и Десятичный)
     • Дописать из приоритетного — результирующее значение будет дописано из приоритетного клиента в случае, если отсутствуют противоречия.
     • Взять наибольшее значение — результирующим значением будет максимальное из всех значений дополнительного поля клиентов.
   • Настройки данных поля — зависят от выбранных сущности и типа.
     • Можно много значений в одном поле. Разделитель в CSV: | — доступна запись несколько значений в одном поле.
     • Затирать, если передано пустое значение — при обновлении продукта значение поля будет удалено, если оно передано пустым. Если поле отсутствует в запросе, его значение, переданное ранее, сохранится.

   Пример

   В операции

   "Age": "" → значение затирается

   Age не передан → значение сохраняется

   В фиде

   <param name="Age"></param> → значение затирается

   <param name="Age"> не передан → значение сохраняется

   • Публичное поле - поле будет доступно для вызова и редактирования в операциях без секретного ключа.
   • Создавать значение перечисления, если не найдено (для типа Перечисление) — автоматически будет создано новое переданное значение.
   • Не объединять клиентов с разными ID (для типа Уникальный идентификатор) — при создании нового клиента, они не будут объединяться. Значение идентификатора сотрется у дубликата. Поиск по истории будет недоступен.
   • Содержит чувствительные данные (для типов Строковое и Целочисленное по сущностям Клиент, Действие клиента, Заказ, Позиция заказа, Линия списка продуктов; и типа Внешний идентификатор по сущностям Заказ и Действие клиента) — используется для полей, в которых может храниться информация повышенной конфиденциальности (медицинские сведения, финансовые данные или персональные идентификаторы). Без пермиссий «Просмотр и редактирование персональных данных» и «Возможность размаскировать персональные данные» такие поля отображаются в интерфейсе замаскированными. Также используется в анонимизаторе.

4. Нажмите «Добавить».

Готово:

Готово!