Перейти к основному содержимому Перейти к дополнительному содержимому
Ресурсы Qlik

Перенос закладок из QlikView в клиенты Qlik Cloud

QlikView Object Migration for Cloud — это инструмент, который переносит закладки сервера в приложения QlikView в управляемых пространствах, находящихся в клиенте Qlik Cloud.

Закладки сервера не включаются при добавлении документов QlikView в клиент Qlik Cloud. QlikView может назначить владение закладкой пользователям Active Directory в QlikView Server и пользователям в клиенте Qlik Cloud. QlikView Object Migration for Cloud сопоставляет этих пользователей, чтобы можно было назначить их владельцами закладок сервера. В процессе переноса QlikView Object Migration for Cloud связывается со службой Active Directory, получает информацию об идентификаторах и адресах электронной почты пользователей и связывает их с пользователями клиента Qlik Cloud по адресу электронной почты. Также можно вручную сопоставить пользователей, чтобы закладкой владел другой пользователь. Закладки хранятся в файле QMT, а затем переносятся в приложение в клиенте Qlik Cloud.

Когда запускается QlikView Object Migration for Cloud, происходит следующее:

  1. Общие файлы (.TShared или .Shared) с закладками копируются в рабочую папку.

  2. Имена файлов и метаданные загружаются в рабочую папку.

  3. Выбирается один общий файл и затем выбираются либо все, либо какое-либо подмножество закладок в файле. Они экспортируются в новый общий файл.

  4. Выбранный общий файл загружается в приложение QlikView в клиенте Qlik Cloud.

Перенести закладки можно с помощью документа QlikView, CloudMigrationApp, входящего в QlikView Object Migration for Cloud. CloudMigrationApp управляет скриптами, файлами и командами для переноса закладок. Перенести закладки можно также с помощью командной строки для запуска файлов QlikView Object Migration for Cloud.

Инструмент QlikView Object Migration for Cloud доступен в Загружаемые файлы продукта.

Перед началом работы

Перед загрузкой и запуском QlikView Object Migration for Cloud убедитесь, что соблюдаются следующие требования:

  • QlikView Desktop должен быть установлен.

  • Документы QlikView, в которые нужно добавить общие закладки на сервере, добавлены в клиент Qlik Cloud.

  • Пользователь должен иметь права Доступ «Профессионал».

  • У вас есть доступ к Консоль управления в клиенте Qlik Cloud.

  • Необходимо создать ключ API в клиенте Qlik Cloud для использования с QlikView Object Migration for Cloud.

  • Необходимо иметь одно из следующих разрешений в целевом управляемом пространстве:

    • Владелец
    • Может просматривать
    • Имеет право на добавление
    • Может управлять

  • Необходимо иметь идентификаторы приложений для целевых приложений QlikView для закладок. Идентификатор приложения можно получить из строки, следующей за document= в URL-адресе приложения.

    Например, в URL-адресе приложения QlikView https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6, идентификатор приложения — e74ebae5-5659-4211-a4de-add8e49768f6. Идентификаторы приложений могут немного отличаться по формату в зависимости от того, были ли они опубликованы в облачном хабе или непосредственно загружены в облачный хаб.

  • Для QlikView Object Migration for Cloud требуется модуль Windows Active Directory. Если он не установлен, QlikView Object Migration for Cloud установит его автоматически.

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

Загрузка и настройка QlikView Object Migration for Cloud

Выполните следующие действия.

  1. Загрузите QlikView Object Migration for Cloud с Загружаемые файлы продукта.

    Для получения дополнительных сведений см. Загрузка файлов установки (только английский язык).

  2. Перейдите в папку %ProgramData%\QlikTech.

  3. Создайте папку с именем QlikViewMigrationTool и скопируйте файлы QlikView Object Migration for Cloud в эту папку.

  4. По желанию создайте папку и добавьте в нее общие файлы, содержащие закладки, которые нужно перенести в клиент.

Перенос закладок в приложение QlikView с помощью CloudMigrationApp

Примечание к предупреждениюНе изменяйте скрипт загрузки в CloudMigrationApp.

Выполните следующие действия.

  1. Перейдите в распакованную папку QlikView Object Migration for Cloud и откройте документ CloudMigrationApp в QlikView Desktop.

  2. Прочитайте и примите условия и положения QlikView Object Migration for Cloud.

  3. Щелкните Параметры > Параметры пользователя.

  4. На вкладке Сохранение выберите Save before reload (Сохранить перед перезагрузкой). Это не позволит QlikView очистить входные данные после перезагрузки.

  5. На вкладке Безопасность выберите следующие параметры и нажмите кнопку OK:

    • Скрипт (Разрешить операторы записи и выполнения в базе данных)

  6. Следуйте указаниям в документе QlikView для каждого листа:

    1. В 1. Initialize (Инициализация) выберите папку, в которой хранятся общие файлы, и папку, в которую будут выводиться копии, загруженные в клиент.

    2. В 2. Get User Data (Получение данных пользователей) установите параметры, необходимые для сопоставления владельцев общей закладки с пользователями в клиенте Qlik Cloud.

    3. В 3. View user mapping file (Просмотр файла сопоставления пользователей) просмотрите сопоставление.

      При необходимости измените сопоставление в файле OnPremToCloudMap.csv. Чтобы сопоставить пользователей QlikView с пользователями Qlik Cloud, добавьте значения Идентификатор пользователя и Субъект IdP для пользователей из Qlik Cloud Консоль управления в записи пользователей QlikView. После завершения щелкните Перезагрузить на листе.

    4. В 4. Overview (Обзор) убедитесь, что загружен правильный файл.

    5. В 5. Filter metadata (Фильтр метаданных) по желанию используйте фильтры, чтобы уменьшить количество общих закладок для переноса в клиент.

    6. В 6. Prepare new shared files for Cloud (Подготовка новых общих файлов для облака) выберите общий файл из приложения, закладки которого необходимо перенести. По желанию выберите идентификаторы закладок, которые нужно включить. Если не выбрать ни одной, будут включены все доступные закладки.

    7. В 7. Upload to Cloud (Загрузка в облако) установите целевое приложение в клиенте и загрузите закладки.

  7. Повторите шаги 5. Фильтр метаданных, 6. Подготовка новых общих файлов для облака и 7. Загрузка в облако для каждого дополнительного приложения, в которое нужно перенести закладки.

  8. Сохраните и закройте CloudMigrationApp.

    CloudMigrationApp сохраняет входные данные, которые были добавлены в приложение при его сохранении.

Перенос закладок в приложение QlikView из командной строки

Выполните следующие действия.

  1. Откройте командную строку от имени администратора.

  2. Перейдите в папку QlikView Object Migration for Cloud: C:\ProgramData\QlikTech\QlikViewMigrationTool.

  3. Введите следующую команду, чтобы скопировать общие файлы и метаданные в выходную папку: QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

    Замените переменные: 

    • $(vInputFolder): путь к папке, в которой хранятся общие файлы.

    • $(vOutputFolder): путь к папке, в которой хранятся переносимые файлы.

  4. Введите следующую команду для получения данных пользователей из Active Directory: QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)".

    Замените следующие переменные:

    • $(vDCServer): URL-адрес сервера контроллера домена.

    • $(vADOutputfile): путь к папке для хранения списка пользователей QlikView Server, включая имя файла и .csv.

  5. Введите следующую команду для получения данных пользователей из клиента Qlik Cloud: QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)".

    Замените следующие переменные:

    • $(vCloudURL): URL-адрес клиента Qlik Cloud.

    • $(vApiKey). Ключ API из клиента Qlik Cloud.

    • $(vUserIdMapLocation): путь к папке для хранения списка пользователей клиента, включая имя файла и .csv.

  6. Создайте новый файл CSV с именем OnPremToCloudMap.csv со следующими столбцами:

    • Owner
    • subject
    • id

  7. В OnPremToCloudMap.csv добавьте значения из столбца Owner файла <app>.qvw.tshared.xlsx, созданного в выходной папке на шаге 3, с соответствующими значениями subject и id из файла .csv, созданного на шаге 5.

  8. Создайте новый файл CSV и добавьте в него одностолбцовый список идентификаторов закладок из общего файла, который нужно перенести в клиент Qlik Cloud. Идентификаторы закладок находятся в файле <app>.qvw.tshared.xlsx, созданном в выходной папке на шаге 3.

  9. В командной строке создайте файл QMT с закладками, который будет загружен в клиент, введя следующую команду: QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)".

    Замените следующие переменные:

    • $(OriginalSharedFile): полный путь, включая имя файла, к месту расположения общего файла.
    • $(csvFile): полный путь, включая имя файла, к файлу CSV, содержащему идентификаторы закладок.
    • $(OnPremToCloudMap.csv): полный путь, включая имя файла, к OnPremToCloudMap.csv.
    • $(Updated): путь к папке, в которой будет храниться файл QMT.
    • $(vApiKey): Ключ API из клиента Qlik Cloud.

  10. Выполните следующую команду, заменив переменные: qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)".

    Замените следующие переменные:

    • $(vCloudURL): URL-адрес клиента Qlik Cloud.

    • $(vAppId): идентификатор приложения, в которое переносятся закладки.

    • $(vApiKey): Ключ API из клиента Qlik Cloud.

    • $(vSharedFileToUpload): полный путь, включая имя файла, к файлу QMT, содержащему закладки.

    • $(vHandledDirectory): полный путь к папке, в которой будет храниться файл QMT после переноса в облако.

    Примечание к информацииОтобразится сообщение: «Журнал параметров записан в C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt». Проверьте журнал, чтобы убедиться в успешном завершении миграции.

Ограничения

QlikView Object Migration for Cloud имеет следующие ограничения:

  • QlikView Object Migration for Cloud не поддерживает перенос закладок в приложения QlikView в личных пространствах. Можно переносить закладки в приложения QlikView в общих пространствах, но они недоступны пользователям.

  • Пути UNC не поддерживаются для входных или выходных папок. Поддерживаются общие папки, подключенные к локальным дискам.

  • Количество файлов XLSX на листе 4. Overview (Обзор) может отличаться от количества фактических файлов в папке. Это связано с тем, что пустые файлы метаданных не видны в приложении.

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

  • Когда закладки уже перенесены из общего файла, их миграцию нельзя выполнить повторно, если они были открыты для общего доступа в Qlik Cloud.

Помогла ли вам эта страница?

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

Оставьте свой отзыв здесь