На странице перечислены доступные пользователям поля и объекты, для которых в Трекер действуют ограничения на формат, размер и количество значений. Кроме перечисленных правил, значение каждого поля должно соответствовать его типу. Другие проверки логической согласованности данных здесь не описаны.
Вложения
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 2 000 символов. |
size |
long |
Размер не должен быть равен нулю. Максимальный объем вложения (для каждого файла) — 128 МБ в интерфейсе Трекера и через API. |
Доски
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный, непустой. Не более 2 000 символов. |
columns |
ListF<BoardColumn> |
Все колонки должны быть уникальными. |
queues |
ListF<QueueRef> |
Не более 20 очередей. |
backlogAvailable, sprintsAvailable |
Option<Boolean> |
Бэклог и спринты должны быть включены или выключены одновременно. |
Заметки на доске
| Параметр |
Тип |
Ограничение |
text |
String |
Обязательный. Не более 5 000 символов. |
В одной задаче может быть не более 1 000 комментариев.
| Параметр |
Тип |
Ограничение |
text |
Option<String> |
Не более 512 000 символов. Пустой текст разрешен, только если в комментарии упомянуты пользователи (summonees). |
replyTo |
ListF<ObjectId> |
Не более 50 цитируемых комментариев. |
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный, непустой. Не более 10 000 символов. |
description |
Option<String> |
Не более 10 000 символов. |
template |
Option<String> |
Если параметр задан, его значение не должно быть пустым. |
Компоненты
В одной очереди может быть не более 10 000 компонентов.
| Параметр |
Тип |
Ограничение |
queue |
QueueRef |
Обязательная ссылка на очередь. |
name |
String |
Непустой. Не более 512 символов. |
description |
Option<String> |
Не более 2 000 символов. |
Глобальные поля
| Параметр |
Тип |
Ограничение |
id |
String |
Не более 30 символов. |
type |
DbFilterableFieldType<T, ?> |
Тип поля обязателен. |
category |
FieldCategoryRef |
Категория поля обязательна. |
name |
LocalizedString |
Не более 50 символов для каждого языка. |
description |
Option<String> |
Не более 300 символов. |
Дашборды
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 10 000 символов. |
Категории полей
| Параметр |
Тип |
Ограничение |
name |
LocalizedString |
Обязательный, непустой. Не более 2 000 символов. |
order |
int |
Обязательный. |
Отсутствия сотрудников
Создавать отсутствия могут только сотрудники поддержки, а в B2B — администраторы организации.
| Параметр |
Тип |
Ограничение |
id |
String |
Не более 128 символов. |
Задачи
Рекомендуется добавлять в одну задачу не более 300 наблюдателей. При большем количестве страница задачи может загружаться с задержкой.
| Параметр |
Тип |
Ограничение |
queue |
QueueRef |
Обязательная ссылка на очередь. |
type |
IssueTypeRef |
Обязательная ссылка на тип задачи. |
summary |
String |
Непустой. Не более 32 766 символов. |
tags |
ListF<String> |
Каждый тег должен быть непустым, не более 480 символов и не содержать запятых и пробелов. |
customFields |
MapF<String, Object> |
Значения должны соответствовать типам полей. |
localFields |
MapF<String, Object> |
Значения должны соответствовать типам полей. |
checklistItems |
ListF<ChecklistItem> |
Текст каждого элемента — не более 2 000 символов. |
Ограничения по типам полей
Ограничения применяются к системным, глобальным и локальным полям задач, а также к полям других объектов, для которых указана проверка по типу поля.
| Тип поля |
Ограничение |
| Выпадающий список |
Не более 3 000 значений. При выборе значения отображается не более 10 элементов. |
StringFieldType |
Не более 32 766 символов. Обязательное поле не должно быть пустым. |
IcuStringFieldType |
Те же ограничения, что у StringFieldType. |
MetaEntityStatusFieldType |
Те же ограничения, что у StringFieldType. |
TagsFieldType |
Непустое значение без запятых и пробелов. Не более 480 символов. |
EmailFieldType |
Значение должно соответствовать формату адреса электронной почты. |
WikiPageIdFieldType |
Идентификатор должен быть непустым. В списке может быть не более 100 страниц. |
UriFieldType |
Не более 32 766 символов. |
IntegerFieldType |
Целое число от −2 147 483 648 до 2 147 483 647. |
LongFieldType |
Значение типа long. |
FloatFieldType |
Конечное число: значения NaN, +INF и −INF запрещены. |
BooleanFieldType |
Логическое значение Boolean или Number, равное 0 или 1. |
TimeTrackingDurationFieldType |
Период не должен содержать годы и месяцы. |
DateFieldType |
Дата от 0001-01-01 до 3000-01-01. |
DateTimeFieldType |
Дата и время от 0001-01-01 до 3000-01-01. |
QuarterFieldType |
Дата квартала от 0001-01-01 до 3000-01-01. |
PaletteColorFieldType |
Ключ — не более 32 символов и должен соответствовать регулярному выражению (\d|\w|-|_)+. |
UserToDoubleFieldType |
Пользователь должен существовать, value не должен быть равен null. |
ChecklistItemFieldType |
Текст — непустой, не более 2 000 символов; ссылка — не более 32 766 символов. |
MetricItemFieldType |
Текст — непустой, не более 2 000 символов; ссылка — не более 32 766 символов. |
KeyResultItemFieldType |
Текст — непустой, не более 2 000 символов. Для типа VALUE обязателен progress; в progress обязательны start и end. Числовые значения должны быть конечными. |
UserFieldType |
Пользователь должен существовать. |
IssueFieldType |
Задача должна существовать. |
QueueFieldType |
Очередь должна существовать. |
StatusFieldType |
Статус должен существовать. |
PriorityFieldType |
Приоритет должен существовать. |
ResolutionFieldType |
Резолюция должна существовать. |
IssueTypeFieldType |
Тип задачи должен существовать. |
ComponentFieldType |
Компонент должен существовать. |
VersionFieldType |
Версия должна существовать. |
SprintFieldType |
Спринт должен существовать. |
ProjectFieldType |
Проект должен существовать. |
BoardsFieldType |
Доска должна существовать. |
GroupFieldType |
Группа должна существовать. |
GoalsFieldType |
Цель должна существовать. |
ServiceFieldType |
Сервис должен существовать. |
IdpProductFieldType |
Продукт IDP должен существовать. |
OfficeFieldType |
Офис должен существовать. |
TranslationFieldType |
Перевод должен существовать. |
MailListFieldType |
Почтовая рассылка должна существовать. |
MetaEntityFieldType |
Все ссылки на метасущности должны быть корректными. |
SlaViolationStatusFieldType |
Значение должно входить в перечень значений перечисления. |
SlaClockStatusFieldType |
Значение должно входить в перечень значений перечисления. |
IssueRelationshipFieldType |
Значение должно входить в перечень значений перечисления. |
Макросы
В одной очереди может быть не более 1 000 макросов.
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 2 000 символов. |
body |
Option<String> |
Не более 400 000 символов. Значение должно быть корректным шаблоном Mustache. |
description |
Option<String> |
Не более 2 000 символов. |
Шаблоны задач
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 10 000 символов. |
description |
Option<String> |
Не более 32 766 символов. |
metricItems |
ListF<MetricItem> |
Текст каждого элемента — не более 2 000 символов. |
checklistItems |
ListF<ChecklistItem> |
Текст каждого элемента — не более 2 000 символов. |
fieldTemplates |
MapF<String, Object> |
Значения должны соответствовать типам полей, как у задачи. |
Типы задач
| Параметр |
Тип |
Ограничение |
key |
String |
Обязательный. Не более 30 символов. |
name |
String |
Не более 50 символов. |
description |
Option<String> |
Не более 300 символов. |
Приоритеты
| Параметр |
Тип |
Ограничение |
name |
String |
Не более 300 символов. |
description |
Option<String> |
Не более 2 000 символов. |
Очереди
В одну очередь можно добавить не более 20 форм.
| Параметр |
Тип |
Ограничение |
key |
String |
Обязательный. От 2 до 15 латинских букв. Значение преобразуется в верхний регистр. |
name |
String |
Обязательный. После удаления пробелов в начале и конце — от 2 до 40 символов. |
permissionDeniedMessage |
Option<String> |
Не более 32 766 символов. |
wikiPageIds |
ListF<String> |
Не более 100 идентификаторов. |
Напоминания
Для одной задачи можно создать не более 100 напоминаний.
| Параметр |
Тип |
Ограничение |
note |
Option<String> |
Не более 140 символов. |
when |
Instant |
Обязательный. Дата и время не должны быть раньше текущего момента. |
Резолюции
| Параметр |
Тип |
Ограничение |
key |
String |
Обязательный. Не более 30 символов. |
name |
String |
Не более 50 символов. |
description |
Option<String> |
Не более 300 символов. |
Спринты
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 2 000 символов. |
board |
BoardRef |
Обязательная ссылка на доску. |
startDate |
Instant |
Обязательный. Дата начала не должна быть позже даты окончания. |
endDate |
Instant |
Обязательный. Дата окончания не должна быть раньше даты начала. |
Статусы
| Параметр |
Тип |
Ограничение |
key |
String |
Обязательный. Не более 30 символов. |
name |
LocalizedString |
Обязательный для всех языков. Не более 50 символов для каждого языка. |
description |
Option<String> |
Не более 300 символов. |
| Параметр |
Тип |
Ограничение |
id |
String |
Непустой. Не более 480 символов. Запятые и пробелы запрещены. |
Папки сохраненных фильтров
| Параметр |
Тип |
Ограничение |
name |
String |
Не более 255 символов. |
Версии
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 500 символов. |
description |
Option<String> |
Обязательный. Не более 2 000 символов. |
Учет времени
| Параметр |
Тип |
Ограничение |
comment |
Option<String> |
Не более 32 766 символов. |
Автодействия
В одной очереди может быть не более 100 автодействий.
| Параметр |
Тип |
Ограничение |
name |
String |
Не более 2 000 символов. |
description |
Option<String> |
Не более 2 000 символов. |
Рабочие календари
| Параметр |
Тип |
Ограничение |
name |
LocalizedString |
Обязательный. Не более 2 000 символов. |
Метасущности — общий интерфейс для проектов, портфелей, целей, отчетов и новых объектов. К их полям применяются те же ограничения по типу, что и к полям задач.
| Параметр |
Тип |
Ограничение |
systemFields |
MapF<String, Object> |
Значения должны соответствовать типам полей. |
storageFields |
MapF<String, Object> |
Значения должны соответствовать типам полей. |
customFields |
MapF<String, Object> |
Значения должны соответствовать типам полей. |
localFields |
MapF<String, Object> |
Значения должны соответствовать типам полей. |
Локальные поля
| Параметр |
Тип |
Ограничение |
key |
String |
Не более 30 символов. |
name |
LocalizedString |
Непустое значение для каждого заданного языка. Не более 50 символов. |
description |
Option<String> |
Не более 300 символов. |
Правила уведомлений
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 2 000 символов. |
Покер планирования
| Параметр |
Тип |
Ограничение |
issues |
ListF<IssueRef> |
Не более 100 задач. |
Регулярные действия
В одной очереди может быть не более 100 регулярных действий.
| Параметр |
Тип |
Ограничение |
name |
String |
Не более 2 000 символов. |
description |
Option<String> |
Не более 2 000 символов. |
launchesConfig.start |
Instant |
Дата начала не должна быть позже даты окончания. |
launchesConfig.end |
Instant |
Дата окончания не должна быть раньше текущего момента или даты начала. |
Правила SLA
В одной очереди может быть не более 30 правил SLA.
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 2 000 символов. |
thresholds |
ListF<SlaTimerThreshold> |
Обязательный. Длительность каждого порогового значения — от 1 минуты до 100 лет. |
Триггеры
В одной очереди может быть не более 1 000 триггеров.
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный, непустой. Не более 2 000 символов. |
description |
Option<String> |
Не более 2 000 символов. |
actions |
ListF<DbTriggerAction> |
Не более 10 действий. Формула в действии — не более 1 000 символов. |
| Параметр |
Тип |
Ограничение |
description |
String |
Обязательный. Не более 32 766 символов. |
Рабочие процессы
| Параметр |
Тип |
Ограничение |
name |
String |
Обязательный. Не более 2 000 символов. |