Jira · Cloud

Jira Cloud: почему быстрый фильтр показывает пустую доску

Проверяем базовый фильтр, JQL и отображение карточек на учебной Kanban-доске: два положительных сценария, отрицательная проверка и откат.

Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.

Задача и область применения

На доске есть задачи, но после выбора быстрого фильтра она становится пустой. Это ещё не означает, что данные удалены или сломан поиск. Нужно проверить несколько разных слоёв: исходную выборку доски, дополнительное условие, доступ пользователя и правила отображения карточек. Разбирать их удобнее последовательно, не меняя сразу сохранённый фильтр всей команды.

Инструкция относится к Jira Cloud и company-managed software-проектам. В новом интерфейсе Quick filters могут называться Custom filters; документация описывает оба варианта. В team-managed доступны собственные фильтры и настройки, поэтому путь через конфигурацию company-managed доски нельзя считать универсальным. Для Data Center сверяйте документацию установленного выпуска отдельно.

Ниже приведён учебный пилот на Kanban-доске без выполненных испытаний в реальном Jira-сайте. Его цель — показать, на каком уровне исчезает конкретная карточка. Ожидаемые результаты не являются отчётом об измерениях или подтверждением настройки вашей рабочей доски.

Сначала сохраните исходное состояние

Нужны тестовый company-managed проект PILOT, отдельная учебная доска, право администратора доски или соответствующего проекта и обычный пользователь для проверки результата. Запишите название доски, ссылку, исходный сохранённый фильтр, текущий JQL и список администраторов. Уточните владельца фильтра: права на настройки доски и управление сохранённым поиском могут отличаться.

Снимите выбранные быстрые фильтры, фильтр исполнителя и текстовый поиск на доске. Проверьте, что смотрите нужную доску и нужное представление. Не переносите рабочие задачи в другой статус только ради появления карточки. Для первого прогона используйте учебные данные, которые можно независимо открыть по ключу.

Если задача не открывается обычному пользователю по прямой ссылке, сначала разбирайте доступ. Видимость доски через общий фильтр не заменяет разрешение Browse для проектов с её задачами. Быстрый фильтр является способом сузить представление; скрытая карточка не становится недоступной в других разрешённых пользователю местах.

Подготовьте четыре контрольные задачи

Создайте в PILOT три безопасные задачи: PILOT-1 типа Bug с меткой pilot-board, PILOT-2 типа Task с той же меткой и PILOT-3 типа Bug без этой метки. Запишите фактические ключи, если Jira назначила другие номера. Все три должны находиться в статусе, сопоставленном видимой колонке учебной доски.

Четвёртую задачу типа Bug с меткой pilot-board подготовьте в отдельном тестовом проекте OTHER. Она нужна как отрицательный контроль границы базового фильтра. Проверяющий пользователь должен иметь доступ к обоим учебным проектам, чтобы отсутствие карточки OTHER нельзя было ошибочно объяснить отсутствием прав.

Для пилота используйте базовый фильтр project = PILOT ORDER BY Rank ASC и заранее проверьте, что без дополнительных условий видны ровно три контрольные карточки. Если этого не получилось, не переходите к настройке быстрого фильтра. Сначала сверяйте исходную выборку, сопоставление статусов колонкам и включение Kanban backlog.

Отделите базовую выборку от дополнительного условия

Выполните базовый запрос в расширенном поиске под тем же пользователем, затем сравните ключи с доской. У сохранённого фильтра есть владелец и настройки совместного доступа. Не нажимайте Save поверх общего поиска, когда требуется только проверить условие. Для эксперимента сохраняйте отдельный тестовый фильтр с понятным именем.

Добавьте быстрый фильтр с именем «Пилот: Bug» и условием issuetype = Bug. В классическом интерфейсе это Configure board → Quick Filters; в новом используйте меню доски и Manage custom filters. Путь может отличаться из-за поэтапного обновления интерфейса, поэтому ориентируйтесь на назначение настройки.

Ожидаемая выборка после включения только этого фильтра — PILOT-1 и PILOT-3. Задача OTHER не должна появиться, хотя она тоже Bug: дополнительный фильтр не добавляет задачи за пределами базовой выборки доски. Если ожидаете найти весь сайт, используйте расширенный поиск, а не кнопку быстрого фильтра.

Проверьте составное условие и Task как отрицательный тест

Создайте второй учебный фильтр «Пилот: Bug с меткой» с условием issuetype = Bug AND labels = "pilot-board". Снимите первый и остальные выбранные фильтры, затем включите только второй. Ожидаемый результат — одна карточка PILOT-1. PILOT-2 с меткой не подходит по типу, PILOT-3 не подходит по метке, OTHER остаётся вне базовой выборки.

Для независимой проверки объедините границу проекта и условие в расширенном поиске. Сравнивайте ключи, а не только количество: один неожиданный Task вместо одного Bug тоже даст число один. Если в вашем проекте нет типа с названием Bug, выберите фактический тип и согласованно замените его во всех контрольных сценариях.

Пример ниже — полный запрос для расширенного поиска. В поле быстрого фильтра вводится только дополнительное условие без project и ORDER BY. Это позволяет отдельно проверить логику условия и не путать её с сохранённой сортировкой доски.

project = PILOT AND (issuetype = Bug AND labels = "pilot-board") ORDER BY Rank ASC

Найдите ошибку логики или отображения

В JQL AND связывает условия сильнее, чем OR. Запрос project = PILOT AND issuetype = Bug OR labels = "pilot-board" в самостоятельном поиске способен включить задачи с меткой из другого проекта. Для требования «в PILOT либо Bug, либо задача с меткой» нужны скобки: project = PILOT AND (issuetype = Bug OR labels = "pilot-board"). Сначала сформулируйте нужное множество словами.

Если полный запрос возвращает нужные ключи, но карточек нет, проверьте статус и его колонку. В Kanban backlog размещение зависит также от сопоставления статусов и конфигурации backlog. Не исправляйте проблему переименованием или удалением статусов. В пилоте достаточно убедиться, что контрольный статус отображается там, где вы проверяете результат.

Личные View settings применяются к вашему представлению и могут отличаться у коллег. Отсутствие кнопки не всегда означает отсутствие настроенного фильтра: посмотрите меню и переключатель отображения custom filters. Ограничение числа задач в колонке также не является фильтром: документация указывает, что такие ограничения учитывают и скрытые быстрым фильтром задачи.

Проверьте обычным пользователем и запишите результат

Повторите исходное состояние и оба сценария под обычной учётной записью. В первом должны остаться два Bug, во втором — только Bug с меткой. Затем снимите фильтры: три исходные карточки должны вернуться. Не используйте результат администратора как единственное доказательство того, что доска работает для команды.

Отдельно подтвердите, что PILOT-2 по-прежнему открывается по прямой ссылке при включённом фильтре «Bug с меткой». Это полезный контроль: карточка скрыта логикой представления, но не удалена. Если задача не открывается, фиксируйте проблему доступа независимо от настройки быстрого фильтра.

В протоколе сохраните пользователя или роль без лишних персональных данных, базовый JQL, дополнительное условие, ожидаемые и фактически увиденные ключи. Укажите выбранное представление доски и состояние других фильтров. При расхождении найдите первый шаг, где отличается множество задач, вместо многократного изменения всех условий.

Откат и границы рабочего изменения

Для завершения учебного пилота снимите выбранные фильтры и удалите только два созданных вами тестовых quick/custom filter. Если редактировали существующий фильтр, восстановите его исходное имя, описание и JQL по сохранённой копии. Не удаляйте общую доску, сохранённый поиск команды или учебные проекты автоматически.

Если менялась базовая выборка доски, её возврат рассматривайте отдельно: восстановите исходную связь или запрос и снова проверьте контрольные задачи. Для описанного пилота этого изменения в рабочей конфигурации вообще не требуется. Права доступа и сопоставление колонок меняются только после отдельного разбора причины.

Переносите решение на рабочую доску после приёмки конкретного условия и согласования с её владельцем. Качественный результат — понятное назначение кнопки, проверенные положительный и отрицательный сценарии и простой возврат настройки. Пустая доска после слишком узкого фильтра сама по себе не является неисправностью Jira.

Официальная документация

Применить это к вашей системе

Обсудим контекст, ограничения и безопасный порядок изменений.

Обсудить задачу