Экспорт и импорт метаданных

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

Механизм основан на автоматическом поиске зависимостей для выбранной сущности и выгрузке их в json-файл, который можно импортировать в другую систему. При импорте все объекты сопоставляются с существующими в системе-приемнике объектами и автоматически «склеиваются» с ними. Сопоставление происходит на основании уникальных идентификаторов объектов (uuid). Для всех системных сущностей обеспечены одинаковые uuid, что позволяет переносить метаданные между независимыми экземплярами Triafly.

Если при импорте встречается несуществующий в системе-приемнике объект - он будет создан, и для него будет зафиксирован тот же uuid. Если объект уже существует, то он будет отредактирован.

Экспорт и импорт метаданных доступен пользователям с правами Администратора.

При переносе метаданных, не переносятся данные. Т.е. если переносится отчет, то не будут перенесены значения в ячейках, если реестр - то не будут перенесены строки реестра. Переносится только структура объектов. Для переноса данных необходимо воспользоваться функционалом по экспорту и импорту данных (например, через xls-файлы).

Для переноса метаданных необходимо перейти на страницу настроек и нажать соответствующую кнопку:

_images/metadata_expimport_button.png

Откроется страница с перечнем всех сущностей системы.

Экспорт

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

_images/metadata_expimport_preview.png

Некоторые сущности не могут быть экспортированы (такие как справочник пользователей, ролей, пароли, доступы). В случае, если экспортируемая сущность связана с неэкспортируемым объектом, система выдаст соответствующее предупреждение. Такие сущности не могут быть экспортированы. Для решения этой проблемы необходимо обеспечить, чтобы в зависимых сущностях не было неэкспортируемых объектов.

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

Чекбокс «Экспортировать с сохранением групп» определяет, будет ли сохранена структура групп для экспортируемых сущностей. По умолчанию, все импортируемые объекты складываются в группу «Импортированные», но если чекбокс был установлен при экспорте, то при импорте все объекты будут помещены еще и в свои группы, в которых находились в системе-источнике.

Импорт

Для импорта необходимо нажать кнопку «Импорт метаданных», приложить файл и нажать «ОК». Откроется окно предпросмотра состава импортируемых данных:

_images/metadata_expimport_import.png
В окне предпросмотра все импортируемые объекты помечены соответствующими маркерами:
  • Зеленый - новый объект будет создан при импорте. Например, импортируется новый, не существующий показатель.

  • Синий - испортируемый объект в точности соответствует существующему в Системе объекту и будет «склеен» с ним без изменений. Например, импортируется уже существующий справочник.

  • Красный - объект соответствует существующему в Системе объекту, но при импорте существующий объект будет изменен. Например, импортируется более новая версия существующего отчета.

Для импорта необходимо нажать кнопку «Импортировать».

Примечание

Операция импорта метаданных может занять продолжительное время, в зависимости от объема файла.