Категории — Решение типичных проблем¶
Аудитория: ТП 1-й линии (без доступа к БД)
Как пользоваться этим документом¶
Секции организованы по типам проблем. Для каждой: 1. Симптом — что описывает клиент 2. Что проверить — шаги диагностики 3. Решение — что сделать 4. Эскалация — когда передавать на 2-ю линию
Секции [2L] — заглушки для будущей SQL-диагностики.
1. Маршрут / жизненный цикл¶
Самая частая тема — ~25% обращений по категориям. Проблемы с переходами, статусами, кнопками.
1.1 Кнопка перехода не отображается / заблокирована¶
Симптом: пользователь не видит кнопку перехода на карточке задачи, или кнопка серая/неактивная.
Что проверить: - Текущий статус задачи — есть ли переход из этого статуса - Права пользователя на переход — в настройках маршрута указано, кто может выполнять переход - Обязательные ДП — все ли обязательные поля заполнены - Обязательные подписи — не ожидает ли задача согласования - Смарт-условие перехода — может быть условие, которое не выполнено
Решение: - Проверить права на переход в AdminSPA: Категория → Маршрут → Переход → Доступ - Проверить заполненность обязательных ДП - Если есть подписи на переходе — дождаться завершения согласования
Эскалация: если права есть, ДП заполнены, подписей нет, но кнопка недоступна.
1.2 Переход не срабатывает / задача «зависла» в статусе¶
Симптом: пользователь нажимает кнопку перехода, но задача остаётся в текущем статусе. Или задача «зависла» — переходы отображаются только после обновления страницы.
Что проверить: - Ошибка при переходе — появляется ли сообщение об ошибке - Автоматизация — не блокирует ли смарт-правило или автодействие переход - Подтверждение перехода — есть ли настроенное подтверждение, которое игнорируется автоматизацией
Решение: - Попросить обновить страницу (F5) — если после обновления переход виден, проблема в SignalR-доставке - Если ошибка при переходе — зафиксировать текст ошибки - Проверить журнал ошибок (Журналы → Ошибки)
Эскалация: с текстом ошибки, ID задачи, ID категории.
1.3 Задача неожиданно сменила статус¶
Симптом: задача перешла в другой статус без действия пользователя — «система сама перевела».
Что проверить: - Автошаги — настроены ли автоматические переходы на маршруте (например, по таймеру, по условию) - Смарт-правила — не сработало ли правило, которое инициирует переход - Пакетная обработка — не выполнял ли кто-то массовое действие - Интеграция — не пришёл ли статус из 1С или другой внешней системы
Решение: - Проверить историю задачи (лента/журнал) — кто и когда инициировал переход - Если инициатор «Система» — проверить автошаги и смарт-правила - Если инициатор конкретный пользователь — уточнить у него
1.4 Расхождение статусов (грид vs карточка)¶
Симптом: в гриде задача показывается в одном статусе, а при открытии карточки — в другом.
Что проверить: - Кеш грида — обновить грид (F5) - Денормализация — если используется денормализованная таблица, данные могут отставать - Мультизавершение — при мультизавершении задача может быть одновременно в разных состояниях для разных исполнителей
Решение: - Обновить грид - Если расхождение сохраняется после обновления — эскалация
1.5 Новый статус не отображается после создания¶
Симптом: создан новый статус в AdminSPA, но при настройке перехода он не появляется в списке.
Решение: - Обновить страницу AdminSPA - Проверить, что статус сохранён (не осталось в режиме редактирования) - Если не помогает — выйти из настроек маршрута и зайти заново
2. Перенос категории между площадками¶
~15% обращений. Ошибки при экспорте/импорте через утилиту миграции.
2.1 Ошибка при переносе категории¶
Симптом: при экспорте или импорте категории через утилиту миграции — ошибка.
Что проверить: - Текст ошибки — что именно не перенеслось - Версия утилиты миграции — совместима ли с версиями площадок - Совместимость версий источника и приёмника
Типичные ошибки: - «Mapping types» — несовместимость типов данных - «ExtParamLink с новыми ID» — связи ДП получают новые ID на площадке-приёмнике (ожидаемое поведение) - «Не подтягиваются ExtParamsInSubcatToBlocks и ExtParamStateView» — известная проблема в некоторых версиях утилиты
Решение: - Для несовместимости версий — обновить утилиту или площадки до одинаковой версии - Для ExtParamLink — после переноса пересоздать связи на площадке-приёмнике - Для блоков/прав — пересоздать вручную после переноса
Эскалация: с текстом ошибки, версиями обеих площадок, ID переносимой категории.
2.2 Копирование категории — проблемы¶
Симптом: при копировании категории дублируются JS-вставки, не копируются ресурсы локализации.
Решение: - JS-вставки: после копирования проверить и удалить дубли вручную - Локализация: не копируется — настроить вручную на копии
3. Создание задач¶
3.1 Невозможно создать задачу в категории¶
Симптом: пользователь не может создать задачу — кнопка «Создать» недоступна или при создании ошибка.
Что проверить: - Права пользователя на создание задач в этой категории - Обязательные ДП — есть ли ДП без значения по умолчанию, которые блокируют создание - Маршрут — есть ли начальный статус - Ошибка — текст ошибки (переполнение лога, таймаут и т.д.)
Решение: - Проверить права: Категория → Доступ → право на создание - Если ошибка при создании — зафиксировать
3.2 Шаблон задач / шаг постановки¶
Симптом: после обновления слетает шаг постановки, шаблон задач не работает.
Что проверить: - Настройку шаблона задач в категории - Не сбросились ли настройки после обновления
4. Настройки категории (AdminSPA)¶
4.1 Не открываются настройки категории¶
Симптом: при попытке открыть настройки категории в AdminSPA — ошибка или пустая страница.
Что проверить: - Версия AdminSPA - Через какой путь открываются (боковое меню vs список пространств — ссылки разные) - Доступ пользователя к AdminSPA
Решение: - Попробовать открыть через другой путь (боковое меню) - Обновить страницу - Если не помогает — эскалация
4.2 Категория не отображается / не видна¶
Симптом: пользователь не видит категорию в навигации или при поиске.
Что проверить: - Права пользователя на категорию (чтение) - Не скрыта ли категория в настройках навигации - Не является ли архивной
Решение: - Проверить права в AdminSPA: Категория → Доступ - Проверить видимость в навигации
4.3 Проблемы с JS-вставками и кнопками¶
Симптом: JS-вставки (MTF) не отображаются в настройках категории, кнопки категории с иконкой — имя не видно.
4.4 Сводный раздел — проблемы¶
Симптом: в сводном разделе показываются задачи не из всех категорий, не все статусы отображаются при добавлении категории.
Что проверить: - Настройку сводного раздела — все ли категории добавлены - Статусы — выбраны ли нужные статусы для каждой категории
Решение: - Проверить настройки сводного раздела в AdminSPA - Добавить недостающие статусы
5. Права и доступ¶
5.1 Права на категорию — не работают как ожидается¶
Симптом: «как проверить права?», «гибкий доступ не работает», «пользователь видит/не видит задачи».
Что проверить: - Тип доступа к категории (стандартный, гибкий, конфиденциальный) - Права конкретного пользователя — через какие группы/роли назначены - Для гибкого доступа — настройки EPRights
Решение: - Для проверки прав: AdminSPA → Категория → Доступ → найти пользователя - При гибком доступе — проверить настройки EPRightsFlat/Lkp/Mlt (см. ext-params/support-guide.md секция 4)
5.2 Доступ к переходам появляется у пользователей без прав¶
Симптом: периодически пользователи без прав видят кнопки переходов.
Что проверить: - Не кешируется ли UI (старые данные в браузере) - Не является ли пользователь заместителем кого-то с правами - Не настроены ли права через группу, в которую пользователь входит
Эскалация: если проблема стабильно воспроизводится — это проблема безопасности.
6. Производительность¶
6.1 Зависание при открытии категории / задачи¶
Симптом: браузер зависает при переходе в карточку задачи или при просмотре категории.
Что проверить: - Количество задач в категории - Количество ДП на форме задачи - Наличие тяжёлых JS-вставок
Решение: - Если много задач — рекомендовать фильтрацию - Если зависает на конкретной задаче — проверить ДП (тяжёлые таблицы, большие файлы)
6.2 Денормализация — медленно / не заполняются колонки¶
Симптом: денормализация категории работает медленно (особенно при синхронизации с 1С), колонки в денормализованных таблицах не заполняются.
Что проверить: - Запущен ли job денормализации - Количество задач в категории
Эскалация: при таймаутах и незаполненных колонках.
6.3 Проектный Гант — ошибки в категории¶
Симптом: при попытке открыть проектный Гант в категории — ошибка. Или при повторном открытии Ганта в ПУ автоматически подставляется не та категория.
Что проверить: - Настроен ли Гант для данной категории - Есть ли задачи с корректными датами (начало/окончание) - При повторном открытии — не кешируется ли предыдущий выбор категории
Решение: - Проверить настройки Ганта в категории - При подстановке не той категории — закрыть и открыть заново, очистить кеш браузера
Эскалация: если ошибка стабильно воспроизводится при наличии корректных данных.
7. Пользовательские настройки и виды¶
7.1 Вид по умолчанию не применяется / не сохраняются пользовательские настройки¶
Симптом: настроенный вид по умолчанию в категории не применяется при входе. Или пользовательские настройки отображения (колонки, фильтры, сортировка) сбрасываются между сессиями.
Что проверить: - Настроен ли вид по умолчанию в AdminSPA для категории - Не перекрывает ли пользовательский вид системный - Версия системы — может быть регрессия после обновления - Воспроизводится ли у одного пользователя или у всех
Решение: - Проверить настройки видов в AdminSPA: Категория → Виды - Попросить пользователя сбросить пользовательские настройки (если есть такая кнопка) - Если регрессия после обновления — эскалация
7.2 Признак «Отображать Статус» в настройках категории¶
Симптом: вопросы по работе признака «Отображать Статус» в настройках категории — непонятно поведение, не влияет на отображение, или влияет не так, как ожидается.
Что проверить: - Значение настройки в AdminSPA: Категория → Основные настройки - Как именно ожидается поведение vs. фактическое
Решение: - Объяснить назначение настройки (управляет видимостью колонки статуса в гриде) - Если поведение не соответствует документации — эскалация
8. Удаление и восстановление категорий¶
8.1 Удаление категорий / случайное удаление раздела¶
Симптом: пользователь случайно удалил раздел с подкатегориями и хочет восстановить. Или вопрос о процедуре удаления категорий.
Что проверить: - Что именно удалено — раздел (Categories) или категория (Subcategories) - Есть ли задачи в удалённой категории - Когда произошло удаление
Решение: - Восстановление удалённого раздела/категории — только через БД (эскалация на 2-ю линию) - Объяснить пользователю, что удаление раздела не удаляет задачи, но скрывает их из навигации
Эскалация: любое восстановление требует вмешательства в БД.
9. Логирование и аудит настроек¶
9.1 Нет логирования изменений настроек из новой админки¶
Симптом: изменения настроек категории через новую AdminSPA не отображаются в журнале категории. Невозможно отследить, кто и когда менял настройки.
Что проверить: - Тип изменённой настройки — часть настроек может не логироваться в текущей версии - Версия системы
Решение: - Подтвердить клиенту, что это известное ограничение новой AdminSPA — логирование реализовано не для всех типов настроек - Зафиксировать как запрос на доработку при необходимости
10. Экспорт конфигурации¶
10.1 Частичный экспорт — отсутствуют разделы¶
Симптом: при частичном экспорте конфигурации категории в выгрузке отсутствуют некоторые разделы (блоки настроек).
Что проверить: - Какие именно разделы отсутствуют в экспорте - Версия системы и утилиты экспорта - Есть ли зависимости между отсутствующими разделами и другими сущностями
Решение: - Зафиксировать перечень отсутствующих разделов - Эскалация — это может быть баг утилиты экспорта
11. БИ (бизнес-индикаторы) в категории¶
11.1 Не добавляется или не открывается БИ¶
Симптом: невозможно добавить бизнес-индикатор в категорию, или при открытии раздела БИ — ошибка.
Что проверить: - Есть ли права на управление БИ в данной категории - Версия системы - Текст ошибки
Решение: - Проверить права на настройку БИ - Если ошибка при открытии — зафиксировать текст и эскалировать
Эскалация: с текстом ошибки, ID категории.
12. Автоматизация и правила в категории¶
12.1 Неверная отработка правил / интеграций¶
Симптом: смарт-правила в категории срабатывают некорректно — не тот результат, не в тот момент, или не срабатывают вовсе. Интеграция (1С и др.) в категории перестала работать.
Что проверить: - Настройки правил в AdminSPA: Категория → Автоматизация → Правила - Условия срабатывания — выполнены ли - Для интеграции — не изменились ли настройки после обновления - Журнал ошибок
Решение: - Проверить условия и действия правила - Для интеграции — проверить настройки подключения и маппинг полей - Если правило настроено корректно, но работает неверно — эскалация
13. Прочие частые вопросы¶
13.1 Пакетная обработка — ошибки¶
Симптом: «Пакетное действие поддерживается только для задач в одной категории» — хотя задачи из одной категории.
Что проверить: - Выделены ли задачи из одной категории (в сводном разделе могут быть из разных) - Не перемешаны ли задачи из разных подкатегорий
13.2 Шевроны маршрута стали кликабельными¶
Симптом: шевроны статусов на карточке задачи стали реагировать на клик (раньше не реагировали).
Решение: это изменение поведения в новой версии — шевроны теперь интерактивны. Объяснить пользователю.
13.3 Приоритет отображается в категории, где запрещён¶
Симптом: в категории с отключённым приоритетом он всё равно отображается.
Что проверить: - Настройку категории — отключён ли приоритет - Версию системы
13.4 Маршрут задачи не открывается в новой вкладке¶
Симптом: при попытке открыть маршрут задачи в новой вкладке браузера (Ctrl+Click, средняя кнопка мыши) — страница не загружается или отображается ошибка.
Что проверить: - Воспроизводится ли в разных браузерах - Работает ли открытие маршрута в той же вкладке - Версия системы
Решение: - Если открытие в той же вкладке работает — известное ограничение SPA, маршрут может не поддерживать прямую навигацию - Эскалация если не работает и в той же вкладке
13.5 Настройка общего поиска по категории¶
Симптом: вопросы по настройке общего поиска внутри категории — как включить, какие поля индексируются.
Решение: - Объяснить настройку поиска: AdminSPA → Категория → Настройки поиска - Указать, что индексируются ДП, для которых включён флаг «Поиск»
13.6 Вопросы по структуре БД категорий¶
Симптом: клиент спрашивает, в какой таблице хранятся значения категории определённого типа (справочник и т.д.).
Решение: - Перенаправить на документацию по структуре БД - Консультационные вопросы по структуре БД — не задача ТП, перенаправить на документацию или обучение
Чеклист для первичной диагностики¶
- ID категории / подкатегории
- Версия системы
- Тип проблемы — маршрут, настройка, перенос, права, создание задач, виды, БИ, правила, удаление
- Один пользователь или все
- Было обновление? — регрессия или давняя проблема
- Скриншот / текст ошибки
Когда эскалировать¶
- Ошибки при переносе категории (утилита миграции)
- Проблемы безопасности (доступ без прав)
- Зависание БД / браузера
- Регрессия маршрута после обновления
- Задачи «зависают» в статусе без возможности перехода
- Восстановление удалённых разделов/категорий (требует БД)
- Неверная отработка правил при корректных настройках
- Ошибки при частичном экспорте конфигурации