Категории — Решение типичных проблем¶

Как пользоваться этим документом¶

Секции организованы по типам проблем. Для каждой:

Симптом — что описывает клиент
Что проверить — шаги диагностики
Решение — что сделать
Эскалация — когда обращаться в поддержку 1Ф

1. Маршрут / жизненный цикл¶

Проблемы с переходами, статусами, кнопками.

1.1 Кнопка перехода не отображается / заблокирована¶

Симптом: пользователь не видит кнопку перехода на карточке задачи, или кнопка серая/неактивная.

Что проверить:

Текущий статус задачи — есть ли переход из этого статуса
Права пользователя на переход — в настройках маршрута указано, кто может выполнять переход
Обязательные ДП — все ли обязательные поля заполнены
Обязательные подписи — не ожидает ли задача согласования
Смарт-условие перехода — может быть условие, которое не выполнено

Решение:

Проверить права на переход в AdminSPA: Категория → Маршрут → Переход → Доступ
Проверить заполненность обязательных ДП
Если есть подписи на переходе — дождаться завершения согласования

Эскалация: если права есть, ДП заполнены, подписей нет, но кнопка недоступна.

1.2 Переход не срабатывает / задача «зависла» в статусе¶

Симптом: пользователь нажимает кнопку перехода, но задача остаётся в текущем статусе. Или задача «зависла» — переходы отображаются только после обновления страницы.

Что проверить:

Ошибка при переходе — появляется ли сообщение об ошибке
Автоматизация — не блокирует ли смарт-правило или автодействие переход
Подтверждение перехода — есть ли настроенное подтверждение, которое игнорируется автоматизацией

Решение:

Попросить обновить страницу (F5) — если после обновления переход виден, проблема в SignalR-доставке
Если ошибка при переходе — зафиксировать текст ошибки
Проверить журнал ошибок (Журналы → Ошибки)

Эскалация: с текстом ошибки, ID задачи, ID категории.

1.3 Задача неожиданно сменила статус¶

Симптом: задача перешла в другой статус без действия пользователя — «система сама перевела».

Что проверить:

Автошаги — настроены ли автоматические переходы на маршруте (например, по таймеру, по условию)
Смарт-правила — не сработало ли правило, которое инициирует переход
Пакетная обработка — не выполнял ли кто-то массовое действие
Интеграция — не пришёл ли статус из 1С или другой внешней системы

Решение:

Проверить историю задачи (лента/журнал) — кто и когда инициировал переход
Если инициатор «Система» — проверить автошаги и смарт-правила
Если инициатор конкретный пользователь — уточнить у него

1.4 Расхождение статусов (грид vs карточка)¶

Симптом: в гриде задача показывается в одном статусе, а при открытии карточки — в другом.

Что проверить:

Кеш грида — обновить грид (F5)
Денормализация — если используется денормализованная таблица, данные могут отставать
Мультизавершение — при мультизавершении задача может быть одновременно в разных состояниях для разных исполнителей

Решение:

Обновить грид
Если расхождение сохраняется после обновления — эскалация

1.5 Новый статус не отображается после создания¶

Симптом: создан новый статус в AdminSPA, но при настройке перехода он не появляется в списке.

Решение:

Обновить страницу AdminSPA
Проверить, что статус сохранён (не осталось в режиме редактирования)
Если не помогает — выйти из настроек маршрута и зайти заново

2. Перенос категории между площадками¶

Ошибки при экспорте/импорте через утилиту миграции.

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 (см. решение проблем по ДП, раздел 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)
Есть ли задачи в удалённой категории
Когда произошло удаление

Решение:

Восстановление удалённого раздела/категории — только через БД (обращение в поддержку 1Ф)
Объяснить пользователю, что удаление раздела не удаляет задачи, но скрывает их из навигации

Эскалация: любое восстановление требует вмешательства в БД.

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 категории / подкатегории
Версия системы
Тип проблемы — маршрут, настройка, перенос, права, создание задач, виды, БИ, правила, удаление
Один пользователь или все
Было обновление? — регрессия или давняя проблема
Скриншот / текст ошибки

Когда обращаться в поддержку 1Ф¶

Передайте обращение в поддержку 1Ф, если столкнулись с одним из следующих случаев:

Ошибки при переносе категории (утилита миграции)
Проблемы безопасности (доступ без прав)
Зависание БД / браузера
Регрессия маршрута после обновления
Задачи «зависают» в статусе без возможности перехода
Восстановление удалённых разделов/категорий (требует БД)
Неверная отработка правил при корректных настройках
Ошибки при частичном экспорте конфигурации