Оформление
Добавить и настроить поле
Поле хранит значение объекта: текст, число, дату, выбор из списка или ссылку. Добавление поля в модель и размещение его на форме — отдельные действия.
Где находится
Настройки платформы → Классы и права → нужный класс или тип → Свойства и поля.
Настройка платформы доступна суперпользователю. Право пользователя читать и менять значение этого поля настраивается отдельно.
Добавить поле
- Выберите правильного владельца. Поле класса используется его типами; поле типа относится к этому типу.
- Откройте добавление поля.
- Укажите название и технический код. Название удобно людям, код используется интеграциями и скриптами.
- Выберите тип данных.
- Для списка задайте варианты; для ссылки — целевой объект, для справочника — источник выбора.
- Настройте обязательность и другие доступные параметры.
- Сохраните поле и добавьте его на нужные формы.
- Проверьте полевые права.
Пример: добавить «Номер договора» только одному типу
Предположим, номер нужен в юридической заявке, но не в каждом инциденте. Откройте именно тип, а не общий класс «Заявка».
- Нажмите добавление поля. На вкладке «Основное» введите «Номер договора» и выберите «Строка». Для номера с буквами, дефисами или ведущими нулями строка подходит лучше числа.
- Разверните «Код и описание». Код предложен по названию; до создания его можно изменить, например на
contractNumber. Он должен начинаться с латинской буквы, содержать только латинские буквы, цифры и подчёркивание, не более 64 символов. - Если старые заявки не содержат номера, не включайте обязательность без подготовки данных. Флажок «Не разрешать пустое значение» действует при любом сохранении, включая API.
- Откройте «Дополнительно». Например, ограничьте максимальную длину и напишите подсказку «Укажите номер из подписанного договора». Ограничение — проверка данных; подсказка только объясняет ввод.
- Нажмите «Сохранить поле». На экране результата выберите «Форма создания», добавьте новое поле в подходящий блок и сохраните его настройки. Повторите размещение в «Форме редактирования» и «Карточке объекта», если поле должно быть там.
- Проверьте форму от имени целевого сотрудника. Создание определения поля само по себе не размещает его на всех экранах и не выдаёт права чтения или изменения.
После создания код и формат защищены от произвольного изменения. Если ошиблись с форматом, не пытайтесь переименованием превратить текст в число: сначала разберите использование поля и перенос его значений.
Выбрать подходящий формат
| Что нужно хранить | Что выбрать и настроить |
|---|---|
| Короткое название, код договора, телефон | Строка; при необходимости длина и подсказка |
| Несколько абзацев | Текст или Форматированный текст, если нужно оформление |
| Количество или стоимость | Целое число / Вещественное число; минимум, максимум, для дробного — количество знаков |
| День без времени / конкретный момент | Дата / Дата и время; границы «Не ранее» и «Не позднее» включаются в допустимый диапазон. Дата и время вводятся в часовом поясе браузера |
| Небольшой фиксированный набор | Список значений; каждый вариант с новой строки |
| Управляемый отдельно перечень | Справочник; выберите существующий пользовательский справочник |
| Одну или несколько записей системы | Ссылка на объект / Набор ссылок на объекты; выберите источник. Класс охватывает его типы, конкретный тип сужает выбор |
| Ответ «Да» или «Нет» | Логический; в карточке можно показывать словами или флажком |
Набор форматов зависит от сущности: редактор собственных полей базы знаний, например, не предлагает ссылки и справочники. Это не ошибка загрузки списка.
Значение по умолчанию и ограничения
«Подставлять значение при создании» помогает заполнить новую запись. Оно не обновляет старые записи. Если в конкретной форме задано своё значение по умолчанию, оно имеет приоритет. Для ссылки выберите доступный объект через поиск; название не заменяет идентификатор.
Не у каждого поля есть этот переключатель: системные значения, нумераторы, назначение «сотрудник — команда» и справочник управляются иначе. У инвентарного номера активов вместо обычного значения настраиваются префикс, количество цифр и начальный номер; существующие номера не переписываются.
«Уникальное значение в пределах типа» учитывает и архивные записи. Пустые значения не сравниваются. Не включайте его, если одинаковое значение допустимо у нескольких объектов: например, один договор может относиться к нескольким заявкам.
В разделе «Отображение и ввод» находятся обязательность ввода в форме, запрет изменения, скрытие подписи, скрытие пустого значения в карточке, подсказки и формат числа. Для «Да / Нет» можно отдельно скрывать «Нет». Эти настройки не заменяют полевые права. «Пример отображения» показывает подпись и пример значения, но не учитывает итоговое расположение и права — это не проверка доступа.
Три вида обязательности
- В модели данных: значение требуется независимо от оформления формы.
- На форме: требование относится к конкретной форме.
- В процессе: поле требуется в определённом состоянии или при переходе.
Форма не может отменить обязательность модели. Скрытое обязательное поле может сделать сохранение невозможным — проверьте сочетание настроек.
Наследование
Унаследованное поле не становится собственным полем типа после изменения подписи на форме. Изменение общего определения может затронуть несколько типов. Перед правкой проверьте источник поля и где оно используется.
В окне общего поля выберите «Использовать настройки класса», если тип должен следовать общим параметрам, либо «Настроить для этого типа», если отличие нужно только здесь. Для изменения всех типов откройте «Действия с полем класса → Изменить общее поле класса». Прочитайте область изменения и подтвердите её, если редактор просит. Собственные переопределения других типов сохраняются; возврат к наследованию снимает локальное отличие, а не удаляет поле.
Заменить справочник у заполненного поля
Это изменение данных, а не просто подписи выпадающего списка. Сначала подготовьте нужные действующие значения в новом справочнике.
- Откройте поле и выберите новый «Источник справочника». Для общего поля делайте это в настройках класса, а не в локальном переопределении типа.
- Нажмите сохранение. Если есть заполненные значения и нужна замена, система покажет «Замена сохранённых значений»: старое значение, число записей и выбор замены.
- Для каждого старого значения выберите соответствующее новое. В расчёт попадают и архивные записи. Пустой список замен означает, что в новом справочнике сначала нужны действующие элементы.
- Ещё раз проверьте сопоставление и сохраните. Не закрывайте сообщение как обычную ошибку и не выбирайте случайный элемент ради завершения операции.
- Проверьте несколько заполненных объектов и формы новых записей. «Отмена» до успешного сохранения не применяет предложенное сопоставление.
У обычной ссылки на объект источник после создания этим редактором не меняется: для такой замены требуется отдельный перенос данных.
Возможные ошибки
Если сервер не принимает значение, проверьте его тип, допустимые варианты и действительность ссылки. При существующих данных изменение ограничений может быть недопустимо без подготовки этих данных.
Системно управляемые поля, например автоматически назначаемый номер, не следует превращать в обычный редактируемый ввод.