# Категории — Решение типичных проблем Руководство для первой линии поддержки и администраторов площадок 1Формы по диагностике и решению типовых проблем с категориями: маршруты и переходы, перенос между площадками, права доступа, производительность, денормализация, AdminSPA, БИ, автоматизация. Каждая секция сгруппирована по типу проблемы и содержит симптом, шаги проверки, решение и условия эскалации в поддержку 1Ф. Секции организованы по типам проблем. Для каждой: симптом — что описывает клиент; что проверить — шаги диагностики; решение — что сделать; эскалация — когда обращаться в поддержку 1Ф. --- ## 1. Маршрут / жизненный цикл Проблемы с переходами, статусами, кнопками. ### Кнопка перехода не отображается / заблокирована **Симптом:** пользователь не видит кнопку перехода на карточке задачи, или кнопка серая/неактивная. **Что проверить:** - Текущий статус задачи — есть ли переход из этого статуса - Права пользователя на переход — в настройках маршрута указано, кто может выполнять переход - Обязательные ДП — все ли обязательные поля заполнены - Обязательные подписи — не ожидает ли задача согласования - Смарт-условие перехода — может быть условие, которое не выполнено **Решение:** - Проверить права на переход в AdminSPA: Категория → Маршрут → Переход → Доступ - Проверить заполненность обязательных ДП - Если есть подписи на переходе — дождаться завершения согласования **Эскалация:** если права есть, ДП заполнены, подписей нет, но кнопка недоступна. ### Переход не срабатывает / задача «зависла» в статусе **Симптом:** пользователь нажимает кнопку перехода, но задача остаётся в текущем статусе. Или задача «зависла» — переходы отображаются только после обновления страницы. **Что проверить:** - Ошибка при переходе — появляется ли сообщение об ошибке - Автоматизация — не блокирует ли смарт-правило или автодействие переход - Подтверждение перехода — есть ли настроенное подтверждение, которое игнорируется автоматизацией **Решение:** - Попросить обновить страницу (F5) — если после обновления переход виден, проблема в SignalR-доставке - Если ошибка при переходе — зафиксировать текст ошибки - Проверить журнал ошибок (Журналы → Ошибки) **Эскалация:** с текстом ошибки, ID задачи, ID категории. ### Задача неожиданно сменила статус / расхождение статусов **Симптом:** задача перешла в другой статус без действия пользователя — «система сама перевела». Или в гриде задача показывается в одном статусе, а при открытии карточки — в другом. **Что проверить:** - Автошаги — настроены ли автоматические переходы на маршруте (например, по таймеру, по условию) - Смарт-правила — не сработало ли правило, которое инициирует переход - Пакетная обработка — не выполнял ли кто-то массовое действие - Интеграция — не пришёл ли статус из 1С или другой внешней системы - Кеш грида — обновить грид (F5) - Денормализация — если используется денормализованная таблица, данные могут отставать - Мультизавершение — при мультизавершении задача может быть одновременно в разных состояниях для разных исполнителей **Решение:** - Проверить историю задачи (лента/журнал) — кто и когда инициировал переход - Если инициатор «Система» — проверить автошаги и смарт-правила - Если инициатор конкретный пользователь — уточнить у него - Обновить грид; если расхождение сохраняется после обновления — эскалация **Новый статус не отображается после создания:** создан новый статус в AdminSPA, но при настройке перехода он не появляется в списке. Обновить страницу AdminSPA, проверить что статус сохранён (не осталось в режиме редактирования). Если не помогает — выйти из настроек маршрута и зайти заново. --- ## 2. Перенос и копирование категорий между площадками Ошибки при экспорте/импорте через утилиту миграции и проблемы при копировании категорий. ### Ошибка при переносе категории **Симптом:** при экспорте или импорте категории через утилиту миграции — ошибка. **Что проверить:** - Текст ошибки — что именно не перенеслось - Версия утилиты миграции — совместима ли с версиями площадок - Совместимость версий источника и приёмника **Типичные ошибки:** - «Mapping types» — несовместимость типов данных - «ExtParamLink с новыми ID» — связи ДП получают новые ID на площадке-приёмнике (ожидаемое поведение) - «Не подтягиваются ExtParamsInSubcatToBlocks и ExtParamStateView» — известная проблема в некоторых версиях утилиты **Решение:** - Для несовместимости версий — обновить утилиту или площадки до одинаковой версии - Для ExtParamLink — после переноса пересоздать связи на площадке-приёмнике - Для блоков/прав — пересоздать вручную после переноса **Эскалация:** с текстом ошибки, версиями обеих площадок, ID переносимой категории. ### После переноса категории настройки табличного представления сбросились **Симптом:** на площадке-приёмнике настроенный на источнике вид перестал действовать: в табличном представлении категории или в блоке «Используется» видны все доступные колонки, а не выбранные при настройке. **Что проверить:** - Версию площадки-приёмника — настройки табличного представления категории и блоков «Используется» переносятся начиная со сборки 2.268 «Скульптор» - Что это админская настройка, а не личная: сравните вид под учётной записью администратора категории — личные настройки отображения у приёмника свои, утилита их не переносит - Что на приёмнике та же категория, что на источнике: категория сопоставляется по GUID, а не по номеру - Что в таблице `DataSourceSettings` на приёмнике есть админская строка с `Key=Subcat_tableSettings` (для блока — `TaskUsed_tableSettings`), пустым `UserId` и заполненным `Value` / `ValueGZip` - Заполнен ли у этой строки `EntityId`: если он пуст, владелец настройки потерян и табличное представление её не найдёт; если в нём номер с исходной площадки, а на приёмнике номер другой — настройка тоже не найдётся - Не настраивался ли этот блок или категория на приёмнике вручную до переноса: админские настройки вида сопоставляются по GUID, поэтому перенос добавит вторую запись, а действующей останется прежняя **Решение:** - Обновить площадку до сборки с исправлением и повторить перенос — владелец настройки сопоставляется с объектом на приёмнике по GUID - Для уже перенесённых категорий, где строка осталась без владельца, повторить импорт категории или привязать строку настроек к категории на приёмнике вручную - Если на приёмнике была своя настройка того же блока или категории — привести вид к нужному вручную **Эскалация:** если площадки одной версии 2.268 «Скульптор», блок или категория на приёмнике до переноса не настраивались, а вид всё равно сброшен — приложить ID категории, ID блока или ключ настройки, ссылку на архив переноса и дату переноса. **Связанные случаи.** Тем же порядком проверяются настройки табличного вида вкладки блока «Используется» (`TaskUsed_tableSettings` — владелец блок) и настройки экрана «Источник данных» лукапа и мультилукапа (`Lookup_tableSettings` — владелец дополнительный параметр). **Копирование категории — проблемы:** при копировании категории дублируются JS-вставки, не копируются ресурсы локализации. JS-вставки: после копирования проверить и удалить дубли вручную. Локализация: не копируется — настроить вручную на копии. --- ## 3. Создание задач ### Невозможно создать задачу / шаблон задач не работает **Симптом:** пользователь не может создать задачу — кнопка «Создать» недоступна или при создании ошибка. Или после обновления слетает шаг постановки, шаблон задач не работает. **Что проверить:** - Права пользователя на создание задач в этой категории - Обязательные ДП — есть ли ДП без значения по умолчанию, которые блокируют создание - Маршрут — есть ли начальный статус - Ошибка — текст ошибки (переполнение лога, таймаут и т.д.) - Настройку шаблона задач в категории - Не сбросились ли настройки после обновления **Решение:** - Проверить права: Категория → Доступ → право на создание - Если ошибка при создании — зафиксировать --- ## 4. Настройки категории (AdminSPA) ### Настройки AdminSPA — типичные проблемы **Не открываются настройки категории:** при попытке открыть настройки категории в AdminSPA — ошибка или пустая страница. Проверить версию AdminSPA, путь открытия (боковое меню vs список пространств — ссылки разные), доступ пользователя к AdminSPA. Попробовать открыть через другой путь (боковое меню), обновить страницу. Если не помогает — эскалация. **Категория не отображается / не видна:** пользователь не видит категорию в навигации или при поиске. Проверить права пользователя на категорию (чтение), не скрыта ли категория в настройках навигации, не является ли архивной. Проверить права в AdminSPA: Категория → Доступ. Проверить видимость в навигации. **Проблемы с JS-вставками и кнопками:** JS-вставки (MTF) не отображаются в настройках категории, кнопки категории с иконкой — имя не видно. **Сводный раздел — проблемы:** в сводном разделе показываются задачи не из всех категорий, не все статусы отображаются при добавлении категории. Проверить настройки сводного раздела — все ли категории добавлены, выбраны ли нужные статусы для каждой категории. Проверить настройки сводного раздела в AdminSPA, добавить недостающие статусы. --- ## 5. Права и доступ ### Права на категорию — не работают как ожидается **Симптом:** «как проверить права?», «гибкий доступ не работает», «пользователь видит/не видит задачи». **Что проверить:** - Тип доступа к категории (стандартный, гибкий, конфиденциальный) - Права конкретного пользователя — через какие группы/роли назначены - Для гибкого доступа — настройки EPRights **Решение:** - Для проверки прав: AdminSPA → Категория → Доступ → найти пользователя - При гибком доступе — проверить настройки EPRightsFlat/Lkp/Mlt (см. [решение проблем по ДП](https://help.1forma.ru/domains/ext-params/support-guide.md), раздел 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Ф, если столкнулись с одним из следующих случаев: ошибки при переносе категории (утилита миграции), проблемы безопасности (доступ без прав), зависание БД / браузера, регрессия маршрута после обновления, задачи «зависают» в статусе без возможности перехода, восстановление удалённых разделов/категорий (требует БД), неверная отработка правил при корректных настройках, ошибки при частичном экспорте конфигурации.