Ограничения и рекомендации при обновлении системы до версии 2408

В этой статье

Ограничения и рекомендации при обновлении системы до версии 2408

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

Отказ от страниц в дашбордах

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

Настройки правил отображения

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

В связи с этим ограничением рекомендуем также обновить сами пакеты пространств из предыдущих версий системы, в отчетах которых настроены правила отображения. Для этого:

Импортируйте эти пакеты в версию 2408.
Настройте заново правила отображения.
Экспортируйте обновленные пакеты.

После этого при импорте обновленных пакетов в 2408 или в более позднюю версию системы ошибки с правилами отображения не возникнут.

Отображение виджетов

Ширина виджетов в образах адаптивная и может отличаться от ширины в старой версии.

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

Ссылки на объекты системы

Так как в ссылках на объекты системы теперь используется название объекта (name) вместо GUID, при изменении названий объектов в системе необходимо обновлять ссылки на них вручную в YAML-редакторе дашборда. GUID больше не используется в следующих ссылках:

на состояние (stateGuid заменен на stateName)
на процесс в виджетах «Карта процесса» и «Сфера процессов» (processGuid заменен на processName)
на переменную в условии отображения и в виджете «Параметр» (variableGuid заменен на variableName)
на скрипт в действии (scriptGuid заменен на scriptKey)
на ожидаемое поле в действии (guid заменен на name)
на общий разрез или меру в сортировках (guid заменен на name)

При обновлении системы замена всех ссылок в формулах отчетов произойдет автоматически.

Также обратите внимание, что теперь использование пустых имен элементов в пространстве недопустимо. Если у элементов дашборда отсутствуют названия, их необходимо заполнить вручную и обновить ссылки в формулах, которые используются в виджетах.

Ссылки на отчеты

Прежние ссылки на дашборды больше не поддерживаются. В обновленных URL дашбордов теперь не отображается GUID дашборда и идентификатор пространства, в котором дашборд находится.

Блок автоматизации Выполнить скрипт

Рекомендуем запускать один скрипт из другого через новый блок автоматизации Выполнить скрипт, а не с помощью GraphQL-запросов. Новый блок позволяет получать информацию о статусе выполнения дочернего скрипта и является более безопасным, так как не требует использования ключа API в открытом виде. При переходе на новый подход:

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

Уникальный ключ скрипта

Новое поле с уникальным Ключом скрипта обеспечивает корректный запуск скрипта из дашборда, даже если название скрипта было изменено. Однако изменение самого ключа приведет к тому, что запуск скрипта из дашборда перестанет работать. В этом случае потребуется заново настроить его, чтобы восстановить работоспособность.

Кастомные виджеты

Добавленные ранее в Маркетплейс кастомные виджеты несовместимы с версией системы 2408. Новые версии кастомных виджетов, предоставляемых компанией Инфомаксимум, будут доступны в Маркетплейсе. Рекомендуем обновить версии пакетов кастомных виджетов в рабочих пространствах. После обновления пакетов виджеты в дашбордах обновятся автоматически.

Чтобы массово обновить пакеты, установленные в различных пространствах, до версии, размещенной в Маркетплейсе, перейдите по адресу: http(s)://{адрессервера}:{используемыйпорт}/graphiql и выполните следующую мутацию:

mutation {
  workspace{
    packages{
      update_by_guid_and_version(
        guid: "398f6dd3-a8c8-46ce-94b2-fca23593424b"
        version: "1.0.0"
      )
    }
  }
}

Где:

guid — GUID обновляемого пакета
version — текущая версия пакета, которую необходимо обновить до версии из Маркетплейса

После выполнения мутации все пакеты с указанным GUID и версией будут обновлены до последней версии, доступной в Маркетплейсе.

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

Обновить виджет «Запустить скрипт». Новая версия доступна по ссылке. Обратите внимание, что в последующих релизах поддержка виджета будет прекращена
Перейти на использование виджета «Кнопка». Новый виджет позволяет настраивать различные действия по клику, делает работу с дашбордами более удобной и снижает вероятность возникновения ошибок. Рекомендуем выбрать этот вариант

Возможные ошибки

В исключительных случаях при переходе на использование образов могут возникать ошибки визуализации. При их возникновении вы можете обратиться в техническую поддержку по адресу электронной почты support@infomaximum.com.

Была ли статья полезна?

Да

Нет

Известные проблемы и ограничения в Агенте мониторинга

Список изменений