Справочник полей формул Quire Permalink
В этом руководстве описаны все ссылки на поля формул Quire: поля задач, поля проектов, участники, журналы времени и расширения пользовательских полей. Используйте эту страницу как справочник при написании формул в Quire.
Ссылки на поля задачи
| Имя поля | Тип поля | Описание | Пример | Примечания |
|---|---|---|---|---|
| me | Участник | Текущий пользователь | me in assignees |
|
| low | Стрелка приоритета | Стрелка низкого приоритета | subtasks.priority > low |
|
| medium | Стрелка приоритета | Стрелка среднего приоритета | subtasks.priority > medium |
|
| high | Стрелка приоритета | Стрелка высокого приоритета | subtasks.priority > high |
|
| urgent | Стрелка приоритета | Стрелка срочного приоритета | subtasks.priority > urgent |
|
| priority | Стрелка приоритета | Цветная стрелка приоритета задачи | subtasks.priority |
Подробнее о приоритете. |
| id | Число | Уникальный числовой идентификатор задачи | subtasks.id |
|
| name | Текст | Имя задачи | subtasks.name |
|
| description | Текст | Описание задачи | subtask.description |
|
| status | Значок статуса | Значок статуса задачи | subtasks.status |
Подробнее о статусе. |
| previousStatus | Значок статуса | Значок предыдущего статуса задачи | subtasks.previousStatus |
Подробнее о previousStatus. |
| start | Дата и время | Дата начала и время начала задачи | subtasks.start |
|
| due | Дата и время | Срок исполнения задачи и время | parent.due |
|
| duration | Длительность | Общая длительность от даты начала до срока исполнения | subtasks.duration |
|
| peekaboo | Флажок | Скрыта ли задача | subtasks.peekaboo |
|
| archivedAt | Дата и время | Дата и время скрытия задачи | parent.archivedAt |
|
| archivedBy | Участник | Участник, скрывший задачу | parent.archivedBy |
|
| reshowAt | Дата и время | Дата и время повторного показа задачи | parent.reshowAt |
|
| assignees | Участник | Исполнитель задачи | COUNT(subtasks.assignees) |
Внешние команды, назначенные на задачу, не учитываются. |
| assignors | Участник | Участник, назначивший задачу | subtasks.assignors |
Подробнее об assignors. |
| externalTeam | Внешняя команда | Внешняя команда, назначенная на задачу | externalTeam.name |
Если Внешняя команда назначена родительской задаче, она появится в том же поле у подзадач. |
| tags | Метки | Метки, добавленные к задаче | subtasks.tags |
Подробнее о метках. |
| level | Число | Номер уровня задачи | MAX(descendants. level) |
|
| editedAt | Дата и время | Дата и время последнего редактирования задачи | parent.editedAt |
|
| toggledAt | Дата и время | Дата и время изменения статуса задачи | parent.toggledAt |
|
| toggledBy | Участник | Участник, изменивший статус задачи | toggledBy.name |
|
| createdAt | Дата и время | Дата и время создания задачи | parent.createdAt |
|
| createdBy | Участник | Участник, добавивший задачу | createdBy.name |
|
| completedAt | Дата и время | Дата и время завершения задачи | parent.completedAt |
|
| completedBy | Участник | Участник, завершивший задачу | parent.completedBy |
|
| timelogs | Количество записей времени | Количество записей времени, добавленных к задаче | timelogs.duration |
Подробнее о журналах времени. |
| timeSpent | Время | Общее затраченное на задачу время | subtasks.timeSpent |
|
| billingTimelogs | Количество записей времени | Количество оплачиваемых записей времени, добавленных к задаче | billingTimelogs.duration |
Подробнее о журналах времени. |
| billingTimeSpent | Время | Общее оплачиваемое время, затраченное на задачу | subtasks.billingTimeSpent |
|
| estimated | Время | Оценочное время выполнения задачи | SUM(subtasks.estimated) |
|
| favorites | Участник | Участник, добавивший задачу в избранное | favorites.name |
|
| attachments | Количество вложений | Количество вложений, добавленных к задаче | attachments.name |
Подробнее о вложениях. |
| comments | Количество комментариев | Количество комментариев, добавленных к задаче | comments.attachments |
Подробнее о комментариях. |
| subtasks | Список задач | Список всех подзадач первого уровня | subtasks[0].{Cost} |
|
| activeSubtasks | Список задач | Список всех активных подзадач первого уровня | SUM(activeSubtasks.{Cost}) |
|
| completedSubtasks | Список задач | Список всех завершённых подзадач первого уровня | SUM(completedSubtasks.{Cost}) |
|
| descendants | Список задач | Список всех подзадач задачи на всех уровнях | SUM(descendants.{Cost}) |
|
| activeDescendants | Список задач | Список всех активных подзадач задачи на всех уровнях | SUM(activeDescendants.{Cost}) |
|
| completedDescendants | Список задач | Список всех завершённых подзадач задачи на всех уровнях | SUM(completedDescendants.{Cost}) |
|
| parent | Задача | Непосредственная родительская задача | parent.due |
|
| section | Задача | Ближайшая родительская задача, являющаяся секцией | section.name |
|
| ancestors | Список задач | Список всех родительских задач задачи | ancestors.due |
|
| project | Проект | Проект, которому принадлежит задача | project.name |
Подробнее о проекте. |
| organization | Организация | Организация, которой принадлежит задача | organization.name |
Подробнее об организациях. |
Расширения полей с помощью точечного оператора
С помощью точечного оператора (.) можно получить конкретное свойство поля.
Пример:
priority→ возвращает значок приоритетаpriority.value→ возвращает числовое значение приоритетаpriority.name→ возвращает текстовую метку
Этот подход применим к таким полям, как приоритет, статус, участники, проекты, метки и пользовательские поля.
Ссылки на поля проекта
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| id | Текст | Идентификатор проекта | project.id |
| name | Текст | Имя проекта | project.name |
| start | Дата | Дата начала проекта | project.start |
| due | Дата | Срок исполнения проекта | project.due |
| color | Код цвета | Цвет проекта | project.color |
| roots | Список задач | Список всех задач первого уровня (корневых задач) в проекте | project.roots |
| activeRoots | Список задач | Список всех активных задач первого уровня (корневых задач) в проекте | project.activeRoots |
| completedRoots | Список задач | Список всех завершённых задач первого уровня (корневых задач) в проекте | project.completedRoots |
| tasks | Список задач | Список всех задач в проекте | project.tasks |
| activeTasks | Список задач | Список всех активных задач в проекте | project.activeTasks |
| completedTasks | Список задач | Список всех завершённых задач в проекте | project.completedTasks |
| organization | Организация | Организация, которой принадлежит проект | project.organization |
Ссылки на поля организации
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| id | Текст | Идентификатор организации | organization.id |
| name | Текст | Имя организации | organization.name |
| color | Код цвета | Цвет организации | organization.color |
Ссылки на поля подсписка
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| id | Текст | Идентификатор подсписка | sublists.id |
| name | Текст | Имя подсписка | sublists.name |
| start | Дата | Дата начала подсписка | sublists.start |
| due | Дата | Срок исполнения подсписка | sublists.due |
| color | Код цвета | Цвет подсписка | sublists.color |
Примечание. Имя или идентификатор подсписка обязательно заключайте в квадратные скобки [ ]. Например, sublists['Design'].due вернёт срок исполнения подсписка с именем «Design».
Ссылки на поля участников (assignees, assignors)
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| id | Текст | Идентификатор пользователя — имя учётной записи | assignees.id |
| name | Текст | Имя участника | assignees.name |
| Текст | E-mail участника | assignees.email |
|
| color | Код цвета | Цвет участника | assignees.color |
Ссылки на поля вложений
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| name | Текст | Имя вложения | attachments.name |
| url | Текст | URL вложения | attachments.url |
| size | Число | Размер вложения | attachments.size |
| createdAt | Дата и время | Дата и время добавления вложения | attachments.createdAt |
| createdBy | Участник | Участник, добавивший вложение | attachments.createdBy |
Ссылки на поля комментариев
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| description | Текст | Все комментарии, добавленные к задаче | comments.description |
| attachments | Количество вложений | Количество вложений, добавленных к комментариям | comments.attachments |
| createdAt | Дата и время | Дата и время добавления комментария | comments.createdAt |
| createdBy | Участник | Участник, добавивший комментарий | comments.createdBy |
Ссылки на поля внешних команд и меток
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| name | Текст | Имя Внешней команды или меток | externalTeam.name или tags.name |
| color | Код цвета | Цвет Внешней команды | externalTeam.color или tags.color |
Ссылки на поля журнала времени
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| user | Участник | Участник, добавивший записи времени к задаче | timelogs.user |
| start | Дата | Дата начала записи времени | timelogs.start |
| end | Дата | Дата окончания записи времени | timelogs.end |
| duration | Длительность | Длительность записей времени, добавленных к задаче | timelogs.duration |
| billable | Флажок | Логическое значение — оплачиваемая ли запись времени | timelogs.billable |
| note | Текст | Заметки к записям времени задачи | timelogs.note |
Ссылки на поля приоритета и статуса
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| name | Текст | Имя приоритета или статуса | priority.name или status.name |
| value | Число | Значение приоритета или статуса | priority.value или status.value |
| color | Код цвета | Цвет приоритета или статуса | priority.color или status.color |
Ссылки на поля валюты
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| currency | Текст | Символ валюты в поле валюты | Cost.currency |
| value | Число | Значение валюты в поле валюты | Cost.value |
Примечание. Перед использованием в формулах необходимо создать числовое пользовательское поле (например, Cost).
Ссылки на поля выбора
| Имя поля | Тип поля | Описание | Пример |
|---|---|---|---|
| name | Текст | Имя выбранных вариантов | Categories.name |
| color | Код цвета | Цвет выбранных вариантов | Categories.color |
Примечание. Перед использованием в формулах необходимо создать числовое пользовательское поле (например, Cost).
Часто задаваемые вопросы
Какие поля задачи можно использовать в формуле Quire?
К встроенным полям задачи относятся name, id, status, priority, start, due, duration, assignees, tags, timeSpent, estimated, createdBy, completedAt и многие другие. Полный список см. в разделе Ссылки на поля задачи.
Как получить числовое значение или цвет приоритета либо статуса в формуле Quire?
Используйте точечную нотацию: priority.value возвращает числовое значение, priority.name — текстовую метку, а priority.color — код цвета. То же самое работает для status.
Как сослаться на подзадачи и на всех потомков в формуле Quire?
Используйте subtasks для подзадач только первого уровня или descendants — для всех уровней. Для отфильтрованных подмножеств подойдут activeSubtasks, completedSubtasks, activeDescendants или completedDescendants.
Как ссылаться на поля проекта в формуле Quire?
Используйте project.fieldname — например, project.name возвращает имя проекта, а project.tasks — все задачи. Для отфильтрованных списков применяйте project.activeTasks или project.completedTasks.
Как сослаться на данные об участнике, например имя или e-mail исполнителя, в формуле Quire?
Используйте точечную нотацию для полей участников: assignees.name возвращает отображаемое имя, assignees.email — e-mail, а assignees.id — идентификатор пользователя.
Как сослаться на данные журнала времени в формуле Quire?
Используйте timelogs.fieldname — например, timelogs.duration возвращает длительность записи времени, а timelogs.billable — логический признак оплачиваемости. Для записей, помеченных как оплачиваемые, используйте billingTimelogs.
Как сослаться на срок исполнения или имя подсписка в формуле Quire?
Используйте sublists['SublistName'].fieldname — например, sublists['Design'].due возвращает срок исполнения подсписка с именем «Design».
Пожалуйста свяжитесь с нами, если вам необходима дополнительная помощь.