ビジュアライゼーション エクステンションのアップロードと管理
拡張機能は、Qlik Sense アプリのカスタム ビジュアライゼーションを有効にすることで、Qlik Cloud 分析プラットフォームの機能を拡張します。Administration アクティビティ センターから拡張をアップロードおよび編集できます。
拡張の作成とアップロードに関するガイドライン
ビジュアライゼーション拡張を作成して Qlik Cloud にアップロードする場合は、次のガイドラインに従ってください。
拡張の追加と使用に関するビジュアル デモについては、「Qlik Cloud におけるサードパーティのビジュアライゼーション エクステンションの使用」および「拡張と API キー」を参照してください。
ZIP ファイルの拡張子の制限事項
-
最大 ZIP ファイル サイズ: 30MB
-
ZIP ファイルの最大ファイル サイズ: 30 MB
-
ZIP の最大ファイル数: 500
-
ZIP ファイルの非圧縮合計ファイル サイズの最大値: 100 MB
ベスト プラクティス
-
コードファイルを縮小します。
-
必要なファイルのみを含めます。拡張機能が正しく機能するために、必要なファイルのみが ZIP ファイルに含まれていることを確認してください。
-
アップロードする前に、拡張とそのコードを確認してください。詳細については、「ビジュアライゼーション エクステンション (英語のみ)」を参照してください。
拡張に必要な基本ファイル
拡張 ZIP ファイルに次の必須ファイルが含まれていることを確認してください。
-
.qext: 拡張メタデータファイル
-
.js: 拡張の JavaScript コード
-
.html: 拡張をレンダリングするための HTML コード
-
.css: 拡張のスタイルを設定するためのカスタム CSS
画像ファイルの外部ホスティング
拡張 ZIP ファイル内に画像ファイル (GIF、PNG、JPG など) をアップロードしないでください。代わりに、個人用アプリケーション サーバー、S3 バケット、またはパブリック コンテンツ管理システムで外部的にホストします。拡張コードでこれらの外部画像を参照します。
外部コード ファイルとコンテンツの参照
プライマリ拡張コード内のコード ファイルとコンテンツを参照できますが、そのためにはテナントにコンテンツ セキュリティ ポリシー (CSP) を実装する必要があります。詳細については、「Content Security Policy (CSP) の管理」を参照してください。
拡張が外部リソースにリクエストを行う場合、それらのリソースのオリジンは CSP で許可リストに登録されている必要があります。登録されていない場合は、拡張のレンダリングがブロックされます。
サポートされていない機能
次の機能はサポートされていません。
バンドルされた拡張
Qlik Cloud は、他の拡張 ZIP ファイルを含む ZIP ファイルをサポートしていません。
QVF ファイルと QVD ファイル
Qlik Sense QVF ファイルまたは QVD ファイルは拡張サービスからアクセスできないため、拡張 ZIP ファイルに含めないでください。拡張をアップロードする前に、これらのファイルを削除します。
QVF ファイルまたは QVD ファイルを Qlik Cloud テナントにアップロードするには、次のいずれかの方法を使用します。
-
Analytics アクティビティ センターの [作成] ページでアプリをアップロードします。
-
qlik-cli を使用してアプリをアップロードします。
-
Analytics アクティビティ センターの [作成] ページで QVD をアップロードします。
-
Qlik DataTransfer を使用してQVD をアップロードします。
未対応ファイル形式
セキュリティ上の理由から、拡張には許可されていない MIME タイプのファイルを含めることはできません。MIME タイプ (Multipurpose Internet Mail Extensions) は、ファイルの性質と形式を示す標準的な方法です。拡張に実行可能ファイルや ZIP ファイルなどが含まれている場合、アップロードは失敗します。
次の MIME タイプは許可されません。
- 'application/octet-stream'
- 'application/x-coredump'
- 'application/x-dosexec'
- 'application/x-executable'
- 'application/x-java-applet'
- 'application/x-object'
- 'application/x-sharedlib'
- 'application/zip'
- 'text/x-shellscript'
- 'text/x-awk'
- 'text/x-gawk'
- 'text/x-msdos-batch'
- 'text/x-nawk'
- 'text/x-php'
拡張内のすべてのファイルには、ファイル名とファイル拡張子の両方が必要です。条件を満たさないファイルは無視されます。無視されるファイルの例: .gitignore および README。
拡張の追加と管理
拡張は、Administration アクティビティ センターの拡張ページで管理されます。
拡張テーブル内:
-
名前は、QEXT ファイル内のメタデータ名を参照します。
-
QEXT バージョンは、QEXT ファイル内のメタデータ バージョンを示します。
-
QEXT ファイル名は、拡張定義ファイルの一意の識別子と名前です。
拡張をタグでフィルタリングできます。
新しい拡張の追加
次の手順を実行します。
- Administration アクティビティ センターで、 [拡張] に移動します。
-
[追加] をクリックします。
-
[参照] をクリックし、拡張ファイルを選択するか、指定されたエリアにファイルをドロップします。
-
任意でタグを追加します。
-
[公開] をクリックします。
拡張の編集
次の手順を実行します。
- Administration アクティビティ センターで、 [拡張] に移動します。
-
編集する拡張で
をクリックし、 [編集] を選択します。既存のエクステンションを置き換える場合のオプション、およびタグを追加または削除する場合のオプションョンと一緒に編集パネルが表示されます。
-
変更を保存します。
拡張の削除
拡張を削除すると、すべてのリソースに影響し、テナント内のすべてのユーザーに影響する可能性があります。
次の手順を実行します。
- Administration アクティビティ センターで、 [拡張] に移動します。
- 削除する拡張を選択します。
- [削除] をクリックします。