Обновление набора данных из файла

Обновление набора данных из файла

На платформе Visiology предусмотрена возможность обновления набора данных из файла в формате JSON. Данный функционал полезен при необходимости массового редактирования структуры или содержимого набора данных без выполнения операций вручную через интерфейс. Процесс обновления включает два основных этапа:

  • экспорт текущего набора данных в виде JSON-файла;

  • обновление целевого набора данных путем импорта из файла.

Таким образом, пользователь может скачать набор данных в виде JSON-файла и загрузить его обратно в систему, например, в другой рабочей области. В результате, существующие таблицы будут обновлены, а новые – добавлены в соответствии с содержимым файла.

Предварительные условия

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

  • Убедитесь, что структура и содержимое экспортируемого JSON-файла соответствуют требованиям целевого набора данных.

Шаг 1. Экспорт исходного набора данных в JSON-файл

  1. Перейдите на главную страницу дизайнера дашбордов и выберите рабочую область, содержащую набор данных, который планируется скопировать и загрузить позже. В нашем примере это Гипермаркет CreativeElectronix:

    workspace.png
  2. В рабочей области перейдите на вкладку Наборы данных, нажмите напротив названия набора данных, который вы хотите выгрузить в файл (мы выбрали Магазин), и выберите пункт Скачать набор данных как файл. JSON-файл скачается на ваш компьютер:

    download.png

Шаг 2. Импорт подготовленного JSON-файла

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

  2. На вкладке Наборы данных, найдите целевой набор данных, щелкните напротив его названия, и выберите пункт меню Обновление набора данных из файла:

    another-dataset.png
  3. В открывшемся диалоге нажмите кнопку Выбрать файл, выберите ранее сохраненный JSON-файл и нажмите кнопку Далее:

    select-file.png
  4. В открывшемся окне вы можете проверить соответствие таблиц существующего набора данных и набора данных, загружаемого из JSON-файла. Зеленый фон в названии таблиц указывает на то, что эти таблицы отсутствуют в целевом наборе данных и будут добавлены в набор данных. Сиреневый – что таблицы с таким названием существую и они будут обновлены:

    compare-data.png
  5. Если вас все устраивает, нажмите кнопку Обновить. Система начнет процедуру обновления набора данных согласно содержимому загруженного файла.

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

    to-be-updated.png

    Процедура отличается в зависимости от типа источника: база данных (JDBC) или файлы (Excel/CSV):

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

    edit-loader.png

     

  2. Настройте подключение:

    • В списке доступных подключений выберите требуемое подключение или создайте новое и нажмите Сохранить в правом нижнем углу:

      edit-connection.png
    • Подключение обновится, о чем система оповестит вас. Об успешном подключении будет сигнализировать отсутствие восклицательного знака напротив названия таблицы.

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

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

  1. Откройте дашборд.

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

    change-source.png
  3. В открывшемся окне выберите требуемое подключение в списке доступных подключений или создайте новое:

    change-source2.png

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

  4. Введите SQL-запрос и нажмите применить. Например:

    request.png

     

  5. Далее нажмите Предпросмотр и просмотрите столбцы на соответствие. Если они идентичны и у них одинаковые типы данных, нажмите Заменить в правом нижнем углу:

    compare.png
  6. Таблица обновится, о чем система оповестит вас. Об успешном подключении будет сигнализировать отсутствие восклицательного знака напротив названия таблицы.

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

Для таблиц, загруженных из “1С:Предприятие” или с помощью Self-Service ETL, необходимо выполнить ту же процедуру смены источника данных, что и для таблиц, загруженных из файлов (см. выше).

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

Обновление наборов данных из файла возможно исключительно в рамках одной версии платформы. Перенос между разными версиями (как с младшей на старшую, так и со старшей на младшую) не поддерживается.


Смотрите также

Обновление набора данных и отдельных таблиц