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

Экспорт шаблонов отчетов из Qlik NPrinting в Qlik Cloud

Функция экспортаQlik NPrinting преобразует шаблоны отчета, подключенные к приложениям Qlik Sense Enterprise on Windows. Формат преобразованного отчета может быть импортирован в Qlik Cloud вместе с приложениями Qlik Sense.

Следующие версии Qlik NPrinting поддерживают экспорт отчетов для использования в Qlik Cloud:

  • Qlik NPrinting Февраль 2024: Поддерживается экспорт шаблонов Excel

  • Qlik NPrinting Февраль 2025: Поддерживается экспорт шаблонов Excel и PixelPerfect

Перенесенные шаблоны отчетов Excel можно редактировать в надстройке Qlik для Microsoft Excel и распространять с помощью Qlik Cloud. Перенесенные шаблоны отчетов PixelPerfect можно редактировать в интерфейсе Qlik Cloud и распространять с помощью Qlik Cloud.

Пользователи могут экспортировать шаблоны:

  • В Веб-консоль Qlik NPrinting: Можно экспортировать все шаблоны отчетов Excel и PixelPerfect, подключенные к конкретному приложению Qlik Sense.

  • С использованием NPrinting API: можно выбрать экспорт всех отчетов в приложении Qlik NPrinting или в конкретной выборке.

video thumbnail

Условия

Чтобы перенести шаблон отчета из Qlik NPrinting в Qlik Cloud, необходимо следующее:

  • Доступ к Веб-консоль Qlik NPrinting с использованием учетной записи пользователя с разрешением Экспортировать отчеты.

  • Приложение Qlik Sense, которое:

    • было первоначально создано в Qlik Sense под управлением клиента и подключено к Qlik NPrinting;

    • было перенесено в клиент Qlik Cloud. Потребуется новая URL-ссылка приложения. Для получения информации о миграции приложений Qlik Sense см. обзор Инструмент миграции аналитики Qlik.

      Примечание к информацииПосле загрузки приложения Qlik Sense в Qlik Cloud не изменяйте версию, которая все еще находится в Qlik Sense под управлением клиента. Изменения, внесенные в одну версию приложения, не отражаются в другой.
  • Один или несколько шаблонов отчета в формате Excel или PixelPerfect для Qlik NPrinting, содержащие объекты из подключения Qlik NPrinting к Qlik Sense под управлением клиента. Отчеты, содержащие неподдерживаемую функциональность, не будут добавлены в экспортированный файл. Чтобы экспортировать шаблон, необходимо отредактировать его в Qlik NPrinting и удалить неподдерживаемую функциональность. Нижеперечисленное не поддерживается

    • Отчеты, подключенные к документам QlikView.

    • Отчеты, подключенные к нескольким приложениям Qlik Sense.

Примечание к информацииЭкспортированный файл отчета будет содержать параметры из файла шаблона в Qlik NPrinting. Параметры отчета Qlik NPrinting, такие как динамическое именование, циклическое выполнение и фильтры, не импортируются в Qlik Cloud.

Поддержка форматов шаблона Qlik NPrinting

Qlik NPrinting поддерживает файлы XLS, XLSX и XLSM в качестве пользовательских шаблонов. Все шаблоны будут преобразованы в формат XLSX, чтобы из можно было импортировать в Qlik Cloud.

Примечание к предупреждению

В целях безопасности файлы Excel с макросами (XLSM) будут преобразовываться в XLSX, а макросы будут удаляться.

Qlik NPrinting февраля 2024 года экспортирует только файлы шаблонов Excel. Qlik NPrinting февраля 2025 года экспортирует файлы Excel и PixelPerfect.

По соображениям безопасности, если шаблон PixelPerfect содержит скрипты, эти скрипты удаляются при загрузке шаблона в Qlik Cloud. Функциональность скриптов больше не будет доступна.

Экспорт отчетов в веб-консоли

Веб-консоль Qlik NPrinting может экспортировать все отчеты Excel и PixelPerfect, которые используют конкретное подключение Qlik NPrinting к одному приложению Qlik Sense.

  1. Выполните вход в Qlik NPrinting.

  2. В верхнем меню выберите Администратор > Экспорт шаблонов QCS.

  3. В раскрывающихся меню выберите приложение Qlik NPrinting и подключение Qlik Sense.

  4. Введите URL нужного приложения Qlik Sense в Qlik Cloud. Удалите наклонную черту (/) в конце URL.

  5. Нажмите Загрузить.

Браузер загрузит архив ZIP с перечисленными ниже файлами:

  • Файл журнала с информативными сообщениями об ошибках.

  • Подпапка, содержащая все экспортированные шаблоны отчетов в формате XLSX (Qlik NPrinting февраля 2024 года) или все шаблоны в форматах XLSX и QPXP (Qlik NPrinting февраля 2025 года).

Примечание к информации

Экспортированные файлы могут содержать элементы отчетов, не поддерживаемые в отчетности Qlik Cloud. Чтобы проверить отчеты на соответствие текущим Qlik Cloud функциональным возможностям, см. Использование отчетов Excel с надстройкой Qlik для Microsoft Excel или Использование PixelPerfect отчетов в вашем Qlik Cloud клиенте.

Экспорт отчетов с помощью API

API-интерфейсы NPrinting могут экспортировать все шаблоны отчетов Excel, содержащиеся в приложении NPrinting. Также можно выбрать для экспорта лишь некоторые отчеты.

Спецификация API

Полная спецификация приводится в файлах nprinting-api-yaml или nprinting-api.json.

Основные особенности

/apps/{id}/actions/export-templates: post: tags: - ApiApps parameters: - name: id in: path required: true type: string format: uuid - name: request in: body required: true schema: $ref: '#/definitions/AppExportTemplates' responses: '200': description: OK schema: type: object AppExportTemplates: required: - connectionsMap type: object properties: connectionsMap: type: object additionalProperties: type: string type: enum: - Excel type: string reports: type: array items: format: uuid type: string example: 00000000-0000-0000-0000-000000000000

connectionsMap можно использовать для сопоставления подключений, когда приложение NPrinting использует несколько подключений.

Конечный архив ZIP будет содержать шаблоны отчетов, организованные в отдельных вложенных папках для каждого подключения Qlik Sense.

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

Пример использования

В следующем примере используется функция JavaScript Fetch для загрузки только одного конкретного отчета, который использует подключение Qlik NPrinting.

fetch("https://your-nprinting.server:4993/api/v1/apps/977bf78f-4c72-412d-bb26-cd4fc0ec1596/actions/export-templates", { "headers": { "accept": "application/json, text/plain, */*, application/x-zip-compressed", "accept-language": "en-US,en;q=0.9,it;q=0.8", "cache-control": "no-cache", "content-type": "application/json;charset=UTF-8", "pragma": "no-cache", "sec-ch-ua": "\"Not.A/Brand\";v=\"8\", \"Chromium\";v=\"114\", \"Google Chrome\";v=\"114\"", "sec-ch-ua-mobile": "?0", "sec-ch-ua-platform": "\"Windows\"", "sec-fetch-dest": "empty", "sec-fetch-mode": "cors", "sec-fetch-site": "same-origin", "x-xsrf-token": "YPUrvy9ybRUFkF+L+ga4lt9e8WIcCZV0y8dO5YG/tO8=" }, "referrer": "https://your-nprinting.server:4993", "referrerPolicy": "strict-origin-when-cross-origin", "body": "{\"connectionsMap\":{\"86a10bf3-aab4-4ebd-949f-f99cffaaa328\":\"https://your-cloud-tenant.qlikcloud.com/sense/app/a18e00a1-5bb0-4302-a759-f4967ab47aec\"}, \"reports\":[\"fd4f037c-a2f7-44e6-ae90-4dd76a92386c\"]}", "method": "POST", "mode": "cors", "credentials": "include" }). then(response => response.blob()) .then(blob => { var url = window.URL.createObjectURL(blob); var a = document.createElement('a'); a.href = url; a.download = "exported-templates-nprinting.zip"; document.body.appendChild(a); // we need to append the element to the dom -> otherwise it will not work in firefox a.click(); a.remove(); //afterwards we remove the element again });

Раздел Request URL и bodyвызова можно модифицировать, чтобы изменить поведение экспорта.

В данном примере:

  • Архив ZIP ― exported-templates-nprinting.zip

  • Приложение NPrinting ― 977bf78f-4c72-412d-bb26-cd4fc0ec1596

  • Подключение Qlik Sense86a10bf3-aab4-4ebd-949f-f99cffaaa328

  • Приложение Qlik Sense развернуто в Qlik Cloud по адресу: https://your-cloud-tenant.qlikcloud.com/sense/app/a18e00a1-5bb0-4302-a759-f4967ab47aec

  • Архив ZIP будет содержать только один выбранный шаблон отчета: fd4f037c-a2f7-44e6-ae90-4dd76a92386c. Все остальные отчеты, использующие подключение, не экспортируются.

Использование отчетов Excel с надстройкой Qlik для Microsoft Excel

Отчеты, экспортированные из Qlik NPrinting, можно использовать вместе с надстройкой Qlik для Microsoft Excel. Для получения дополнительной информации о надстройке Qlik для Microsoft Excel см. раздел Создание шаблонов отчета с помощью надстройки Qlik для Microsoft Excel.

  1. Извлеките файлы Excel из архива ZIP.

  2. Откройте файлы в Excel 365 (локальная или веб-версия).

  3. Загрузите надстройку Qlik для Microsoft Excel.

  4. После выполнения входа откроется диалоговое окно Выполняется миграция.

  5. По окончании миграции может появиться сообщение со списком объектов, не поддерживаемых в Qlik Cloud:

  6. Если имеются неподдерживаемые объекты, есть два варианта действий:

    1. Можно оставить шаблон отчета как есть, пока новые элементы не будут реализованы в отчетности Qlik Cloud. Теги отчета для неподдерживаемых элементов не будут удалены и не будут учитываться при публикации отчета в Qlik Cloud.

    2. Теги можно удалить.

      1. Выберите теги для неподдерживаемых элементов Excel.

      2. Уберите тег, удалив содержимое ячейки.

      3. Для страниц: измените имя листа, чтобы удалить соответствующий тег.

Использование PixelPerfect отчетов в вашем Qlik Cloud клиенте

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

  1. Извлеките файлы QPXP из архива ZIP.

  2. Получите доступ к вашему Qlik Sense приложению в вашем Qlik Cloud клиенте и загрузите свой шаблон в приложение. См. Загрузка шаблона отчета для получения подробной информации.

  3. Отредактируйте загруженный шаблон в интерфейсе Qlik Cloud. См. Разработка шаблонов отчетов PixelPerfect для получения подробной информации.

Поддерживаемые и неподдерживаемые элементы в Qlik Cloud

В следующей таблице перечислены поддерживаемые и неподдерживаемые элементы шаблонов Qlik NPrinting Excel в Qlik Cloud. Кроме того, Qlik Cloud не поддерживает шаблоны, подключенные к нескольким приложениям.

Поддержка элементов
Признак Поддержка Примечания

Изображение

Да

Фильтры не поддерживаются в Qlik Cloud

Лист как изображение

Нет

 

Таблица

Да

 

Столбец

Да

 

Формула

Да

 

Переменная

Да

 

Удалить строку

Да

Применимо только в шаблонах Excel

Ячейка

Нет

 

Уровень

Да

 

Страница

Да

Применимо только в шаблонах Excel

Фильтры объектов

Нет

Отчет можно экспортировать, но нельзя применить фильтр.

Расширения сторонних поставщиков

Нет

Ни как изображение, ни как таблица.

Известные проблемы

Когда файл Excel открывается в веб-версии Excel 365, статические изображения в шаблоне могут отсутствовать. Переключите вид Редактирование/Просмотр на ленте Excel, чтобы восстановить видимость.

Visit the discussion forum at community.qlik.com

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

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