Формулы можно использовать внутри:
- Столбцы формулы — выражение вычисляется для каждой видимой строки в отображаемой структуре или результате запроса.
- Автоматизация — формулы можно использовать для фильтрации структуры (Фильтрация по атрибуту), сортировки структуры (Сортировка по атрибуту) или группировки задач (Группировка по текстовому атрибуту) на основе результатов формулы.
- Эффекторы — результаты формулы можно записать в поле Jira с помощью эффектора поля «Атрибут для задачи».
В следующем руководстве мы покажем, что вам нужно было ввести формулу в столбец формулы. Те же шаги можно использовать в автоматизации, включая эффекторы.
-
Введите формулу
Формулы должны быть построены с использованием Expr Language, простого языка, который поддерживает переменные, арифметические операции и функции. Краткий обзор см. в разделе Expr Language.
Когда закончите, нажмите "Save", «Сохранить».
-
Проверьте свою формулу
Когда вы нажмете «Сохранить», Structure просмотрит вашу формулу, попытается связать ваши переменные с полями задач или другими атрибутами и уведомит вас о любых ошибках. Если формула готова к использованию, отображается зеленая метка. Если это не так, проблемные части выделяются в редакторе формул красным цветом.
Если нет проблем, все готово! Если вы работаете со столбцом формулы, результаты появятся рядом с редактором.
Приведенный выше пример представляет собой простую формулу для расчета того, уложимся ли мы в цель и завершим каждый эпик вовремя:
КОД
IF type = "epic" :
originalEstimate - SUM#children { timeSpent + remainingEstimate }
Если вы еще не владеете Expr, мы советуем Structure:
- Проверьте, является ли тип задачи эпическим: IF type = "epic":
- Если это так, добавьте расчетное время, затраченное и оставшееся, для каждой дочерней задачи: {timeSpent + RemainingEstimate}
- Суммарное значение для всех дочерних задач: SUM#children
- Вычтите эту сумму из исходной оценки эпоса: originalEstimate - ...
Если вы не уверены, какую формулу хотите создать, попробуйте использовать одну из наших объединенных формул — просто нажмите “Load formula”, «Загрузить формулу...», чтобы увидеть доступные варианты.
Обработка ошибок
Ошибки в формулах обычно возникают по одной из следующих причин:
- Несопоставленные переменные — структура пытается сопоставить ваши переменные с известными атрибутами; однако, в зависимости от того, как вы назвали переменную, вам может потребоваться отобразить ее вручную.
- Синтаксическая ошибка — возникает, когда Структура что-то не понимает в вашей формуле. Часто это так же просто, как отсутствие закрывающей скобки или другого знака препинания. Просмотрите формулу и обратитесь к нашему руководству Expr Language, если вы не знаете, как ее исправить. Часть формулы, которую не удалось разобрать, будет выделена красным цветом.
- Ошибка разрешения функции — возникает, когда формула содержит неизвестную функцию. Просмотрите формулу и убедитесь, что функции, отмеченные красным, написаны правильно. Если это так, проверьте наш справочник по функциям Expr и справочник по агрегатным функциям, чтобы убедиться, что вы используете поддерживаемую функцию.
- Ошибка валидации выражения — возникает, когда в формуле есть недопустимая конструкция. Наведите указатель мыши на выделенную красным цветом часть формулы, чтобы увидеть сообщение об ошибке. Если выделено несколько областей, необходимо исправить несколько ошибок. Проверьте список возможных ошибок проверки, чтобы узнать больше.
Обработка неожиданных результатов
В некоторых случаях формула может пройти проверку, но результаты будут не такими, как вы ожидали. Вам может просто понадобиться отредактировать свои переменные, опции или формат; или вам может потребоваться пересмотреть саму формулу, нажав кнопку «Изменить».
Полноэкранный
Начальный размер редактора формул довольно мал. Если вам нужно больше места, перетащите угол поля или нажмите "Full-Screen", «Во весь экран», чтобы развернуть окно.
Дополнительные ресурсы
- Сопоставление переменных
- Выражение Язык
- Примеры формул
- Справочная документация по формулам
По материалам Atlassian JIRA Structure: Creating a Formula