# 將報告範本從 Qlik NPrinting 匯出至 Qlik Cloud Qlik NPrinting 匯出功能，特性 會轉換您已連接至 Qlik Sense Enterprise on Windows 應用程式的報表範本。此轉換後的報告格式可以匯入到 Qlik Cloud，連同您的 Qlik Sense 應用程式。 下列 Qlik NPrinting 版本支援匯出報告以用於 Qlik Cloud： * Qlik NPrinting 2024 年 2 月：支援匯出 Excel 範本 * Qlik NPrinting 2025 年 2 月 IR：支援匯出 Excel 和 PixelPerfect 範本 * Qlik NPrinting 2025 年 2 月 SR3：支援匯出 Excel、PixelPerfect 和 HTML 範本 * Qlik NPrinting 2026 年 5 月：支援匯出 Excel、PixelPerfect、HTML、Word 和 PowerPoint 範本。 已遷移的 Excel、Word 和 PowerPoint 報表範本可以在 Microsoft Excel 的 Qlik 增益集中編輯，並使用 Qlik Cloud 進行分發。已遷移的 PixelPerfect 和 HTML 報告範本可以在 Qlik Cloud 介面中編輯，並使用 Qlik Cloud 發佈。 使用者可以匯出 範本： * 在 Qlik NPrinting web 主控台 中：您可以匯出所有連接到特定 Qlik Sense 應用程式的 Excel、PixelPerfect、HTML、Word 和 PowerPoint 報表範本。 * 使用 NPrinting API：您可以選擇匯出 Qlik NPrinting 應用程式中的所有報告或特定選項。 [檢視影片剪輯](https://play.vidyard.com/4Jz8WsRBYYNfUaotMEcWoy) ## 必要條件 若要將報告範本從 Qlik NPrinting 遷移至 Qlik Cloud，您將需要： * 透過具有匯出報告權限的使用者存取 Qlik NPrinting web 主控台。 * 一個 Qlik Sense 應用程式，它： * 原本在 Qlik Sense 用戶端管理 中建立且連線至 Qlik NPrinting。 * 已遷移至 Qlik Cloud 租用戶。您將需要應用程式的新 URL。如需有關移轉 Qlik Sense 應用程式的資訊，請參閱 [Qlik 分析遷移工具 概述](https://help.qlik.com/zh-TW/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 Cloud 不會匯入動態命名、循環和篩選等 Qlik NPrinting 報告設定。 ### Qlik NPrinting 範本格式支援 Qlik NPrinting 支援包含巨集 (XLSM、DOCM、PPTM) 的 Office 格式，並可透過自訂範本將其作為範本檔案。所有範本將會轉換為不支援巨集的格式 (XLSX、DOCX、PPTX)，因此可匯入至 Qlik Cloud。 警告備註為了安全考量，含有巨集的 Office 檔案 (XLSM、DOCM、PPTM) 將會轉換為 XLSX、DOCX 或 PPTX，且巨集將會被移除。 Qlik NPrinting 2024 年 2 月僅匯出 Excel 範本檔案。Qlik NPrinting 2025 年 2 月匯出 Excel 和 PixelPerfect 檔案。Qlik NPrinting 2025 年 2 月新增匯出 HTML 檔案的功能。 Qlik NPrinting 2026 年 5 月 新增 Word 和 PowerPoint 檔案的匯出。 基於安全性考量，如果 PixelPerfect 範本包含指令碼，則當範本上傳至 Qlik Cloud 時，這些指令碼將會被移除。指令碼功能將不再可用。 資訊備註將範本檔案上傳至 Qlik Cloud 時，HTML 範本將會經過清理。基於安全性考量，將會移除或修改指令碼、SVG 元素和樣式元素。請務必在上傳後，使用整合在 Qlik Cloud 介面中的編輯器來驗證 HTML 內容。 ## 在 Web 主控台中匯出報告 Qlik NPrinting web 主控台 可以將所有使用特定 Qlik NPrinting 連線 的 Excel 和 PixelPerfect 報告匯出到單一 Qlik Sense 應用程式。 請執行下列動作： 1. 登入 Qlik NPrinting。 2. 從頂端功能表，選取管理員 > 匯出 QCS 範本。 ![](https://help.qlik.com/zh-TW/migration/Content/Resources/Images/ui_export-qcs-template-nprinting.png) 3. 使用下拉式清單選取 Qlik NPrinting 應用程式和 Qlik Sense 連線。 4. 在 Qlik Cloud 中，輸入所需 Qlik Sense 應用程式的網址。移除 URL 中結尾的任何 /。 5. 按一下下載。 瀏覽器將會下載包含以下內容的 ZIP 檔案： * 具有資訊性錯誤訊息的記錄檔。 * 一個子資料夾，其中包含所有匯出的報表範本，格式為 XLSX (Qlik NPrinting 2024 年 2 月)；或所有 XLSX 和 QPXP 格式的範本 (Qlik NPrinting 2025 年 2 月)；或 XLSX、QPXP 和 QHTML 格式的範本 (Qlik NPrinting 2025 年 2 月 SR3)；或 XLSX、QPXP、QHTML、DOCX、PPTX 格式的範本 (Qlik NPrinting 2026 年 5 月)。 資訊備註 匯出的檔案可能包含 Qlik Cloud 報告中不支援的報告功能。若要針對目前的 Qlik Cloud 功能驗證報告，請參閱： [使用 報告於 Excel、Word 或 PowerPoint，搭配適用於 Microsoft Office 的 Qlik 增益集](https://help.qlik.com/zh-TW/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using) [在您的 Qlik Cloud 租用戶中使用 PixelPerfect 報告](https://help.qlik.com/zh-TW/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using2) [在您的 Qlik Cloud 租用戶中使用 HTML 報告](https://help.qlik.com/zh-TW/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using3) ## 使用 API 匯出報告 NPrinting API 可以匯出 NPrinting 應用程式中包含的所有 Excel、PixelPerfect 和 HTML 報告範本。您也可以選擇匯出特定選取的報告。 ### 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 報告 ID 清單。若您只需要匯出在指定連線運作的報告子集，請提供清單。 ### 使用範例 以下範例使用 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 應用程式已透過 https://your-cloud-tenant.qlikcloud.com/sense/app/a18e00a1-5bb0-4302-a759-f4967ab47aec 部署至 Qlik Cloud * ZIP 檔案只會包含一個選取的報告範本：fd4f037c-a2f7-44e6-ae90-4dd76a92386c。不會匯出附加至連線的所有其他報告。 ## 使用 報告於 Excel、Word 或 PowerPoint，搭配適用於 Microsoft Office 的 Qlik 增益集 從 Qlik NPrinting 匯出的報告可用於與 Microsoft Office 的 Qlik 增益集結合。如需深入了解適用於 Microsoft Office 的 Qlik 增益集，請參閱[使用Qlik增益集建置報表範本，適用於Microsoft Office](https://help.qlik.com/zh-TW/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/zh-TW/migration/Content/Resources/Images/ui_export-qcs-template-nprinting-migration-progress.png) 5. 遷移後，可能會出現訊息，內含 Qlik Cloud 不支援的物件清單： ![](https://help.qlik.com/zh-TW/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 文件中對應的標籤 ## 在您的 Qlik Cloud 租用戶中使用 PixelPerfect 報告 請執行下列動作： 1. 從 ZIP 檔案解壓縮 QPXP 檔案。 2. 在您的Qlik Cloud租用戶上存取您的Qlik Sense應用程式，並將您的範本上傳至該應用程式。請參閱[上傳報告範本](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/cloud-in-app-reports-templates.htm#UploadTemplate)以取得詳細資訊。 3. 在您的 Qlik Cloud 介面中編輯上傳的範本。如需詳細資訊，請參閱 [設計 PixelPerfect 報告範本](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/design-pixelperfect-templates.htm)。 ## 在您的 Qlik Cloud 租用戶中使用 HTML 報告 請執行下列動作： 1. 從 ZIP 檔案解壓縮 QHTML 檔案。 2. 在您的 Qlik Cloud 租用戶上存取您的 Qlik Sense 應用程式，並將您的範本上傳至該應用程式。請參閱[上傳報告範本](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/cloud-in-app-reports-templates.htm#UploadTemplate)以取得詳細資訊。 3. 在您的 Qlik Cloud 介面中編輯上傳的範本。如需詳細資訊，請參閱 [設計 PixelPerfect 報告範本](https://help.qlik.com/zh-TW/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 365 網頁版開啟 Excel 檔案時，可能不會顯示範本中的靜態影像。在 Excel 功能區中切換編輯/檢視檢視畫面將會還原影像可見性。