^{Как создать поле? Какие настройки есть у поля?}

В конструкторе вы можете создавать поля для объектов, дополнительных атрибутов (событий, документов, участников, задач), клиентских запросов и реестров.

Форматы полей в Case.one

В Case.one вы можете использовать поля следующих форматов:

• Число.
• Текст.
• Дата — в качестве значения по умолчанию можно выбрать конкретную дату или дату создания (с задержкой или без).
• Дата и время — в качестве значения по умолчанию можно выбрать конкретную дату и время или дату и время создания (с задержкой или без).
• Логический — при выборе типа поля пользователю будет доступен выбор ответа: Да или Нет.
• Данные — поле позволяет автоматически заполнять значения в зависимости от источника (от типа родительского поля).
• Гиперссылка — в поле можно вставить ссылку на внешний источник.
• Кнопка — с помощью кнопки можно запустить ручной сценарий автоматизации. Поле доступно только в конструкторе объектов и в карточке объектов и дел.
• Разделитель — поле позволяет визуально разграничить поля в блоке. Поле с типом Разделитель не имеет настроек и доступно в конструкторах карточки объекта, доп. атрибутов, клиентских формах.
• Сообщение — поле позволяет вести чат в отдельном блоке (работа с сообщениями аналогична функционалу работы с комментариями в Case.one).
• Справочник — можно выбрать значения из конкретного справочника Case.one.
• Объект-Документ — в таком поле можно будет работать с документами (загружать, скачивать, изменять и т.д.).
• Объект-Участник — в поле можно выбрать участника из списка, также доступен полнотекстовой поиск вне зависимости от условий фильтрации, указанных при настройке полей в конструкторе, в следующих местах Case.one:
  • Объекты
  • Реестры
  • Клиентские формы (запросы)
  • Дополнительные атрибуты
  • В полях с типом Объект-Участник в списке объектов (дел)
  • В полях карточек объектов и на формах сущностей (например, задача)
  • В доп. атрибутах с типом Объект-Участник
• Текстовое расширяемое.
• Объект-Пользователь — можно выбрать значения из списка пользователей Case.one. Поле с данным типом доступно использовать:
  • В публичном API получения, создания и редактирования дела
  • В карточках дела и клиентского запроса
  • В отчетах
• Объект-Класс объекта — поле позволяет вставлять на карточке объекта или дела ссылку на объект Case.one.
• Объект-Дело — поле позволяет вставлять на карточке объекта или дела ссылку на дело Case.one.
• Чекбокс — поле позволяет выбрать значение Да или Нет с помощью установки флага.
• Встраиваемый код — в поле отображается содержимое по указанной ссылке или коду, например, для отображения видео, местоположения, где код может быть указан: ссылкой или кодом. Дополнительно вы можете указать в URL ссылки системные теги:
  • @CurrentUser-ID — данные по текущему пользователю
  • @Object-ID — данные по текущему делу
• Формула расчета — в таком поле вы можете выполнить расчет данных по заранее настроенной формуле. В качестве исходных данных могут использоваться как данные из самой карточки дела/объекта, так и данные, внесенные вручную.
• Шаблон номера дела — в поле можно выбрать шаблон нумерации дел/объектов.

Создание поля

Для создания поля:

1. В разделе Администрирование — Объекты выберите в списке объект и тип объекта.
2. Добавьте блоки и строки в блок.
3. На вкладке Поля перетащите Новое поле в строку.
4. Укажите название поля.
5. В зависимости от типа поля укажите стандартные настройки поля (описание настроек см. ниже).
6. В зависимости от типа поля укажите специальные настройки поля (описание настроек см. ниже).
7. Настройте ширину полей и их расположение в блоке:
   • С помощью кнопки  измените порядок полей
   • С помощью кнопки  измените ширину полей
8. Нажмите кнопку Применить для сохранения настроек нового поля.
9. Добавьте остальные нужные поля в строки и блоки.
10. Нажмите кнопку Сохранить в правом нижнем углу для сохранения изменений объекта.

Вы можете перемещать поля внутри строки или блока, между строками, между блоками с помощью Drag&Drop.

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

При удалении поля или блока в конструкторе выполняется проверка:

• Если блок не используется ни в одной карточке, то он автоматически будет удален из списка блоков
• Если поле не используется в блоках или в качестве доп. атрибутов, то оно автоматически будет удалено из Case.one
• Если блок или поле используется в существующих делах или иных объектах, то они не удаляются

Настройки поля

Настройки поля зависят от выбранного формата поля:

1. Поля без настроек:
   • Разделитель — не предусмотрено никаких настроек, кроме названия поля (подробнее см. здесь)
   • Сообщение — не предусмотрено никаких настроек кроме названия поля
   • Встраиваемый код — не предусмотрено никаких настроек, кроме названия поля и самого кода
2. Стандартные настройки полей:
   • Название — ввод названия доступен для любого типа поля
   • Значение по умолчанию — можно указать значение, которое будет заполнено по умолчанию в карточке объекта/дела. Настройка недоступна для полей с типом: Данные, Кнопка, Шаблон нумерации дела, любых объектов (например, Объект-Участник), полей без настроек.
   • Возможность редактирования — можно выбрать значения Да; Нет; Нет, при условиях; Да, при условиях и указать отдельные условия возможности редактирования. Настройка недоступна для полей с типом: Данные, Кнопка и полей без настроек.
   • Обязательность — можно выбрать значения Да; Нет; Нет, при условиях; Да, при условиях и указать отдельные условия обязательного заполнения поля. Настройка недоступна для полей с типом: Данные, Кнопка, Чекбокс и полей без настроек.
   • Тег — теги полей позволяют формировать документы, счета и шаблоны документов и т.д. Настройка недоступна для полей с типом Кнопка и полей без настроек.
   • Системное имя — позволяют автоматически заполнять поля в карточке объекта или дела (например, при синхронизации с КАД). Настройка недоступна для полей с типом Кнопка и полей без настроек.
   • Подсказка — можно указать текст всплывающей подсказки при наведении курсора мыши на поле. Настройка недоступна для полей без настроек.
3. Специальные настройки полей:
   • В поле с типом Данные укажите:
     • Источник — выберите тег родительского поля
     • Значение — выберите значение из списка, например, телефон, электронная почта, должность в организации и т.д. (в зависимости от типа родительского поля)
   • В поле с типом Кнопка (подробнее вы можете узнать в этой статье):
     • Цвет — выбор цвета кнопки из списка
     • Сценарий — выбор ручного сценария автоматизации из списка (если указанный сценарий был удален, значение в поле будет сброшено)
     • Условия доступности — выбор условий доступности кнопки: Да; Нет; Да, при условиях; Нет, при условиях (условия задаются на отдельной форме)
   • В поле с типом Справочник — дополнительные настройки доступны при выборе иерархического справочника для создания зависимых полей (при создании зависимого поля вам нужно добавить два поля с типом Справочник):
     • Уровень справочника — выбор уровня справочника
     • Зависимое поле — установка флага, если это поле является зависимым от предыдущего уровня справочника
     • Зависит от — выбор тега главного поля справочника из списка (настройка отображается после установки флага Зависимое поле)
   • Для поля с типом Текст можно задать маску поля, т.е. ограничения для заполнения поля. Доступны следующие символы для ввода в маску:
     • 0 — все цифры
     • L — все буквы
     • А — все буквы и цифры
     • . , : ; — / () — указанные символы
     • \, «» — Следующий символ, указанный за \ и символы внутри «» отображаются в том виде, в котором ввел пользователь
   • Для поля с типом Формула расчета:
     • Нужно выбрать значение из списка в параметре Шаблон формулы
     • Можно указать параметры (настройки недоступны для доп. атрибутов):
       • Количество знаков после запятой, с помощью которого вы можете ограничить ввод десятичных знаков — выбор значения от 0 до 6 из списка (значение 2 установлено по умолчанию). Если введено больше знаков, чем указано в настройках, лишние знаки после запятой отсекаются.
       • Добавлять нули в конце — установка флага доступна, если в поле Количество знаков после запятой выбрано значение больше 0. Если флаг установлен, но будет введено меньшее количество знаков после запятой, к введенному значению добавляется необходимое количество нулей в конце.
   • Для поля с типом Число можно указать следующие дополнительные настройки:
     • Количество знаков после запятой, с помощью которого вы можете ограничить ввод десятичных знаков — выбор значения от 0 до 6 из списка (значение 2 установлено по умолчанию). Если введено больше знаков, чем указано в настройках, лишние знаки после запятой отсекаются.
     • Добавлять нули в конце — установка флага доступна, если в поле Количество знаков после запятой выбрано значение больше 0. Если флаг установлен, но будет введено меньшее количество знаков после запятой, к введенному значению добавляется необходимое количество нулей в конце.
   • Для поля с типом Шаблон номера дела нужно выбрать значение из списка в параметре Шаблон нумерации
   • Для полей с типом Объект-Дело, Объект-Объект, Объект-Пользователь, Объект-Участник можно задать фильтры. Добавление фильтров для поля упрощает работу с полями и позволяет отображать в списках со значениями таких полей не все объекты/дела:
     • Доступно задать несколько условий фильтрации — они будут срабатывать по логическому И
     • Каждое поле и его значение на форме Фильтры можно изменить или удалить
     • Одно и то же поле может быть добавлено в разные блоки, что позволяет задать для этого поля в каждом блоке разные условия фильтрации
     • После сохранения количество добавленных фильтров отобразится в поле Фильтры в блоке Настройки поля. Просмотр и изменение условий фильтрации доступны по ссылке из поля

Настройки редактируемости, обязательности и доступности полей привязаны к типу объекта, в котором они находятся (при сохранении настроек в одном типе, эти настройки поля в других типах объектов не будут изменены) — вы можете указать различные условия редактируемости, обязательности и доступности поля в различных типах объектов. При копировании блока или типа объекта все настройки обязательности, редактируемости и доступности будут также скопированы. 

Ограничения разных типов полей и их специфика

1. Поля с типом Текстовое расширяемое, Встраиваемый код и Сообщение можно разместить только в отдельной строке блока (т.е. они должны занимать всю строку).
2. Для поля с типом Встраиваемый код:
   • В тексте кода доступно использовать тег (с помощью конструкции @System_Tag). Для использования более одного тега обязательно установите разделитель между тегами (пробел)
   • В тексте кода значение не подставляется при использовании тега, который ссылается на поле, находящееся в мультистроке
   • Вы можете настроить высоту блока поля с кодом — необходимо изменить значение из верхнеуровневого тега во встраиваемом коде (атрибут height)
   • Поле недоступно использовать в отчетах, сценариях автоматизации, фильтрах, автошаринге, реестрах
3. Для полей с типом Объект-Пользователь:
   • В конструкторах типов объектов и дел, клиентских форм, реестров поля недоступны в настройках автошаринга (для полей недоступно указание значения по умолчанию)
   • В карточке дела или клиентского запроса поле не заполняется в результате синхронизации с СВ. Поле не является ссылкой на карточку пользователя. Заблокированные пользователи не отображаются в списке значений поля.
   • Изменение значения в поле Объект-Пользователь отображается в истории изменения.
4. Для поля с типом Кнопка:
   • Возможно задать несколько условий доступности — они будут срабатывать по логическому И
   • Условие доступности будет удалено, если:
     • Удалено поле, которое было использовано в качестве условия
     • Удален справочник, который был использован в качестве условия
     • Выбранное поле использовано в новом блоке
5. При добавлении фильтров для полей с типом Объект-Дело, Объект-Объект, Объект-Пользователь:
   • В списке значений у таких полей будут отображаться только те объекты/дела, которые подходят под созданные условия:
     • Если в поле уже выбран объект, но он не подходит под заданные условия, объект отображается в поле, но в саджесте его уже нет
     • Если на одной вкладке изменили условия, а на другой открыт саджест, то саджест работает с новыми условиями
     • Если условия изменились, то при паджинации в саджесте отображаются объекты с новыми условиями
   • Условие фильтрации будет автоматически удалено, если:
     • Изменен формат поля
     • Удалено поле из блока
     • Удален справочник, который использовался в поле
     • Удален класс или типа объекта/дела, в котором находится блок с полем
   • При перемещении поля условия фильтрации не будут сброшены
6. Для поля с типом Справочник при выборе в качестве значения многоуровневый (иерархический) справочник и создании зависимого поля:
   • Зависимое и родительское поле должно находиться в одном блоке (мультиблоке) и в одной мультистроке
   • При сохранении карточек (объекта, дела, клиентского запроса, реестра) в конструкторе или сохранении дополнительных атрибутов выполняются проверки на корректность использования зависимых полей
   • Зависимые поля также можно задать в конструкторе реестров, клиентских запросов
7. Для поля с типом Данные:
   • Поле с типом Данные является дочерним
   • Родительское и дочернее поля могут находиться в разных блоках и на разных вкладках дела или объекта.
   • В качестве родительского поля вы можете указать:
     • Поля с типом Пользователь, Участник, Класс объекта
     • Поле с типом Чекбокс доступно выбрать, если в качестве источника выбрано поле с типом Чекбокс в деле/объекте. Отсылкой к родительскому полю является системный тег, который должен быть доступен в поле Источник.
     • Поле с типом Формула, доступно выбрать, если в качестве источника выбрано поле с типом Объект/Дело, где есть поле с типом Формула. Отсылкой к родительскому полю является системный тег, который должен быть доступен в поле Источник.
   • Поле недоступно для использования в сценариях автоматизации и в настройках автошаринга
8. После сохранения типа объекта изменение формата поля недоступно для всех типов полей, кроме поля с типом Текст — вы можете изменить формат поля с типом Текст на Текстовое расширяемое:
   • Изменение формата недоступно, если поле:
     • Не единственное в строке
     • Изначально в формате Текстовое расширяемое (возможно изменение только до сохранения типа объекта)
   • Изменение доступно в конструкторах объектов, клиентских форм, реестров и дополнительных атрибутов
   • При изменении формата:
     • Настройка маски поля будет скрыта
     • Сохраняются:
       • Настроенные параметры и условия
       • Настройки других полей, если изменяемое поле указано в качестве условия
       • Отчеты, сценарии и наборы фильтрации, где было использовано поле
     • При поиске или фильтрации по измененному полю в разделах Объекты (Дела) и ленте событий будет работать ElasticSearch (при наличии интеграции)