Общие сведения

Функциональность экспорта и импорта позволяет экспортировать проект в файл и импортировать проект из файла.

Выполнение экспорта и импорта доступно только учетным записям с ролью "Суперпользователь". 

В файл экспорта сохраняется сам проект – с его свойствами, настройками, содержимым и настройками содержимого – и связанные с этим проектом сущности приложения с их настройками:

• пользовательская тема проекта – если используется в экспортируемом проекте;
• виджеты – если используются в проекте;
• пользовательские компоненты виджетов – если используются в экспортируемых виджетах;
• SVG-объекты – если используются в проекте;
• глобальные фильтры – если используются в проекте;
• датасеты без данных* – если используются в компонентах проекта**;

• группы пользователей без пользователей*** – если используются в настройках прав доступа перечисленных выше сущностей.

  Информация
  title Обратите внимание
  * Данные датасетов не сохраняются экспортом. После импорта проекта, для затронутых импортом (созданных или измененных) датасетов необходимо выполнять восстановление данных. ** Для объединенного датасета из датасетов локального хранилища сохраняются и переносятся все используемые в нем датасеты. *** После импорта проекта, в создаваемых импортом группах пользователей необходимо настраивать состав пользователей вручную.

  —

При импорте должно соблюдаться соответствие версий модулей приложения.

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

Функциональность экспорта и импорта НЕ предусматривает копирования:

• базовых компонентов виджетов – базовые компоненты виджетов должны присутствовать на стенде, в который импортируется проект;
• данных датасетов – данные в датасет требуется восстанавливать после импорта;
• источников – источники необходимо создавать вручную.

Также не экспортируются метаданные проекта: теги и признак "Избранное".

Экспорт проекта

1. Авторизуйтесь в системе под учетной записью с ролью "Суперпользователь".

2. Перейдите в раздел "Проекты".

3. Нажмите для соответствующего проекта кнопку действий "" в табличном или карточном представлении и выберите в меню вариант "Экспортировать". Об успешном запуске экспорта сообщает нотификация "Выполняется экспорт проекта".

4. Когда файл экспорта сформирован, поступает соответствующее уведомление. Откройте окно уведомлений, найдите уведомление "Экспорт проекта завершен" и нажмите в нем кнопку "Скачать".

–

Импорт проекта

Подготовка к импорту

Якорь
PrepareToImport PrepareToImport

1. Убедитесь, что соблюдается соответствие версий модулей приложения. Откройте архивный файл экспорта, откройте корневой файл versions. Сравните указанные в файле версии модулей с версиями модулей на целевом стенде (см. Модули). Отличие в версиях модулей приведет к появлению уведомления об отличии версий модуля и отказу в импорте.

2. Если импортируемый проект содержит виджеты, которые используют базовые компоненты, убедитесь, что эти компоненты присутствуют как базовые на целевом стенде (см. Компоненты). Отсутствие базовых компонентов приведет к необходимости настраивать созданные импортом виджеты вручную.

3. Если импортируемый проект использует датасеты, которые созданы SQL-запросом или прямым подключением, убедитесь, что на целевом стенде существуют одноименные источники, из которых вы сможете восстановить данные датасета (см. Источники). 

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

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

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

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

Импорт

1. Авторизуйтесь в системе под учетной записью с ролью "Суперпользователь". Все сущности, затрагиваемые импортом, создаются с авторством учетной записи, от имени которой выполняется импорт.

2. Перейдите в раздел "Проекты".

3. Нажмите на кнопку "Добавить". В открывшемся модальном окне "Добавление проекта" выберите вариант "Импорт", чтобы перейти к шагу выбора файла импорта.

–

–

4. В открывшемся модальном окне "Импорт проекта" нажмите на кнопку "Загрузить". Выберите файл экспорта.
Включите параметр "Импортировать группы пользователей" при необходимости. Когда параметр включен, импортируются группы пользователей, используемые в правах доступа прочих импортируемых сущностей.

–

–

5. Дождитесь загрузки файла - в блоке загрузки появятся иконка и название проекта, указание размера файла, а также кнопки для замены файла импорта и для удаления файла импорта . 
Нажмите на кнопку "Далее", чтобы запустить импорт.

6. Откроется модальное окно со сведениями о проекте - название проекта, название источника и его тип, указание задействованных в проекте сущностей:

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

7. При нажатии на кнопку "Далее" система производит проверку на наличие в файле сущностей с названиями, совпадающими с именами сущностей внутри системы. Возможно два варианта поведения:

• • Если в файле импорта нет сущностей, названия которых совпадают с имеющимися в системе сущностями, происходит импорт, и сразу переход к шагу 8.
  • Если в файле импорта есть сущности, названия которых совпадают с названиями имеющихся в системе сущностей, выводится модальное окно вариантов импорта:

• При выборе варианта "Заменить текущие" существующие сущности, названия которых совпадают с названиями сущностей из файла экспорта, заменяются сущностями из файла экспорта и создаются прочие связанные сущности.
• При выборе варианта "Создать копии" сущности из файла экспорта, названия которых совпадают с существующими сущностями, создаются с прибавлением индекса к названию, и создаются прочие связанные сущности. Индекс прибавляется к названиям по следующему правилу:

–

8. В уведомления системы поступит уведомление об импорте либо ошибке импорта проекта. Уведомление об импорте содержит кнопку "Результаты импорта", при нажатии на которую открывается окно сведений о замененных или добавленных сущностях.

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

* Когда источник с таким же названием существует, затрагиваемый импортом датасет автоматически связывается с ним, и название источника отображается для датасета в реестре, в колонке "Источник".

** Если набор или тип данных полученных колонок отличается, разрешите конфликты связей вручную.

10. Настройте состав пользователей в группах, созданных импортом. Для этого перейдите в раздел "Группы" и воспользуйтесь инструкцией по добавлению пользователей в группу (см. Группы).