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

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

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


Форматы полей в 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 (при наличии интеграции)