Qlik NPrinting から Qlik Cloud への Excel レポートテンプレートのエクスポート

Qlik NPrinting エクスポート機能は、Qlik Sense Enterprise on Windows アプリに接続されている Excel レポートテンプレートを変換します。この変換されたレポート形式は、Qlik Sense アプリとともに Qlik Cloud にインポートできます。移行されたレポートテンプレートは、Microsoft Excel の Qlik アドインで編集し、Qlik Cloud を使用して配布できます。

ユーザーは、次の Excel テンプレートをエクスポートできます。

Qlik NPrinting ウェブコンソールにて: 特定の Qlik Sense アプリに接続されているすべての Excel レポートテンプレートをエクスポートできます。
NPrinting API の使用: Qlik NPrinting アプリ内のすべてのレポートをエクスポートするか、特定のレポートをエクスポートするかを選択できます。

前提条件

レポートテンプレートを Qlik NPrinting から Qlik Cloud に移行するには、次が必要です。

レポートのエクスポート権限を持つユーザーによる Qlik NPrinting ウェブコンソールへのアクセス。
次の Qlik Sense アプリ。
- もともと Qlik Sense Client-Managed で作成され、Qlik NPrinting に接続されているアプリ。
- Qlik Cloud テナントに移行されたアプリ。アプリの新しい URL が必要になります。Qlik Sense アプリの移行については、「アプリの移行」を参照してください。
  
  情報メモQlik Sense アプリが Qlik Cloud にアップロードされたら、Qlik Sense Client-Managed にあるバージョンは編集しないでください。アプリの一方のバージョンに加えた変更は、もう一方のバージョンには反映されません。
Qlik NPrinting 接続から Qlik Sense Client-Managed へのオブジェクトを含む 1 つ以上の Qlik NPrinting Excel レポートテンプレート。次はサポートされていません。
- QlikView ドキュメントに接続されたレポート。
- 複数の Qlik Sense アプリに接続されたレポート。

エクスポートされたレポートファイルには、Qlik NPrinting のテンプレートファイルの設定が含まれます。動的命名、サイクル化、フィルターなどの Qlik NPrinting レポート設定は、Qlik Cloud ではインポートされません。

Qlik NPrinting テンプレート形式のサポート

Qlik NPrinting は、カスタムテンプレートを介して、XLS、XLSX、XLSM ファイルをテンプレートファイルとしてサポートします。すべてのテンプレートは XLSX 形式に変換され、Qlik Cloud にインポートできるようになります。

セキュリティ上の理由から、マクロを含む Excel ファイル (XLSM) は XLSX に変換され、マクロは削除されます。

ウェブコンソールでのレポートのエクスポート

Qlik NPrinting ウェブコンソールは、特定の Qlik NPrinting 接続を使用するすべての Excel レポートを単一の Qlik Sense アプリにエクスポートできます。

次の手順を実行します。

Qlik NPrinting にログインします。
上部のメニューから、 [管理者] > [Export QCS templates] (QCS テンプレートをエクスポート) を選択します。
ドロップダウンを使用して、Qlik NPrinting アプリと Qlik Sense 接続を選択します。
必要な Qlik Sense アプリの URL を Qlik Cloud に入力します。URL の末尾の「/」を削除します。
[ダウンロード] をクリックします。

ブラウザによって、次を含む ZIP ファイルがダウンロードされます。

有益なエラーメッセージが含まれるログファイル。
XLSX 形式でエクスポートされたすべてのレポートテンプレートを含むサブフォルダー。

エクスポートされたファイルには、Qlik Cloud レポートでサポートされていないレポート機能が含まれている場合があります。現在の Qlik Cloud 機能に照らしてレポートを検証するには、Microsoft Excel 用 Qlik アドインによる Excel でのレポートの使用 を参照してください。

API を使用したレポートのエクスポート

NPrinting API は、NPrinting アプリに含まれるすべての Excel レポートテンプレートをエクスポートできます。特定のレポートを選択してエクスポートすることもできます。

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

NPrinting アプリに複数の接続がある場合、connectionsMap を使用して接続マッピングを提供できます。

作成された ZIP ファイルには、異なる Qlik Sense 接続ごとにサブフォルダーで整理されたレポートテンプレートが含まれます。

reports を使用して、エクスポートする必要がある Qlik NPrinting レポート ID のリストを提供できます。特定の接続で動作するレポートのサブセットのみをエクスポートする必要がある場合は、リストを提供します。

使用例

次の例では、JavaScript Fetch 関数を使用して、Qlik NPrinting 接続に添付された特定のレポートを 1 つだけダウンロードします。

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 が 1 つだけ含まれます。接続に添付されている他のすべてのレポートはエクスポートされません。

Microsoft Excel 用 Qlik アドインによる Excel でのレポートの使用

Qlik NPrinting からエクスポートされたレポートは、Microsoft Excel 用の Qlik アドインと組み合わせて使用できます。Microsoft Excel 用の Qlik アドインの詳細については、「Microsoft Excel 用の Qlik アドインを使用したレポートテンプレートの構築」を参照してください。

次の手順を実行します。

ZIP ファイルから Excel ファイルを抽出します。
Excel 365 ウェブまたはデスクトップでファイルを開きます。
Microsoft Excel 用の Qlik アドインをロードします。
ログイン後に、 [移行が進行中です] というダイアログが開きます。
移行後に、Qlik Cloud でサポートされていないオブジェクトのリストが表示される場合があります。
サポートされていないオブジェクトがある場合、次の 2 つのオプションがあります。
1. Qlik Cloud レポートに新しい機能が実装されるまで、レポートテンプレートをそのままにしておくことができます。サポートされていない機能のレポートタグは削除されず、レポートが Qlik Cloud で公開されても影響はありません。
2. タグは次のようにして削除できます。
  1. Excel シートでサポートされていない機能のタグを選択します。
  2. セルの内容を削除して、タグを削除します。
  3. ページの場合は、シート名を編集して対応するタグを削除します。

Qlik Cloud でサポートされている機能とサポートされていない機能

次の表は、Qlik Cloud でサポートされている Qlik NPrinting Excel テンプレート機能とサポートされていないテンプレート機能の概要を示しています。さらに、複数のアプリに接続されたテンプレートは Qlik Cloud ではサポートされていません。

機能のサポート
機能	サポート	メモ
画像	はい	フィルターパネルは Qlik Cloud ではサポートされていません
画像としてのシート	いいえ
テーブル	はい
列	はい
数式	はい
変数	はい
行を削除	はい
セル	いいえ
レベル	はい
ページ	はい
オブジェクトフィルター	いいえ	レポートはエクスポートできますが、フィルターは適用されません。
サードパーティの拡張機能	いいえ	画像とテーブルもサポートしていません。

既知の問題

Excel 365 ウェブバージョンで Excel ファイルを開くと、テンプレート内の静止画像が表示されない場合があります。Excel のリボンで [編集]/[表示] ビューを切り替えると、画像の表示が復元されます。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください

Qlik NPrinting から Qlik Cloud への Excel レポート テンプレートのエクスポート