Порталы и виджеты — Решение проблем

Типовые проблемы порталов и виджетов и их решение. Разделы организованы по типам проблем: виджеты, порталы, новости, пространства, JS-вставки, дашборды, смарт-действия и инфраструктура. Для каждой проблемы указаны симптом, что проверить и решение.

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

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

1. Симптом — что описывает пользователь
2. Что проверить — шаги диагностики
3. Решение — что сделать
4. Когда обращаться в поддержку 1Ф — если проблему не удаётся решить на месте

---

1. Виджеты — Таблица

1.1 HTML-теги не обрабатываются / отображаются как текст

Симптом: «в виджете Таблица перестали обрабатываться html-теги», «символы < и > не отображаются, текст пропадает».

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

• Версия системы — после обновления могло измениться поведение экранирования HTML
• Настройки виджета — включена ли опция отображения HTML в ячейках
• Содержимое ячеек — не используются ли спецсимволы <, > без экранирования

Когда обращаться в поддержку 1Ф: если после обновления HTML перестал рендериться — баг.

1.2 Фильтры в виджете не работают

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

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

• Тип фильтра — стандартный или пользовательский (хранимая процедура)
• Параметры фильтра — совпадают ли типы данных
• Версия системы

1.3 Не переносится текст / не применяются настройки отображения

Симптом: «чекбокс "Переносить текст на другую строку" не применяется».

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

• Версия системы
• Ширина колонки — не фиксирована ли
• Кеш — обновить страницу

1.4 Закрепление колонок

Симптом: «можно ли закрепить первые N колонок в виджете Таблица?»

Решение: стандартной настройки закрепления колонок нет. Возможна доработка.

1.5 Не выгружается Excel из портала

Симптом: «не работает выгрузка в Excel из виджета / из портала».

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

• Хранимая процедура виджета — не возвращает ли ошибку
• Объём данных: выгрузка ограничена настройкой MaxExcelExportRows (по умолчанию 50000 строк). При превышении вместо файла возвращается ошибка «Max rows to export: N» — это штатное поведение, а не сбой; уменьшите выборку фильтрами или поднимите значение ключа
• Права пользователя на экспорт

1.6 Виджет-таблица или кастомная иерархия не грузит данные на PostgreSQL (ошибка 0A000)

Симптом: при открытии виджета-таблицы или кастомной иерархии — ошибка вида 0A000: cross-database references are not implemented: dbo.custom.<имя_функции> (в интерфейсе и в Администрирование → Лог ошибок как Npgsql.PostgresException ... 0A000).

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

• Схема функции-источника данных: если объект в схеме, отличной от dbo (обычно custom), имя должно быть указано со схемой явно — custom.имя_функции.
• Версия платформы: корректная обработка квалифицированных имён для этого пути (виджеты и иерархии) — начиная со сборки 2.268; на более ранних версиях воспроизводится.
• Временный обходной путь до обновления: перенести или продублировать функцию в схему dbo и переключить виджет/иерархию на неё (устраняет симптом, не первопричину).

---

1.7 В таблице пустые ячейки — значение появляется только после двойного клика

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

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

• Настройку «Брать ссылку из» у проблемной колонки: ссылкой становится только строка-адрес (http/https или путь от /); идентификатор задачи, число или пустое значение адресом не являются.
• Версию платформы: с 2.268 значение ячейки выводится текстом даже при невалидном адресе; на более ранних сборках такая настройка даёт пустые ячейки.

Решение: привести колонку-источник ссылки к строке-адресу либо очистить настройку «Брать ссылку из» у колонки — значения ячеек начнут отображаться сразу. Детализация (drill-down) настраивается отдельным полем и от этого не страдает.

2. Виджеты — Гант, Кнопка-тикер, прочие

2.1 Виджет Гант — нет колонок / не хватает доработок

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

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

• Версия системы — Гант активно дорабатывается
• Настройки виджета — какие колонки ожидаются

2.2 Значение колонки «Выполнено» в Ганте

Симптом: «за что отвечает колонка "Выполнено"?»

Решение: колонка «Выполнено» отображает процент выполнения задачи. Значение берётся из ДП, привязанного к этой колонке в настройках виджета.

2.3 Кнопка-тикер — некорректная ссылка / локализация

Симптом: «ссылка в кнопке-тикере ведёт не туда», «локализация не применяется для кнопки-тикера».

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

• URL в настройках тикера — корректен ли
• Локализация — заполнены ли переводы для нужного языка

2.4 Виджет «Контакты» — нет данных по звонкам

Симптом: «в виджете Контакты не отображаются данные по звонкам».

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

• Настройки интеграции с ВКС / телефонией
• Наличие данных в истории звонков

2.5 Виджет «Группа виджетов» — некорректное отображение списка

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

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

• Тип портальной страницы — dashboard, board, CSS Grid
• Настройки вложенных виджетов — корректны ли привязки
• Версия системы — поведение могло измениться после обновления

2.6 Виджет не отображается в ДП «Большой текст с форматированием»

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

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

• Тип виджета
• Контекст открытия — полная страница vs модальное окно

---

3. Порталы — создание и настройка

3.1 Ошибка при создании / добавлении портала

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

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

• Текст ошибки
• Версия системы
• Права администратора

3.2 Хранимая процедура портала — нет редактирования в AdminSPA

Симптом: «в AdminSPA нет возможности отредактировать хранимую процедуру для портала, как в старой админке».

Решение: в текущей версии AdminSPA редактирование хранимых процедур порталов ещё не реализовано. Использовать SSMS/pgAdmin для редактирования SP напрямую.

3.3 Пакетная обработка из-под портала

Симптом: «как сделать пакетную обработку из портала?»

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

3.4 Сертификат портала

Симптом: «как обновить SSL-сертификат на портале?»

Решение: сертификат настраивается на уровне веб-сервера (nginx/IIS), не в 1Ф. Передать администратору инфраструктуры.

3.5 Права доступа к публикациям не сохраняются

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

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

• Тип публикации — портал, пространство
• Роль пользователя — администратор публикации или нет
• Версия системы — поведение прав менялось в последних релизах

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

3.6 CSSGrid — потеря привязки виджетов при переносе

Симптом: «при переносе CSSGrid портала с настроенным виджетом не переносится сам виджет, отсутствует связь».

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

• Способ переноса — копирование категории, экспорт/импорт, ручной перенос
• Версия системы
• Наличие виджета в целевой категории после переноса

Когда обращаться в поддержку 1Ф: если виджет теряется при копировании CSSGrid — баг.

3.7 Создание учётных записей на портале

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

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

3.8 Расширение рабочей области портала на весь экран

Симптом: «как расширить рабочую область для порталов на весь экран?»

Решение: ширина рабочей области портала определяется настройками шаблона страницы (CSS Grid / dashboard). Для расширения — изменить параметры сетки в настройках страницы или использовать CSS-вставку.

3.9 Зависимый dropdown-фильтр показывает «Нет данных: …»

Симптом: «в выпадающем списке зависимого фильтра вместо значений вижу Нет данных: <название>».

Решение: это штатное поведение с 2.268.349. Раньше пустой каскад показывал просто Нет данных, теперь к плейсхолдеру дописывается название самого параметра — чтобы было понятно, какой именно зависимый фильтр оказался пустым. Сам пустой результат — следствие выбранного значения родительского параметра: по нему смарт-выражение/статический набор каскада не вернули ни одной строки. Проверить:

• выбранное значение родительского фильтра — действительно ли по нему должны быть данные;
• настройку Колонка родителя (для смарт-набора) или Ключ родителя (для статического набора) у дочернего параметра — корректно ли указано поле привязки;
• результат смарт-выражения дочернего параметра с переданным @eventParam2, равным значению родителя.

3.10 Зависимый фильтр падает с 500 или не блокирует недоступные значения

Симптом: «при выборе значения в родительском dropdown-фильтре виджет возвращает ошибку 500», либо «значения в зависимом фильтре не блокируются/не скрываются, хотя должны — признак доступности не работает».

Решение: оба симптома — следствие одного бага в бэкенде (перепутаны переменные при проверке на null), исправлено в сборке 2.268.378. Обновите систему. Если ошибка воспроизводится на актуальной версии — проверьте настройки «Колонка родителя»/«Колонка доступности» дочернего параметра (см. § «Каскадные выпадающие списки» выше) и обратитесь в поддержку 1Ф с логами.

---

3.11 После переноса портала пропали виджеты во вкладках Board или на узком экране

Симптом: портал выгрузили утилитой переноса конфигурации и загрузили на другую площадку. Корневая сетка на месте, а вкладка-секция Board пустая или на узком экране нет части виджетов.

Что проверить: режим вёрстки портала — Board или Dashboard с отдельными раскладками xs…xl; что в архив попал сам портал вместе с шаблонами секций, а не только виджеты; на какой сборке снят архив — выгрузка блоков секций и адаптивных раскладок появилась в 2.268.

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

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

---

3.12 Виджет выводит «Виджет не поддерживается» на портале

Симптом: вместо содержимого блока — на портальной странице или в превью конструктора портала — показан текст «Виджет не поддерживается»; при этом тот же виджет на другой странице работает.

Что проверить: тип вёрстки страницы — Dashboard, CSS Grid, Flex или Board. Набор поддерживаемых типов зависит от него: «Навигация» и «Мини-опрос» отображаются только в CSS Grid, а в Dashboard и в секциях Board на их месте заглушка. Блоки устаревших типов, оставшиеся от порталов прежних версий, не отображаются ни в одной раскладке.

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

Когда обращаться в поддержку 1Ф: если заглушка выводится для типа, который эта раскладка должна поддерживать, — например, «Навигация» перестала отображаться в CSS Grid после обновления.

---

3.13 Виджет не удаляется: в уведомлении перечислены порталы

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

Что проверить: сообщение «Виджет используется на следующих порталах» перечисляет порталы, на которых виджет размещён сейчас; тот же список заранее показывает действие «Где используется» в реестре виджетов.

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

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

---

3.14 Выпадающий список фильтра сразу раскрыт или не закрывается

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

Что проверить: какой параметр раскрыт и на какой странице портала; источник значений параметра и заполнена ли у него «Колонка родителя»; возвращает ли смарт-набор в колонке родителя фактические значения связи с родителем — заполненная настройка без таких данных иерархию не образует; точный номер сборки (вид 2.268.693, а не только название «Скульптор»: по названию семейства сборку с исправлением от более ранней не отличить).

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

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

---

3.15 Значение фильтра на портале не очищается — возвращается само

Симптом: «очищаю значение фильтра кнопкой „Очистить“ или крестиком у выпадающего списка, а значение возвращается»; у параметра «Значение по умолчанию» не заполнено, сохранение значений фильтров выключено.

Что проверить: заполнено ли у параметра поле «Значение по умолчанию» — при открытии портала подставляется именно оно; чем чистили значение — кнопкой «Очистить» над фильтром или крестиком у списка; какое значение возвращается (например, элемент 0 или первый элемент списка); точный номер сборки (вид 2.268.693, а не только название «Скульптор»: по названию семейства сборку с исправлением от более ранней не отличить).

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

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

4. Новости

4.1 Новости не отображаются в мобильном приложении

Симптом: «не отображаются новости в МП на Android и iOS», «несогласованные новости видны в МП».

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

• Версия мобильного приложения
• Статус новости — опубликована ли / согласована ли
• Настройки видимости новости — для каких групп

4.2 HTML-теги в заголовке / карточке новости

Симптом: «в заголовке новости отображаются HTML-теги», «на карточке новости — null».

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

• Контекст отображения — через категории или через ленту
• Формат заголовка — нет ли «сырого» HTML

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

4.3 Пропала возможность ставить лайки

Симптом: «не могу ставить лайки новостям, как раньше».

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

• Версия системы — настройка лайков могла переехать
• Настройки категории новостей

4.4 Поиск по содержимому новостей / статей FAQ

Симптом: «не работает поиск по содержимому новостей», «поиск по статьям FAQ не находит».

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

• Индексация — запущена ли полнотекстовая индексация
• Версия системы

4.5 Тэги в заголовке новости

Симптом: «как использовать тэги в заголовках новостей?»

Решение: тэги для новостей настраиваются в категории новостей. Отображение тэгов зависит от версии.

---

5. Пространства и статьи

5.1 Нет системных категорий пространств

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

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

• Версия системы
• Права пользователя
• Настройки модуля «Пространства»

5.2 Подписи изображений в статьях сместились

Симптом: «подписи изображений в статьях пространств стали располагаться не под изображениями».

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

• Версия системы — после обновления мог измениться стиль
• CSS — нет ли пользовательских стилей, конфликтующих с обновлением

5.3 Поле «Контакты» в пространствах

Симптом: «в чём смысл поля Контакты в пространствах?»

Решение: поле «Контакты» привязывает к пространству ответственных лиц. Отображается как ссылка на профили пользователей в шапке пространства.

5.4 Настройки категории не открываются из списка пространств

Симптом: «не могу перейти в настройки категории из списка пространств, хотя из бокового меню — работает».

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

• URL — отличаются ли ссылки
• Версия системы

---

6–9. JS-вставки, дашборды, смарт-действия и инфраструктура порталов

6.1 Ошибка при добавлении JS-вставки

Симптом: «не могу поставить JS в портал», «ошибка при добавлении JS-вставки».

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

• Синтаксис JS — нет ли ошибок
• CSP (Content Security Policy) — не блокирует ли
• Версия системы

6.2 Дублирование JS-вставок при копировании категории

Симптом: «при копировании категории JS-вставки тоже копируются (дублируются)».

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

6.3 Один виджет не отобразился: вместо содержимого — «Ошибка загрузки»

Симптом: на странице портала, дашборда или борда один блок показывает «Ошибка загрузки», остальные блоки отрисованы штатно; в консоли браузера — сообщение Widget component creation failed: <тип виджета>.

Что это значит: отказ изолирован на уровне одного виджета — вся страница не белеет. Исключение при создании виджета перехватывается, на его месте ставится заглушка, факт пишется в лог с типом виджета.

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

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

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

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

---

7. Дашборды в мобильном приложении

7.1 Цвет текста на плитке дашборда не применяется

Симптом: «в МП не применяются настройки цвета текста на плитке дашборда».

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

• Версия мобильного приложения
• Настройки плитки — какие цвета заданы

7.2 Не добавляется виджет на портал

Симптом: «не могу добавить виджет на портал».

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

• Тип виджета
• Тип страницы (dashboard, board, CSS Grid) — не все виджеты совместимы со всеми типами
• Права администратора портала

---

8. Смарт-действия и публикации

8.1 Смарт-действие через публикацию — ошибка

Симптом: «смарт-действие "Резолюция подписи", вызванное через публикацию, возвращает ошибку».

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

• Тип смарт-действия — какое именно действие вызывается
• Контекст вызова — из карточки задачи работает, а из публикации — нет
• Версия системы — совместимость смарт-действий с публикациями ограничена

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

8.2 Быстрый опрос на портале

Симптом: «как настроить быстрый опрос на портале?», «не работает быстрый опрос».

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

• Настройки виджета опроса — привязан ли к категории
• Права пользователей на участие в опросе
• Версия системы — функционал может быть недоступен в старых версиях

---

9. Инфраструктура порталов

9.1 Настройки балансировщика для продуктивного портала

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

Решение: балансировка настраивается на уровне инфраструктуры (nginx/HAProxy), не в 1Ф. Передать администратору инфраструктуры. Ключевые моменты: sticky sessions, проброс заголовков, health checks.

---

Чеклист для первичной диагностики

Что зафиксировать при первичном разборе:

1. Тип проблемы — виджет (Таблица/Гант/тикер/Группа виджетов), портал (создание/настройка/публикации), новости, пространства, JS-вставки, смарт-действия
2. Версия системы
3. Контекст — веб / мобильное приложение
4. Тип портальной страницы — dashboard, board, CSS Grid, Flex; для заглушки «Виджет не поддерживается» — тип блока
5. Скриншот / текст ошибки
6. Работало ли до обновления — если да, какая версия была до

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

• HTML перестал рендериться в виджете после обновления (баг)
• Портал не отображается после обновления системы
• Массовые проблемы с виджетами после обновления
• Ошибка при создании портала при корректных настройках
• JS-вставки блокируются CSP
• Права доступа к публикациям не сохраняются при корректной роли
• CSSGrid теряет привязку виджетов при переносе
• После переноса портала пустые секции Board или пропавшие виджеты на одном размере экрана
• «Виджет не поддерживается» на типе, который раскладка должна поддерживать
• Смарт-действие работает из карточки, но не из публикации