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

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

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

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

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

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

Условия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Веб-консоль Веб-консоль Qlik NPrinting позволяет экспортировать все отчеты Excel, которые используют конкретное подключение 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 Cloud. Чтобы проверить отчеты на соответствие текущим элементам Qlik Cloud, см. раздел Использование отчетов Excel с надстройкой Qlik для Microsoft Excel.

Экспорт отчетов с помощью 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. Для страниц: измените имя листа, чтобы удалить соответствующий тег.

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

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

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

Изображение

Да

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

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

Нет

 

Таблица

Да

 

Столбец

Да

 

Формула

Да

 

Переменная

Да

 

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

Да

 

Ячейка

Нет

 

Уровень

Да

 

Страница

Да

 

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

Нет

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

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

Нет

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

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

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

Visit the discussion forum at community.qlik.com

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

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