🧩 Дополнительные поля
Что это. Поля под ваши процессы: номер заказа, сумма возврата, дата визита. В интерфейсе они собраны в блоке «Дополнительные поля» в панели тикета.
Когда нужно. Когда рядом с тикетом нужно держать структурированные данные, которые не помещаются ни в тип, ни в приоритет, ни в описание.
Дополнительные поля существуют в системе тикетов, но настроить их через дашборд нельзя: экрана, на котором заводятся поля проекта, в продукте нет, а в панели тикета значения только читаются. Добавить, изменить или удалить поле из интерфейса невозможно.
Более того, запросы дополнительных полей из дашборда уходят по неверным адресам, поэтому блок «Дополнительные поля» на тикете сейчас не наполняется вовсе. Пока это не исправлено, планировать процессы вокруг дополнительных полей не стоит — пользуйтесь типами тикетов и тегами проекта.
📷 Скриншот: блок «Дополнительные поля» в панели тикета (будет добавлен).
Как это устроено
Дополнительные поля живут на двух уровнях:
| Уровень | Что это |
|---|---|
| Определение поля | Описание поля на уровне проекта: ключ, подпись, тип, обязательность, список допустимых значений, порядок |
| Значение поля | То, что записано в конкретном тикете |
То есть сначала в проекте объявляется поле («Номер заказа», текст, обязательное), а потом у каждого тикета появляется своё значение этого поля.
Из чего состоит определение поля
| Поле | Обязательно | Описание |
|---|---|---|
| Ключ | да | Служебный идентификатор поля, уникальный внутри проекта, до 64 символов. Повторный ключ система не примет |
| Подпись | да | Название поля, которое видно в блоке «Дополнительные поля», до 128 символов |
| Тип | да | Один из пяти типов, см. таблицу ниже |
| Обязательность | нет | Обязательное поле нельзя оставить пустым при создании тикета |
| Список значений | для списка | Допустимые варианты — только для типа «список» |
| Порядок | нет | Порядок полей в блоке |
Типы полей
| Тип | Для чего | Как проверяется значение |
|---|---|---|
| Текст | Произвольная строка | Обязательное поле не может быть пустым |
| Число | Числовое значение | Значение должно разбираться как число, иначе тикет не создастся |
| Дата | Дата | Не проверяется вообще: в поле пройдёт любая строка |
| Список | Выбор из заданных вариантов | Значение обязано входить в список; если варианты не заданы, значение не примут |
| Флажок | Да или нет | Проверяется только то, что значение передано |
Сообщения, которыми система отвечает на неверное значение: «Поле обязательно для заполнения», «Значение должно быть числом», «Для поля не заданы допустимые значения», а для списка — перечисление допустимых вариантов.
Как значения выглядят в тикете
В панели тикета под блоком «Детали тикета» показывается блок «Дополнительные поля»: две колонки «подпись — значение». У поля без значения вместо него стоит «—».
Ограничения
- Управлять определениями полей из интерфейса нельзя: ни создать, ни изменить, ни удалить.
- Заполнить значение поля из интерфейса тоже нельзя — блок только для чтения.
- Значений по умолчанию у дополнительных полей нет: пустое необязательное поле так и останется пустым.
- Выключить объявленное поле нельзя — только не заполнять его.
- Дата не проверяется, поэтому в поле типа «дата» может оказаться что угодно.
- Поля объявляются на проект, а не на тип тикета: разные наборы полей для разных типов не поддерживаются.
- В публичном API раздела тикетов нет — обратиться к полям оттуда не получится.
Кто что может
| Действие | Минимальная роль |
|---|---|
| Видеть блок «Дополнительные поля» в тикете | По умолчанию |
| Управлять определениями полей | действия в интерфейсе нет |
Право на управление дополнительными полями в системе прав заведено, но ни один экран его пока не использует.
→ Панель тикета · Типы тикетов · Теги