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

Руководство для первой линии поддержки и администраторов площадок 1Формы по диагностике и решению типовых проблем с категориями: маршруты и переходы, перенос между площадками, права доступа, производительность, денормализация, AdminSPA, БИ, автоматизация. Каждая секция сгруппирована по типу проблемы и содержит симптом, шаги проверки, решение и условия эскалации в поддержку 1Ф. Для описания настроек категорий и проектирования маршрутов см. domains/categories/business.md и domains/categories/academy-patterns.md.

Секции организованы по типам проблем. Для каждой: симптом — что описывает клиент; что проверить — шаги диагностики; решение — что сделать; эскалация — когда обращаться в поддержку 1Ф.

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

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

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

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

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

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

Решение:

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

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

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

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

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

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

Решение:

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

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

Задача неожиданно сменила статус / расхождение статусов¶

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

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

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

Решение:

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

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

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

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

Ошибка при переносе категории¶

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

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

Текст ошибки — что именно не перенеслось
Версия утилиты миграции — совместима ли с версиями площадок
Совместимость версий источника и приёмника

Типичные ошибки:

«Mapping types» — несовместимость типов данных
«ExtParamLink с новыми ID» — связи ДП получают новые ID на площадке-приёмнике (ожидаемое поведение)
«Не подтягиваются ExtParamsInSubcatToBlocks и ExtParamStateView» — известная проблема в некоторых версиях утилиты

Решение:

Для несовместимости версий — обновить утилиту или площадки до одинаковой версии
Для ExtParamLink — после переноса пересоздать связи на площадке-приёмнике
Для блоков/прав — пересоздать вручную после переноса

Эскалация: с текстом ошибки, версиями обеих площадок, ID переносимой категории.

Копирование категории — проблемы: при копировании категории дублируются JS-вставки, не копируются ресурсы локализации. JS-вставки: после копирования проверить и удалить дубли вручную. Локализация: не копируется — настроить вручную на копии.

3. Создание задач¶

Невозможно создать задачу / шаблон задач не работает¶

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

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

Права пользователя на создание задач в этой категории
Обязательные ДП — есть ли ДП без значения по умолчанию, которые блокируют создание
Маршрут — есть ли начальный статус
Ошибка — текст ошибки (переполнение лога, таймаут и т.д.)
Настройку шаблона задач в категории
Не сбросились ли настройки после обновления

Решение:

Проверить права: Категория → Доступ → право на создание
Если ошибка при создании — зафиксировать

4. Настройки категории (AdminSPA)¶

Настройки AdminSPA — типичные проблемы¶

Не открываются настройки категории: при попытке открыть настройки категории в AdminSPA — ошибка или пустая страница. Проверить версию AdminSPA, путь открытия (боковое меню vs список пространств — ссылки разные), доступ пользователя к AdminSPA. Попробовать открыть через другой путь (боковое меню), обновить страницу. Если не помогает — эскалация.

Категория не отображается / не видна: пользователь не видит категорию в навигации или при поиске. Проверить права пользователя на категорию (чтение), не скрыта ли категория в настройках навигации, не является ли архивной. Проверить права в AdminSPA: Категория → Доступ. Проверить видимость в навигации.

Проблемы с JS-вставками и кнопками: JS-вставки (MTF) не отображаются в настройках категории, кнопки категории с иконкой — имя не видно.

Сводный раздел — проблемы: в сводном разделе показываются задачи не из всех категорий, не все статусы отображаются при добавлении категории. Проверить настройки сводного раздела — все ли категории добавлены, выбраны ли нужные статусы для каждой категории. Проверить настройки сводного раздела в AdminSPA, добавить недостающие статусы.

5. Права и доступ¶

Права на категорию — не работают как ожидается¶

Симптом: «как проверить права?», «гибкий доступ не работает», «пользователь видит/не видит задачи».

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

Тип доступа к категории (стандартный, гибкий, конфиденциальный)
Права конкретного пользователя — через какие группы/роли назначены
Для гибкого доступа — настройки EPRights

Решение:

Для проверки прав: AdminSPA → Категория → Доступ → найти пользователя
При гибком доступе — проверить настройки EPRightsFlat/Lkp/Mlt (см. решение проблем по ДП, раздел 4)

Доступ к переходам появляется у пользователей без прав: периодически пользователи без прав видят кнопки переходов. Проверить, не кешируется ли UI (старые данные в браузере), не является ли пользователь заместителем кого-то с правами, не настроены ли права через группу, в которую пользователь входит. Эскалация если проблема стабильно воспроизводится — это проблема безопасности.

6. Производительность¶

Зависание при открытии / денормализация / проектный Гант¶

Зависание при открытии категории / задачи: браузер зависает при переходе в карточку задачи или при просмотре категории. Проверить количество задач в категории, количество ДП на форме задачи, наличие тяжёлых JS-вставок. Если много задач — рекомендовать фильтрацию. Если зависает на конкретной задаче — проверить ДП (тяжёлые таблицы, большие файлы).

Денормализация — медленно / не заполняются колонки: денормализация категории работает медленно (особенно при синхронизации с 1С), колонки в денормализованных таблицах не заполняются. Проверить, запущен ли job денормализации, количество задач в категории. Эскалация при таймаутах и незаполненных колонках.

Проектный Гант — ошибки в категории: при попытке открыть проектный Гант в категории — ошибка. Или при повторном открытии Ганта в ПУ автоматически подставляется не та категория. Проверить, настроен ли Гант для данной категории, есть ли задачи с корректными датами (начало/окончание), не кешируется ли предыдущий выбор категории. Проверить настройки Ганта в категории. При подстановке не той категории — закрыть и открыть заново, очистить кеш браузера. Эскалация если ошибка стабильно воспроизводится при наличии корректных данных.

7. Пользовательские настройки и виды¶

Пользовательские настройки и виды¶

Вид по умолчанию не применяется / не сохраняются пользовательские настройки: настроенный вид по умолчанию в категории не применяется при входе. Или пользовательские настройки отображения (колонки, фильтры, сортировка) сбрасываются между сессиями. Проверить, настроен ли вид по умолчанию в AdminSPA для категории, не перекрывает ли пользовательский вид системный, версию системы (может быть регрессия после обновления), воспроизводится ли у одного пользователя или у всех. Проверить настройки видов в AdminSPA: Категория → Виды. Попросить пользователя сбросить пользовательские настройки (если есть такая кнопка). Если регрессия после обновления — эскалация.

Признак «Отображать Статус» в настройках категории: вопросы по работе признака «Отображать Статус» в настройках категории — непонятно поведение, не влияет на отображение, или влияет не так, как ожидается. Проверить значение настройки в AdminSPA: Категория → Основные настройки. Как именно ожидается поведение vs. фактическое. Объяснить назначение настройки (управляет видимостью колонки статуса в гриде). Если поведение не соответствует документации — эскалация.

8. Удаление категорий и логирование настроек¶

Удаление категорий / случайное удаление раздела: пользователь случайно удалил раздел с подкатегориями и хочет восстановить. Или вопрос о процедуре удаления категорий. Что именно удалено — раздел (Categories) или категория (Subcategories), есть ли задачи в удалённой категории, когда произошло удаление. Восстановление удалённого раздела/категории — только через БД (обращение в поддержку 1Ф). Объяснить пользователю, что удаление раздела не удаляет задачи, но скрывает их из навигации. Эскалация: любое восстановление требует вмешательства в БД.

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

9. Экспорт конфигурации и БИ в категории¶

Частичный экспорт — отсутствуют разделы: при частичном экспорте конфигурации категории в выгрузке отсутствуют некоторые разделы (блоки настроек). Какие именно разделы отсутствуют в экспорте, версия системы и утилиты экспорта, есть ли зависимости между отсутствующими разделами и другими сущностями. Зафиксировать перечень отсутствующих разделов. Эскалация — это может быть баг утилиты экспорта.

БИ (бизнес-индикаторы) не добавляется или не открывается: невозможно добавить бизнес-индикатор в категорию, или при открытии раздела БИ — ошибка. Проверить права на управление БИ, версию системы, текст ошибки. Проверить права на настройку БИ. Если ошибка при открытии — зафиксировать текст и эскалировать с текстом ошибки, ID категории.

10. Автоматизация и правила в категории¶

Симптом: смарт-правила в категории срабатывают некорректно — не тот результат, не в тот момент, или не срабатывают вовсе. Интеграция (1С и др.) в категории перестала работать.

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

Настройки правил в AdminSPA: Категория → Автоматизация → Правила
Условия срабатывания — выполнены ли
Для интеграции — не изменились ли настройки после обновления
Журнал ошибок

Решение:

Проверить условия и действия правила
Для интеграции — проверить настройки подключения и маппинг полей
Если правило настроено корректно, но работает неверно — эскалация

13. Прочие частые вопросы¶

Пакетная обработка — ошибки: «Пакетное действие поддерживается только для задач в одной категории» — хотя задачи из одной категории. Проверить, выделены ли задачи из одной категории (в сводном разделе могут быть из разных), не перемешаны ли задачи из разных подкатегорий.

Шевроны маршрута стали кликабельными: шевроны статусов на карточке задачи стали реагировать на клик (раньше не реагировали). Это изменение поведения в новой версии — шевроны теперь интерактивны. Объяснить пользователю.

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

Маршрут задачи не открывается в новой вкладке: при попытке открыть маршрут задачи в новой вкладке браузера (Ctrl+Click, средняя кнопка мыши) — страница не загружается или отображается ошибка. Проверить, воспроизводится ли в разных браузерах, работает ли открытие маршрута в той же вкладке, версию системы. Если открытие в той же вкладке работает — известное ограничение SPA, маршрут может не поддерживать прямую навигацию. Эскалация если не работает и в той же вкладке.

Настройка общего поиска по категории: вопросы по настройке общего поиска внутри категории — как включить, какие поля индексируются. Объяснить настройку поиска: AdminSPA → Категория → Настройки поиска. Указать, что индексируются ДП, для которых включён флаг «Поиск».

Вопросы по структуре БД категорий: клиент спрашивает, в какой таблице хранятся значения категории определённого типа (справочник и т.д.). Перенаправить на документацию по структуре БД. Консультационные вопросы по структуре БД — не задача ТП, перенаправить на документацию или обучение.

Чеклист диагностики и условия эскалации¶

При любом обращении по категориям соберите базовую информацию: ID категории / подкатегории, версия системы, тип проблемы — маршрут, настройка, перенос, права, создание задач, виды, БИ, правила, удаление, один пользователь или все, было обновление? — регрессия или давняя проблема, скриншот / текст ошибки.

Передайте обращение в поддержку 1Ф, если столкнулись с одним из следующих случаев: ошибки при переносе категории (утилита миграции), проблемы безопасности (доступ без прав), зависание БД / браузера, регрессия маршрута после обновления, задачи «зависают» в статусе без возможности перехода, восстановление удалённых разделов/категорий (требует БД), неверная отработка правил при корректных настройках, ошибки при частичном экспорте конфигурации.