# Экспорт шаблонов отчетов из 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 IR: поддержка экспорта шаблонов Excel и PixelPerfect

* Qlik NPrinting февраля 2025 SR3: поддержка экспорта шаблонов Excel, PixelPerfect и HTML

* Qlik NPrinting Май 2026: поддержка экспорта шаблонов Excel, PixelPerfect, HTML, Word и PowerPoint.

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

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

* В Веб-консоль Qlik NPrinting: Вы можете экспортировать все Excel, PixelPerfect, HTML, Word и PowerPoint шаблоны отчетов, связанные с определенным приложением Qlik Sense.

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

[Посмотреть видеоролик](https://play.vidyard.com/4Jz8WsRBYYNfUaotMEcWoy)

## Предварительные требования

Для миграции шаблон отчета из Qlik NPrinting в Qlik Cloud вам потребуется:

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

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

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

  * было перенесено в клиент Qlik Cloud. Вам понадобится новый URL-адрес приложения. Для получения информации о миграции Qlik Sense приложений, см. в [Инструмент миграции аналитики Qlik обзоре](https://help.qlik.com/ru-RU/migration/Subsystems/AnalyticsMigrationTool/Content/Qlik-Analytics-Migration-Tool-Overview.htm).

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

* Один или несколько Qlik NPrinting шаблонов отчетов в формате Excel, Word, PowerPoint, PixelPerfect или HTML, содержащих объекты из Qlik NPrinting подключения к Qlik Sense под управлением клиента. Отчеты, содержащие неподдерживаемую функциональность, не будут добавлены в экспортируемый файл. Чтобы экспортировать шаблон, необходимо отредактировать его в Qlik NPrinting и удалить неподдерживаемую функциональность. Следующие отчеты не поддерживаются:

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

  * Отчеты, связанные с несколькими Qlik Sense приложениями.

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

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

Qlik NPrinting поддерживает форматы Office, содержащие макросы (XLSM, DOCM, PPTM), в качестве файлов шаблонов через пользовательские шаблоны. Все шаблоны будут преобразованы в форматы, не поддерживающие макросы (XLSX, DOCX, PPTX), чтобы их можно было импортировать в Qlik Cloud.

Примечание к предупреждениюПо соображениям безопасности файлы Office с макросами (XLSM, DOCM, PPTM) будут преобразованы в XLSX, DOCX или PPTX, а макросы будут удалены.

Qlik NPrinting февраля 2024: позволяет экспортировать только файлы шаблонов Excel. Qlik NPrinting февраля 2025: добавлен экспорт файлов Excel и PixelPerfect. Qlik NPrinting Февраль 2025 добавляет экспорт HTML-файлов. Qlik NPrinting Май 2026 добавляет экспорт файлов Word и PowerPoint.

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

Примечание к информацииПри загрузке файлов шаблонов в Qlik Cloud будет производиться санитарная очистка шаблонов HTML. В целях безопасности удаляются или изменяются скрипты, элементы SVG и элементы стилей. Необходимо проверить содержимое HTML-файла после загрузки, используя редактор, интегрированный в интерфейс Qlik Cloud.

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

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

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

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

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

   ![](https://help.qlik.com/ru-RU/migration/Content/Resources/Images/ui_export-qcs-template-nprinting.png)

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

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

5. Щелкните Загрузить.

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

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

* Подпапка, содержащая все экспортированные шаблоны отчетов в формате XLSX (Qlik NPrinting февраль 2024) или все шаблоны в форматах XLSX и QPXP (Qlik NPrinting февраль 2025), или в форматах XLSX, QPXP и QHTML (Qlik NPrinting февраль 2025 SR3), или в форматах XLSX, QPXP, QHTML, DOCX, PPTX (Qlik NPrinting май 2026).

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

Экспортированные файлы могут содержать элементы отчетов, не поддерживаемые в отчетности Qlik Cloud. Информацию о совместимости отчетов с функциями Qlik Cloud см.:

[Использование отчетов в Excel, Word, или PowerPoint с помощью надстроек Qlik для Microsoft Office](https://help.qlik.com/ru-RU/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using)

[Использование PixelPerfect отчетов в вашем Qlik Cloud клиенте](https://help.qlik.com/ru-RU/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using2)

[Использование отчетов HTML в клиенте Qlik Cloud](https://help.qlik.com/ru-RU/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using3)

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

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

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

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

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

```

/applications/{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 Sense ― 86a10bf3-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, Word, или PowerPoint с помощью надстроек Qlik для Microsoft Office

Отчеты, экспортированные из Qlik NPrinting, могут использоваться совместно с Qlik надстройками для Microsoft Office. Дополнительные сведения о надстройках Qlik для Microsoft Office см. [Создание шаблонов отчетов с помощью Qlik надстройки для Microsoft Office](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/excel-add-in-overview.htm).

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

1. Извлеките файлы из ZIP-файла.

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

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

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

   ![](https://help.qlik.com/ru-RU/migration/Content/Resources/Images/ui_export-qcs-template-nprinting-migration-progress.png)

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

   ![](https://help.qlik.com/ru-RU/migration/Content/Resources/Images/ui_export-qcs-template-nprinting-unsupported-tags.png)

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

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

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

      1. 

      2. Выберите теги для неподдерживаемых функций в Excel листе, Word документе или PowerPoint презентации.

      3. Выберите Удалить на панели свойств надстройки Office; Это также удалит соответствующий тег в вашем документе Office

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

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

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

2. Получите доступ к вашему Qlik Sense приложению на вашем Qlik Cloud клиенте и загрузите ваш шаблон в приложение. См. [Загрузка шаблона отчета](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/cloud-in-app-reports-templates.htm#UploadTemplate) для получения подробной информации.

3. Отредактируйте загруженный шаблон в интерфейсе Qlik Cloud. См. [Разработка шаблонов отчетов PixelPerfect](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/design-pixelperfect-templates.htm) для получения подробной информации.

## Использование отчетов HTML в клиенте Qlik Cloud

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

1. Извлеките файлы QHTML из файла ZIP.

2. Получите доступ к приложению Qlik Sense в вашем клиенте Qlik Cloud и загрузите свой шаблон в приложение. См. [Загрузка шаблона отчета](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/cloud-in-app-reports-templates.htm#UploadTemplate) для получения подробной информации.

3. Отредактируйте загруженный шаблон в интерфейсе Qlik Cloud. См. [Разработка шаблонов отчетов PixelPerfect](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/design-html-reports.htm) для получения подробной информации.

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

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

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

Поддержка элементов

| Функция | Поддержка | Примечания |
| --- | --- | --- |
| Изображение | Да | Фильтры не поддерживаются в Qlik Cloud |
| Лист как изображение | Нет |  |
| Таблица | Да |  |
| Столбец | Да |  |
| Формула | Да |  |
| Переменная | Да |  |
| Удалить строку | Да | Применимо только в шаблонах Excel |
| Ячейка | Нет |  |
| Уровень | Да |  |
| Страница | Да | Применимо только в шаблонах Excel |
| Фильтры объектов | Да | Поддерживается для фильтрации на уровне объектов в перенесенных шаблонах. Проверьте сопоставления объектов после миграции или замены приложения, чтобы обеспечить ожидаемый результат. |
| Расширения сторонних поставщиков | Нет | Ни как изображение, ни как таблица. |

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

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