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

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

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

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

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

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

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

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

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

Решение:

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

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

В меню точка, иконка или счётчик стоят на отдельной строке¶

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

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

версию площадки и версию интерфейса — дефект приехал с переходом выпадающих меню на новый механизм в составе Angular Material 22 и был исправлен в сборке 2.268 «Скульптор»;
где именно: меню кнопки статуса в карточке задачи, меню видеовстречи (шестерёнка «Настройки»), меню «Ещё» у вкладок (счётчик), меню у кнопки подписи в гриде резолюций (цветной маркер);
не спутать с обычным многоточием: длинное название обрезается многоточием и в исправленном виде — это правильное поведение.

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

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

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

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

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

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

Решение:

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

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

Не удаётся переставить статусы или удалить статус из основного маршрута¶

Симптом: администратор меняет порядок статусов основного маршрута или удаляет статус из состава категории — запрос отклоняется с ошибкой (на старых сборках — внутренняя ошибка сервера).

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

версию площадки — исправление переупорядочивания и ограничений удаления входит в сборку 2.268 «Скульптор» и новее;
состав статусов категории и текущий порядок (категория → «Маршрут» → «Состав статусов»);
нет ли в запросе двух шагов с одним местом — конфликтный порядок отклоняется намеренно;
есть ли переход-мост между соседями удаляемого статуса основного маршрута: без него удаление из середины маршрута запрещено;
сколько статусов останется в основном маршруте после удаления — меньше трёх не допускается.

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

Эскалация: если площадка на сборке 2.268 «Скульптор» или новее, порядок задан без конфликтов, переход-мост есть, а запрос всё равно отклоняется — приложить 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 (см. решение проблем по ДП, раздел 4)

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

Кнопки маршрута видны без прав на категорию¶

Симптом: запрос кнопок маршрута категории (subcategories/{id}/steps) отдаёт кнопки перехода и кнопки действий пользователю, у которого нет права просмотра категории; либо в интерфейсе такие кнопки показываются пользователю без доступа.

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

версию площадки: проверка права просмотра на этом эндпоинте появилась в сборке 2.268 «Скульптор» — на более ранних сборках поведение прежнее;
права пользователя на категорию: AdminSPA → Категория → Доступ → найти пользователя; право должно быть у группы, в которую он входит, либо у замещаемого (в период замещения);
не открыта ли конкретная задача: кнопки маршрута открытой задачи выдаются по доступу к задаче и при отсутствии права на категорию — это штатное поведение, а не утечка;
кеш браузера и кеш конфигурации: обновить страницу (F5), при необходимости — кеш категории на стороне сервера.

Решение:

обновить площадку до сборки 2.268 «Скульптор» — в ней запрос без права просмотра кнопки не отдаёт;
если права на категорию действительно нет, а данные приходят и после обновления — зафиксировать ID категории, ID пользователя, версию площадки и текст ответа.

Эскалация: любое стабильно воспроизводимое получение данных категории без права — обращение в поддержку 1Ф как проблема безопасности.

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

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

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

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

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

Категория или пространство не создаётся, в журнале — отказ команды схемы денормализации

Симптом: создание категории или пространства завершается отказом, хотя права на создание есть; в журнале ошибок видно падение команды синхронизации схемы денормализованной таблицы, на PostgreSQL — прерванную транзакцию.

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

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

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

Когда обращаться в поддержку 1Ф: если на исправленной сборке создание всё равно отказывает или сбой схемы повторяется после повторной настройки подкатегории — приложить версию сборки, идентификатор категории и строки журнала по синхронизации модулей.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Решение:

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

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

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

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

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

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

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

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

Если пользователь видит старое название категории в карточке задачи, письме или отчёте, сначала проверьте актуальное название и путь категории. Считать, что любое изменение другого названия на странице «Названия элементов» запускает пересчёт пути, нельзя.

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

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

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

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