ビジュアライゼーション エクステンションのアップロードと管理
拡張機能により、Qlik Cloud アプリケーションに独自のビジュアライゼーション機能を追加できます。拡張機能のアップロードおよび管理は、管理 アクティビティ センターで実行します。
拡張機能の使用
Qlik Cloud のビジュアライゼーション エクステンションは、標準で用意されているビジュアライゼーションに加え、新たな視覚的コンポーネントを提供します。これらを活用することで、データの表示方法や探索方法をカスタマイズできます。
詳細については、「Qlik 開発者: Qlik の拡張」を参照してください。ビジュアル デモについては、「Qlik Cloud におけるサードパーティのビジュアライゼーション エクステンションの使用」および「拡張および API キー」を参照してください。
必要なロール
拡張機能をアップロードおよび管理するには、次のいずれかのロールが必要です。
-
テナント管理者
-
Analytics 管理者
-
[拡張を管理] の権限が [許可] に設定されているカスタム ロール。
ファイルの要件と制限
拡張が正しくアップロードされ、正常に動作するように、次のルールに従ってください。
ファイル制限
拡張の ZIP ファイルには、次の制限があります。
-
最大 ZIP ファイル サイズ: 30MB
-
ZIP 内の単一ファイルの最大サイズ: 30 MB
-
ZIP 内のファイルの最大数: 500
-
解凍後の合計最大サイズ: 100 MB
拡張に必要な基本ファイル
拡張 ZIP ファイルに次のファイルが含まれていることを確認してください。
-
.qext: メタデータ ファイル
-
.js: JavaScript コード
-
.html: HTML レンダリング コード
-
.css: カスタム スタイル
ファイルの命名規則
拡張内の各ファイルには、ファイル名および拡張が必要です。これらの規則に準拠しないファイルは無視されます。無視されるファイルの例: .gitignore および README。
ベスト プラクティス
-
コードファイルを縮小します。
-
拡張機能の実行に必要なファイルのみを含めます。
-
アップロードする前に、拡張とそのコードを確認してください。
外部リソースと CSP
画像ファイルを外部でホストする
拡張 ZIP ファイル内に画像ファイル (GIF、PNG、JPG など) を含めないでください。代わりに、画像を外部 (例: アプリケーションサーバー、S3 バケット、パブリック コンテンツ管理システム) でホストし、拡張コードからそれらを参照します。
外部コードとコンテンツの参照
拡張で外部コードまたはコンテンツを参照するには、テナントのコンテンツ セキュリティポリシー (CSP) を構成し、拡張がアクセスする必要がある外部オリジンを許可リストに追加します。
オリジンが許可リストに登録されていない場合、拡張はレンダリングされません。
詳細については、「Content Security Policy (コンテンツ セキュリティ ポリシー) (CSP) の管理」を参照してください。
未対応ファイル形式
セキュリティ上の理由から、拡張には許可されていない MIME タイプのファイルを含めることはできません。MIME タイプ (Multipurpose Internet Mail Extensions) は、ファイルの形式を示します。拡張に許可されていない MIME タイプ (例: 実行ファイルや 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'
サポートされていない機能
次の機能はサポートされていません。
-
バンドル エクステンション (ZIP ファイルとして他の拡張を含む ZIP ファイル) はサポートされていません。
-
QVF および QVD ファイル: これらのファイルは拡張サービスからアクセスできません。
QVF ファイルまたは QVD ファイルをアップロードするには、次のいずれかの方法を使用します。
-
分析 アクティビティ センターの [作成] ページからアプリケーションをアップロードします。
-
qlik-cli を使用してアプリケーションをアップロードします。
-
分析 アクティビティ センターの [作成] ページから QVD をアップロードします。
-
Qlik DataTransfer を使用してQVD をアップロードします。
エクステンションの管理
拡張は、管理 アクティビティ センターの [拡張] ページで管理されます。
拡張テーブル情報
-
名前: QEXT ファイルのメタデータ名
-
QEXT バージョン: メタデータ バージョン
-
QEXT ファイル名: 拡張定義ファイルの一意の識別子
-
ステータス: 移行ステータス (一時的)
移行ステータスについて
Qlik は、プラットフォームでの拡張の処理方法の改善を進めています。この移行期間中、既存の拡張は新しいサービスに移動されます。移行ステータス列は一時的なものであり、この作業が進行中にのみ表示されます。
2025-11-17 以降、アップロードまたはアクセスするすべての拡張は自動的に新しいサービスを使用します。現在その拡張が通常どおり使用されている場合、アクションは不要です。
ほとんどの拡張は、使用されたときに自動的に移行されます。最近使用していない拡張は、スケジュールされた移行の実行に含めるために、手動でキューに入れる必要がある場合があります。ユーザーが所有するコンテンツを保護するため、Qlik では、拡張にアクセスされるか、ユーザーが移行を承認しない限り、拡張の移行を実施しません。未使用の拡張 (未移行のステータス) を保持しておく場合は、手動で移行を実行できます。
移行ステータスの値:
-
未移行: 拡張は移行されていません。
-
移行キューに登録済み: 拡張はキューに登録されており、次回のスケジュールされた移行処理の際に移行が実行されます。
-
移行中: 拡張は現在移行中です。
-
移行済み: 拡張の移行は正常に完了しました。
移行はテーマにも適用されます。詳細については、「テーマのアップロードと管理」を参照してください。
拡張の追加
次の手順を実行します。
- 管理 アクティビティ センターで、 [拡張] に移動します。
-
[追加] をクリックします。
-
[参照] をクリックし、拡張ファイルを選択するか、指定されたエリアにファイルをドロップします。
-
任意でタグを追加します。
-
[公開] をクリックします。
拡張機能の編集
次の手順を実行します。
- 管理 アクティビティ センターで、 [拡張] に移動します。
-
編集する拡張で
をクリックし、 [編集] を選択します。 -
編集パネルを使用して、拡張を置き換えるかタグを更新します。
-
変更を保存します。
拡張のダウンロード
拡張を編集する前のバックアップや、別のテナントへの移行の際に実行してください。
次の手順を実行します。
- 管理 アクティビティ センターで、 [拡張] に移動します。
-
ダウンロードする拡張で、
をクリックし、[ダウンロード] を選択します。 -
ZIP ファイルを保存します。
拡張の移行
[未移行] ステータスの拡張を移行するには、次のステップに従ってください。
次の手順を実行します。
- 管理 アクティビティ センターで、 [拡張] に移動します。
-
移行する拡張で、
をクリックして [移行] を選択します。
移行の進行に伴い、移行待ち、移行中、移行済みのステータスが更新されます。
拡張機能の削除
拡張を削除すると、すべてのリソースに影響し、テナント内のすべてのユーザーに影響する可能性があります。
次の手順を実行します。
- 管理 アクティビティ センターで、 [拡張] に移動します。
- 削除する拡張を選択します。
- [Delete] (削除)をクリックします。