Гриды и фильтры — Решение проблем¶

Аудитория: ТП 1-й линии (без доступа к БД)

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

Документ организован по типам проблем — от самых частых к менее частым. Для каждой проблемы: 1. Симптом — что видит/описывает клиент 2. Что проверить — шаги диагностики без доступа к БД 3. Решение — что посоветовать или сделать 4. Эскалация — когда передавать на 2-ю линию

Секции [2L] содержат заглушки для будущей SQL-диагностики (2-я линия).

Терминология¶

Термин пользователя	Термин в коде	Примечание
Реестр, таблица, грид	DataSource	Единый backend pipeline
Фильтр в колонке	ColumnFilter	ag-grid колоночный фильтр
Смарт-фильтр	SmartFilter (ESQL)	Отдельный домен `smart-filters/`
Быстрый фильтр	Quick filter	Строка поиска над гридом
Отбор по умолчанию	Default smart filter	Предустановленный фильтр категории
БИ	Блок «Используется»	DataSourceType.TaskUsed
Канбан	KanbanSubcat	DataSourceType 28

1. Фильтрация¶

Самая частая тема — ~25% всех обращений по гридам. Жалобы: фильтр не работает, показывает неверное, слетает после перезагрузки.

1.1 Фильтр в гриде не работает / показывает неверные результаты¶

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

Что проверить: - Тип колонки — каждый тип ДП имеет свой фильтр (текстовый, числовой, set-фильтр). Фильтрация по некоторым типам ДП ограничена - Оператор фильтра — «Содержит», «Равно», «Не содержит» работают по-разному - «Не содержит» — известная особенность: вычитает в том числе записи с пустыми значениями - Колонка с ДП типа «Выбор нескольких задач» (Multilookup) — не поддерживается как фильтруемая колонка грида - Формат даты в конструкторе поиска — если фильтр по дате подсвечивается красным, проверь формат. Используй yyyy-mm-dd (например, 2026-03-10), а не dd.mm.yyyy - Фильтр по множественным полям — при использовании оператора ИЛИ с полями типа «Все исполнители» ранее возникала ошибка Incorrect syntax near ')', исправленная в задаче

Решение: - Уточнить какой именно оператор фильтра используется - Для «Не содержит» — объяснить, что пустые значения также исключаются (это by design) - Для lookup/multilookup колонок — фильтрация может работать иначе, чем для текстовых - Для дат — использовать формат yyyy-mm-dd в конструкторе поиска - Для множественных полей — убедиться, что исправление задачи применено

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

1.2 Фильтры слетают / не сохраняются¶

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

Что проверить: - Настройку «Сохранять пользовательские настройки» в табличном представлении категории - Не было ли обновления системы (после обновления настройки могут сброситься) - Сессия — не истекла ли

Решение: - Проверить: Настройки категории → Табличное представление → «Сохранять пользовательские настройки» - Если отключено — каждый раз применяются настройки по умолчанию - Если включено, но фильтры слетают — попросить очистить кеш браузера и повторить

Эскалация: если настройка включена, кеш очищен, но проблема повторяется.

1.3 Фильтр по ДП в гриде¶

Симптом: фильтр по колонке ДП не работает, хотя по системным колонкам (текст задачи, статус) всё нормально.

Что проверить: - Тип ДП — не все типы поддерживают фильтрацию в гриде (см. справочник ниже) - Для ДП Таблица — фильтрация возможна, но требует настройки (см. блок ниже) - Для lookup — фильтрация по связанной задаче, а не по отображаемому тексту

Какие типы ДП поддерживают фильтрацию в гриде:

Тип ДП	Фильтр в гриде	Примечание
Текст, Числовое, Деньги	Да	TextFilter / NumberFilter
Дата, Дата-время	Да	DateFilter
Чекбокс	Да	SetFilter (Да/Нет)
Выпадающий список, Combobox	Да	SetFilter
Lookup	Да	SetFilter / TextFilter
Выбор пользователей	Да	SetFilter
Multilookup	Ограничено	SetFilter, но не все колонки отображаются
ДП Таблица	Ограничено	Требуется настройка шаблона (см. ниже)
Файл, Мультифайл	Нет	—
Сквозной (Through)	Нет	Вычисляемый, не фильтруется
Адрес	Нет	—

Фильтрация по ДП Таблица в гриде категории¶

Симптомы (любой из): - Фильтр «Содержит» по колонке ДП Таблица возвращает 0 задач - Поиск по содержимому ДП Таблица не находит значения, которые точно есть - Фильтрация по ДП Таблица не работает, хотя по другим ДП — работает - Поиск «в полях» не ищет по столбцам ДП Таблица

Корневая причина в 90% случаев: не включён флаг «Участвует в поиске» (IsUsedInSearch) на столбцах ДП Таблица. Без этого флага фильтр «Содержит» и поиск «в полях» не видят данные столбца. Фильтры «Нет значения» и «Есть значение» от этого флага не зависят.

Быстрая проверка: Админка → ДП → столбец таблицы → чекбокс «Участвует в поиске». Если выключен — включить и пересинхронизировать.

Полная настройка фильтрации по ДП Таблица¶

SP ShowTasksFeed не фильтрует по типу Table напрямую (тип в extParamTypesToIgnore). Но фильтрация задач по содержимому таблицы возможна через механизм HTML-представления. Для этого нужно выполнить все три шага:

Настроить шаблон (Админка → ДП → вкладка «Шаблон в табличных представлениях»):
Использовать шаблон = Да
Количество отображаемых строк > 0 (например, 10)
Шаблон строки (ItemTemplate) — обязательно заполнить с тегами <cell columnid="ID">, где ID = идентификатор столбца таблицы. Без шаблона HTML не генерируется, и фильтровать нечего.
Включить Хранить html представление (StoreHtmlPresentation) — сохраняет сгенерированный HTML в ExtParamValues.ExtParamValueGZip, откуда попадает в денормализованную ExtParamNativeValue.
Включить Участвует в поиске (IsUsedInSearch) на нужных столбцах таблицы — определяет, какие столбцы участвуют в поиске «в полях» в гриде категории.

После настройки: включить «Синхронизировать существующие задачи» для пересчёта HTML по существующим данным. Job TableExtParamValuesGZipCompressJob сжимает значения каждые 3 минуты.

Важно (с версии 2.265): значение ДП Таблица не хранится в ExtParamValue и ExtParamXXXValue денормализованных таблиц. Наличие в ExtParamNativeValue зависит от флага StoreHtmlPresentation. Без настроенного шаблона данные не попадают в денормализацию и фильтрация не работает.

Полное описание настроек шаблона: docs/domains/ext-params/table/settings-reference.md § «Шаблон в табличных представлениях».

[2L] Детали: docs/domains/grids/filters-reference.md — полный справочник IColumnFilterBuilder.

1.4 Фильтр на мобильном приложении¶

Симптом: меню фильтра не отображается в мобильном приложении на Android/iOS.

Что проверить: - Версия мобильного приложения — поддерживает ли фильтрацию в гриде - Платформа (Android/iOS) — функциональность может отличаться

Решение: - Уточнить версию МП - Фильтрация в МП ограничена по сравнению с web — не все типы фильтров доступны

1.5 Перестал работать фильтр после обновления¶

Симптом: фильтр в конкретной категории работал до обновления, после — перестал.

Что проверить: - Какая версия была до и после - Тип фильтра — колоночный, смарт-фильтр, «Отбор по умолчанию» - Не изменилась ли структура категории (ДП, колонки) при обновлении

Решение: - Зафиксировать: ID категории, версию до/после, описание поведения - Попробовать сбросить пользовательские настройки грида (если проблема только у одного пользователя)

Эскалация: как регрессия с указанием версий.

2. Колонки грида¶

~12% обращений. Проблемы с отображением, настройкой, добавлением колонок.

2.1 Колонки не отображаются / пропали¶

Симптом: в гриде отсутствуют колонки, которые должны быть — ДП, системные поля «Должность», «Подразделение», etc.

Что проверить: - Настройку колонок в табличном представлении категории - Не скрыл ли пользователь колонку через личные настройки грида - Денормализованные колонки — заполнены ли данные в денормализованных таблицах

Решение: - Проверить настройки «Вид по умолчанию» в категории — есть ли колонка - Предложить пользователю сбросить личные настройки грида - Для денормализованных колонок — проверить, что job денормализации отработал

Эскалация: если колонка настроена, но не отображается.

2.2 Настройки колонок — закрепление, ширина, перенос¶

Симптом: нельзя закрепить колонку, настроить ширину, включить перенос по строкам. Ширина не применяется в виджете.

Что проверить: - Тип грида — не все настройки доступны для всех типов (например, для виджетов ограничено) - Версия — эти настройки могут быть недоступны для редактирования в определённых версиях - Уровень настройки — «Вид по умолчанию» (категория) vs личные настройки пользователя

Решение: - Для «закрепить колонку» и «переносить по строкам» — проверить версию, может быть заблокировано в UI - Для ширины в виджетах — известное ограничение, ширина может не применяться внутри группы виджетов

2.3 Некорректное отображение значений в колонках¶

Симптом: multilookup показывает «Цвет и текст» некорректно, виртуальная колонка на ДП файл — как ссылка, лукап — не как ссылка.

Что проверить: - Тип стиля отображения колонки в настройках - Тип ДП и его настройки отображения - Не конфликтует ли пользовательская настройка грида с настройкой по умолчанию

Решение: - Проверить стиль отображения колонки в настройках категории - Для лукапа «как ссылка» — это отдельная доработка, не все версии поддерживают

2.4 Нельзя добавить определённый тип ДП в грид¶

Симптом: невозможно добавить ДП с типом «Выбор нескольких задач» (Multilookup) или другой сложный тип в параметры грида.

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

3. Сортировка и группировка¶

~10% обращений.

3.1 Сортировка не работает / некорректная¶

Симптом: сортировка по колонке не работает, порядок неожиданный (числовая колонка сортируется как текст), сортировка по умолчанию не сохраняется.

Что проверить: - Тип колонки — числовая сортировка vs текстовая - Для multilookup/lookup — сортировка идёт по тексту связанной задачи, а не по ID - Локализация — при сортировке по тексту задачи может не учитываться локаль - Сортировка «по умолчанию» — где задана (в БИ, в лукапе, в категории)

Решение: - Для чисел — убедиться, что тип колонки числовой (а не текстовый ДП с цифрами) - Для сортировки по умолчанию в БИ/лукапе — известная проблема в некоторых версиях

3.2 Группировка работает некорректно¶

Симптом: в группировку попадают задачи из других категорий, группировка пропадает периодически, после обновления группировка перестала работать в БИ.

Что проверить: - Тип грида — «Мои задачи» группирует задачи из разных категорий (это нормально) - Настройку группировки — по какому полю/ДП - Для БИ — настройку через «Табличный вид БИ»

Решение: - Для «Мои задачи» — группировка показывает все категории, это by design - Если группировка пропадает — проверить «Сохранять пользовательские настройки» - Для БИ — пересоздать настройку группировки в табличном виде

Эскалация: если группировка стабильно не работает после пересоздания настройки.

3.3 Группировка по лукапу показывает русские названия вместо локализованных¶

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

Причина: известный баг — GroupingExpressionEvaluator / GroupingService.GetGroupValuesAsync() не содержит обработчика для типов LookUpField, Combobox, Select. Значение из хранимки передаётся без локализации. См. known-issues.md § 1.

Решение: прямого workaround нет. Зафиксировать как баг. Постановка на доработку: docs/domains/grids/known-issues.md § 1.

Эскалация: сразу, с указанием ID категории и ID ДП-лукапа.

4. Экспорт в Excel¶

~6% обращений.

4.1 Не выгружаются данные в Excel¶

Симптом: кнопка экспорта не работает, выгрузка пустая, ошибка при экспорте.

Что проверить: - Откуда экспортируется — грид категории, «Мои задачи», портал, drill down - Количество задач — при большом объёме возможен таймаут - Ошибка в консоли — попросить пользователя открыть F12 и посмотреть ошибку

Решение: - Для большого объёма — предложить сузить фильтр перед экспортом - Для портала — экспорт из портала может быть ограничен - Для раздела «Подписка» — известная проблема в некоторых версиях

Эскалация: если экспорт не работает на небольшом количестве задач (<100).

4.2 Ошибка «Mapping types» при экспорте конфигурации¶

Симптом: при попытке экспорта конфигурации категории — ошибка «Mapping types».

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

5. Канбан¶

~6% обращений.

5.1 Настройка канбана¶

Симптом: вопросы по настройке канбан-доски — как настроить, как задать группировку, фильтры.

Что проверить: - Канбан включается в настройках представления категории - Группировка канбана — по статусам (основной сценарий) или по ДП - Фильтры канбана — настраиваются через шаблон

Решение: - Канбан доступен как представление категории (наряду с таблицей, списком, календарём) - Группировка по умолчанию — по статусам маршрута - Для фильтрации — использовать шаблон фильтров канбана

5.2 Канбан не обновляется / долго грузит¶

Симптом: при смене статуса задачи (через ПКМ или форму) канбан не перемещает карточку, требуется ручное обновление. Долгая загрузка при группировке по исполнителю.

Что проверить: - Способ смены статуса — через канбан (drag) или через форму задачи - Количество задач в категории — при большом объёме канбан тормозит - Группировка — по исполнителю может быть медленнее, чем по статусу

Решение: - Если через форму — обновление канбана может происходить с задержкой (SignalR) - Для большого количества задач — рекомендовать фильтрацию - Если не помогает — ручное обновление страницы (F5)

Эскалация: если канбан стабильно не обновляется при drag-and-drop.

5.3 Канбан — проблемы UI¶

Симптом: не грузятся фото исполнителей, нет кнопки «Очистить» в группировке.

5.4 Поиск в канбане — по части строки¶

Симптом: поиск по ДП в канбан-представлении не находит задачи по частичному совпадению. Работает только при вводе полного значения.

Что проверить: - Тип поиска — быстрый фильтр или поиск «в полях» - Тип ДП, по которому ищут

Решение: - Поиск в канбане может работать иначе, чем в табличном представлении — менее гибко по частичному совпадению - Рекомендовать переключиться на табличное представление для точного поиска

6. Избранное¶

~8% обращений.

6.1 Ошибка при переходе между категориями в избранном¶

Симптом: при клике на категорию в панели избранного — ошибка, страница не загружается.

Что проверить: - Версия системы - Тип ссылки в избранном — категория, задача, внешняя - Доступ пользователя к категории

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

6.2 Иконки / цвета задач в избранном¶

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

Что проверить: - Версия — в новых версиях UI избранного изменился - Была ли доступна эта функция до обновления

Решение: - Объяснить изменения в новой версии (если UI изменился) - Для «Избранного группы» — локализация названий папок доступна через кнопку глобуса в диалоге добавления/переименования папки (AdminSPA)

6.3 Поиск в панели избранного¶

Симптом: на панели избранного отсутствует возможность поиска.

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

7. Представления¶

7.1 Табличное представление — «Отбор по умолчанию»¶

Симптом: при попытке сменить «Отбор по умолчанию» — ошибка. При отключении «Сохранять пользовательские настройки» автоматически включается фильтр «Активные».

Что проверить: - ID категории - Какой smart-фильтр выбран как «Отбор по умолчанию» - Есть ли ошибка в самом смарт-фильтре

Решение: - Для «автоматически включается Активные» — это by design: без пользовательских настроек система применяет отбор по умолчанию - Для ошибки при смене — эскалация с ID категории и текстом ошибки

7.2 Календарное представление — фильтр не работает¶

Симптом: в новых категориях на календарном представлении фильтр отображения задач не работает.

Что проверить: - Настроен ли фильтр для календарного представления в категории - Тип категории — обычная или сводная

7.3 Ресурсное представление — проблемы¶

Симптом: некорректное отображение при часовом поясе отличном от +3, фильтр по сотрудникам не работает, шаблоны для cell не применяются.

Что проверить: - Часовой пояс пользователя/сервера - Настройку ресурсного представления в категории

7.4 Иерархическое представление — не отображаются задачи без дочерних¶

7.5 Дата и время — расхождение со временем пользователя¶

Симптом: в колонке «Дата и время» (или в выгрузке грида в Excel) значения отличаются на несколько часов от ожидаемых. Типовая жалоба клиента: «время в заявке указано 8:00, по факту машина пришла к 6:00».

Что проверить: - Часовой пояс в профиле пользователя (Профиль → Редактировать → блок «География» → «Часовой пояс»). Грид и экспорт в Excel приводят значения к этому часовому поясу. - Совпадение часового пояса у разных пользователей одной задачи: разные пользователи могут видеть разное локальное время одного и того же значения — это ожидаемое поведение.

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

Симптом: в иерархическом представлении грида задачи без дочерних подзадач не отображаются.

Что проверить: - Настройку иерархического представления в категории - Фильтр — не скрывает ли «листовые» задачи - Тип иерархии — по подзадачам или по ДП-лукапу

Решение: - Проверить настройки иерархического представления — возможно включён режим, который скрывает задачи без дочерних - Если баг — эскалация с ID категории

8. Тикеры (индикаторы)¶

8.1 Некорректное отображение тикеров¶

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

Что проверить: - Настройку тикера в AdminSPA (Индикаторы) - Источник данных тикера — SQL или предопределённый - Для кастомных тикеров — текст SQL-запроса (может быть ошибка)

Решение: - Тикеры обновляются периодически через SignalR, не в реальном времени - Задержка обновления — нормальное поведение - Если значение стабильно неверное — проверить SQL источника данных

9. Поиск в гриде¶

9.1 Поиск требует полное наименование / таймаут¶

Симптом: поиск «в полях» не находит по частичному совпадению, требует ввести полное наименование. Или поиск уходит в таймаут.

Что проверить: - Тип поиска — быстрый фильтр (строка над гридом) или поиск «в полях» - Количество задач в категории — при большом объёме поиск может быть медленным - Минимальное количество символов для поиска

Решение: - Быстрый фильтр ищет по тексту задачи (contains) - Поиск «в полях» ищет по всем видимым колонкам, но может быть медленнее - Для таймаута — рекомендовать сузить выборку фильтрами перед поиском - Минимальное количество символов: если введено меньше минимума, поиск не запускается

Эскалация: если поиск по тексту задачи стабильно не находит существующую задачу.

9.2 Поиск по локализованному лукапу — разные результаты в разных локалях¶

Симптом: поиск «в полях» по колонке-лукапу возвращает разное количество строк при переключении локали интерфейса (ru/en).

Что проверить: - Тип колонки — лукап с локализованными значениями - Индексация — какие локализации попали в денормализованные данные - Локаль пользователя

Решение: - Поиск идёт по денормализованному тексту, который зависит от локали на момент денормализации - Если данные денормализованы в одной локали, поиск в другой может не находить - Зафиксировать как баг с указанием ID категории, ID ДП, локалей

Эскалация: с воспроизводимым примером (категория, лукап, локали, запрос).

10. Смарт-фильтры (AdminSPA)¶

10.1 Смарт-фильтры не отображаются в AdminSPA¶

Симптом: в окне редактирования смарт-правила не отображаются смарт-фильтры.

Что проверить: - Версия AdminSPA - Контекст — откуда открыты (из настроек категории, из настроек подписи) - При открытии через «Настройки подписи → Условия запроса» — могут отсутствовать параметры акцептантов

Решение: - Обновить страницу AdminSPA - Если проблема повторяется — зафиксировать версию и контекст

Эскалация: с указанием версии AdminSPA и контекста.

10.2 Не сохраняется «Отдаваемый результат» смарт-фильтра¶

Симптом: при создании смарт-фильтра «Отдаваемый результат» не сохраняется.

Эскалация: с ID смарт-фильтра и описанием шагов.

10.3 Смарт-фильтр не возвращает корректное значение¶

Симптом: смарт-фильтр не возвращает логическое значение, не вносится значение смарт-фильтра, странное поведение при фильтрации через смарт-фильтры.

Что проверить: - Синтаксис ESQL в смарт-фильтре - Тип возвращаемого значения — соответствует ли ожидаемому - Тестирование через «Предпросмотр результата» в AdminSPA

Решение: - Проверить ESQL-выражение через предпросмотр - Убедиться, что возвращаемый тип совпадает с типом поля фильтрации - Для логических значений — ESQL должен возвращать true/false, не 1/0

Эскалация: с ID смарт-фильтра, ESQL-текстом, ожидаемым и фактическим результатом.

11. Грид — общие проблемы¶

11.1 Все гриды падают в ошибку¶

Симптом: при открытии любого грида — ошибка, ни один реестр не загружается.

Что проверить: - Это происходит у одного пользователя или у всех - Есть ли ошибка в консоли (F12) - Было ли обновление / изменение конфигурации

Решение: - Если у одного — попробовать сбросить пользовательские настройки гридов, очистить кеш - Если у всех — эскалация немедленно (возможно backend-проблема)

11.2 Редактирование ДП в гриде — обход валидации¶

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

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

11.3 Режим «Конфиденциально» — доступ через грид¶

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

Эскалация: это проблема безопасности — сразу эскалировать с указанием ID категории и описанием.

11.4 Ссылка из грида копируется как [object Object]¶

Симптом: при копировании ссылки из грида в буфер обмена вместо URL получается [object Object].

Эскалация: с указанием версии, браузера, типа колонки.

11.5 Частая перезагрузка грида¶

Симптом: список задач в гриде категории обновляется слишком часто, мешает работе.

Что проверить: - Настройку частоты автообновления грида в категории - Не настроены ли SignalR-уведомления с высокой частотой

Решение: - Проверить: Настройки категории → «Частота обновления» → увеличить интервал или отключить автообновление

12. Конструктор поиска¶

12.1 Ошибки при использовании конструктора поиска¶

Симптом: при попытке фильтрации через конструктор поиска возникает ошибка. Также: двойная фильтрация по исполнителям, некорректные результаты поиска.

Что проверить: - Версия системы — конструктор поиска активно дорабатывается - Какие поля/операторы используются в конструкторе - Воспроизводится ли при упрощении запроса (убрать условия по одному)

Решение: - Попробовать упростить запрос — убрать условия, выявить проблемное - Для двойной фильтрации по исполнителям — проверить, нет ли дублирующих условий в запросе - Если ошибка стабильная — эскалация с текстом ошибки и описанием условий

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

13. ДП Таблица — ошибки внутри компонента¶

13.1 Ошибки при группировке и фильтрации внутри ДП Таблица¶

Симптом: ошибка при группировке строк в ДП Таблица. Ошибка при снятии всех галочек в фильтре множественного выбора внутри таблицы. Дублирование строк при заполнении колонок.

Что проверить: - Версия системы - Тип колонки ДП Таблица (лукап, текст, число) - Воспроизводится ли на другой категории с аналогичной настройкой

Решение: - Для ошибки при снятии всех галочек — known issue, эскалация - Для дублирования строк — проверить, нет ли SS/события на создание строки, которое триггерит повторное добавление - Для группировки — эскалация с ID ДП и описанием

Эскалация: с ID ДП Таблица, типом колонки, шагами воспроизведения.

13.2 Импорт из Excel в ДП Таблица — ошибки¶

Симптом: при импорте данных из Excel в ДП типа «Таблица» возникает ошибка. Файл загружается, но данные не записываются или записываются с ошибками.

Что проверить: - Формат Excel-файла — .xlsx (не .xls, не .csv) - Соответствие колонок — совпадают ли заголовки в файле с колонками ДП Таблица - Типы данных — совпадают ли типы (число в числовую колонку, дата в дату) - Объём данных — количество строк

Решение: - Проверить формат файла и соответствие колонок - Попробовать с минимальным файлом (1-2 строки) для локализации проблемы - Если ошибка стабильная — эскалация с файлом-примером и ID ДП

13.3 Значения не очищаются после смарт-отмены¶

Симптом: после срабатывания смарт-отмены значение в колонке ДП Таблица не очищается на фронте. Данные визуально остаются, хотя в БД уже пустые.

Что проверить: - Какое действие триггерит смарт-отмену - Обновляется ли значение после ручного обновления страницы (F5)

Решение: - Если F5 помогает — проблема фронтового кеша, зафиксировать как баг UI - Эскалация с ID задачи, ID ДП, шагами воспроизведения

14. Грид — доступ и права¶

14.1 Задача не открывается из грида под не-админом¶

Симптом: под пользователем без админских прав задача не открывается при клике в гриде. Под админом — работает.

Что проверить: - Права пользователя на категорию и задачу - Тип грида — обычный, виджет, портал - Настройки доступа к категории — «Видимость задач»

Решение: - Проверить доступ: Админка → Категория → Доступ → роль пользователя - Для виджетов — отдельные настройки доступа на уровне портала - Если доступ есть, но открытие не работает — эскалация

14.2 Грид БИ — колонки не сбрасываются через админку¶

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

Что проверить: - Тип грида — именно БИ (DataSourceType.TaskUsed) - Способ сброса — через какой интерфейс админки пытаются

Решение: - Сброс настроек грида БИ может работать иначе, чем для грида категории - Попробовать сброс через API: удалить пользовательские настройки грида напрямую

Эскалация: с ID категории, ID пользователя, описанием шагов сброса.

15. Настройки DataSource — конфликты¶

15.1 DataSourceSettings classic перебивает tablesettings¶

Симптом: настройки DataSource в режиме classic перезаписывают tablesettings. Пользовательские настройки табличного представления не применяются или сбрасываются.

Что проверить: - Тип DataSource — classic vs modern - Есть ли конфликт между настройками на уровне категории и на уровне пользователя - Версия системы

Решение: - Проверить, не задан ли DataSourceSettings в режиме classic, который имеет приоритет над tablesettings - Если конфликт подтверждён — переключить на modern или синхронизировать настройки

Эскалация: с ID категории и описанием конфликта настроек.

15.2 Пользовательские настройки лукап-пикера не сохраняются¶

Симптом: настройки табличного представления в окне выбора лукапа (lookup picker) не сохраняются между сессиями.

Что проверить: - Тип лукапа — обычный или расширенный (с табличным представлением) - Настройку «Сохранять пользовательские настройки» для связанной категории

Решение: - Лукап-пикер использует отдельный DataSource, настройки которого могут не сохраняться - Зафиксировать как пожелание или баг в зависимости от версии

16. Грид — производительность¶

16.1 Грид «на подпись» тормозит открытие задач¶

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

Что проверить: - Количество задач в выборке - Количество ДП, выводимых в гриде - Нет ли тяжёлых смарт-фильтров на подписях

Решение: - Рекомендовать сузить выборку фильтрами - Проверить, не настроены ли избыточные колонки в табличном представлении - Если проблема массовая — эскалация как performance issue

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

Что проверить: - Версия системы (v2.266+) - Тип колонки — какой ДП - Воспроизводится ли во всех категориях или в конкретной

Решение: - Если проблема только на v2.266 — зафиксировать как регрессию - Эскалация с версией и скриншотом

Чеклист для первичной диагностики (универсальный)¶

Версия системы — какая версия у клиента
ID категории — всегда запрашивать
Тип грида — реестр категории, «Мои задачи», БИ, канбан, lookup-пикер
Тип проблемы — фильтр, колонка, сортировка, экспорт, отображение
Один пользователь или все — определяет масштаб проблемы
Было обновление? — регрессия или давняя проблема
Скриншот / ошибка в консоли (F12) — попросить при неочевидных проблемах
Платформа — web, мобильное

Когда эскалировать¶

Все гриды падают в ошибку (backend)
Проблема безопасности (данные видны без доступа)
Регрессия после обновления (особенно v2.266)
Потеря данных (значения ДП изменились через грид)
Таймауты при поиске/фильтрации (производительность)
Ошибка экспорта конфигурации (Mapping types)
Ошибки конструктора поиска, воспроизводимые стабильно
Разные результаты поиска в разных локалях (баг денормализации)