メイン コンテンツをスキップする 補完的コンテンツへスキップ
Qlik リソース

エクステンションの管理

エクステンションは、管理コンソール の [エクステンション] ページで管理されています。

Qlik Sense Enterprise SaaS Government メモQlik Cloud Governmentでは、サードパーティの拡張機能がサポートされています。ただし、組織のセキュリティおよびコンプライス要件に応じて、サードパーティの拡張機能の使用が、機関の運営権限 (ATO) の一部として定義および承認される必要がある場合があります。

外部リソースへのリソースの要求が含まれるエクステンションでは、原点が Content Security Policy の許可リストに含まれている必要があります。含まれない場合は、エクステンションのレンダリングがブロックされます。

ヒント メモアップロードする前に、拡張とそのコードを確認することをお勧めします。詳細については、ビジュアライゼーションエクステンション (英語のみ)を参照してください。

拡張の追加と使用に関するビジュアル デモについては、「Qlik Cloud におけるサードパーティのビジュアライゼーション エクステンションの使用」および「拡張と API キー」を参照してください。

エクステンションの概要

管理コンソール の [エクステンション] ページには、以下のプロパティが示されています。

エクステンションのプロパティ
プロパティ 説明

名前

これは、QEXT ファイルに書き込まれているメタデータ名であり、QEXT のファイル名とは異なります。

説明

エクステンションの簡単な説明。

タグ

フィルタリングのためのタグ。

Author

エクステンションの作成者。

QEXT ファイル名

一意が必須の識別子。エクステンション定義ファイルのファイル名。エクステンションの名前とは異なります。

QEXT バージョン

QEXT ファイルにあるメタデータ バージョン。

公開済み

公開日付。

テーブルでは、プロパティ ヘッダーの矢印を使用してソートします。[Tags] (タグ) ドロップダウン メニューを使用するか、テーブルでタグを選択することによってフィルターします。

外部リソースを伴うエクステンション

外部リソースへのリソースの要求が含まれるエクステンションでは、原点が Content Security Policy の許可リストに含まれている必要があります。含まれない場合は、エクステンションのレンダリングがブロックされます。

参照先:Content Security Policy の管理

未対応ファイル形式

セキュリティ上の理由から、許可されていない 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'
情報メモエクステンション内のすべてのファイルには、ファイル名とファイル拡張子が必要です。この条件を満たさないファイルは無視されます。無視されるファイルの例: .gitignore および README。

拡張の作成とアップロードに関するガイドライン

Qlik Cloud と Qlik Sense Enterprise Client-Managed は異なる拡張サービスを使用するため、結果的に機能が異なります。ビジュアライゼーション拡張を作成して Qlik Cloud にアップロードする場合は、次のガイドラインに従う必要があります。

  • 拡張を含む ZIP ファイルには次の制限があります。

    • 最大 ZIP ファイル サイズ: 30MB

    • ZIP ファイルの最大ファイル サイズ: 30 MB

    • ZIP の最大ファイル数: 500

    • ZIP ファイルの非圧縮合計ファイル サイズの最大値: 100 MB

  • コードファイルを縮小します。

  • 拡張 ZIP ファイルには、拡張の正しい機能に必要なファイルのみを含めます。この表は、ビジュアライゼーションエクステンションに必要な基本ファイルを示しています。

    ファイル拡張子 説明
    .qext エクステンションメタデータファイル
    .js エクステンションのための JavaScript コード

    .html

    		エクステンションをレンダリングするための HTML コード
    .css

    エクステンションをスタイリングするためのカスタム CSS

  • 画像ファイルはアップロードしないでください。GIF、PNG、JPG、およびその他の画像ファイルは、パーソナルアプリケーションサーバー、S3 バケット、または公開コンテンツ管理システムのいずれかで外部にホストする必要があります。これらは、拡張コードから参照することができます。

    情報メモ一部のコードファイルとコンテンツは、プライマリ拡張コードから参照できます。エクステンションから外部コンテンツを参照するには、テナントにコンテンツセキュリティポリシーを実装する必要があります。詳細については、Content Security Policy の管理 を参照してください。

  • Qlik Cloud 拡張サービスは、バンドルされた拡張機能 (他の拡張 ZIPファイルを含む ZIP ファイル) をサポートしません。

  • Qlik Sense QVF または QVD ファイルを含む拡張は、拡張サービスからアクセスできないため、アップロードしないでください。拡張をアップロードする前に、これらのファイルを削除します。

  • Qlik Cloud テナントに QVF または QVD ファイルをアップロードするには、次のいずれかを実行します。

    • クラウド ハブから app をアップロードします。

    • qlik-cli を使用してアプリをアップロードします。

    • クラウドハブから AVD をアップロードします。

    • Qlik DataTransfer を使用してQVD をアップロードします。

新しいエクステンションの追加

次の手順を実行します。

  1. 管理コンソール で、[エクステンション] セクションに移動し、右上隅の [追加] をクリックします。

  2. ポップアップで [参照] をクリックし、エクステンションのファイルを選択するか、指定されたエリアにファイルをドロップします。

    情報メモ既存のファイルと同じ QEXT ファイル名のエクステンションはアップロードできません。

  3. 任意でタグを追加します。

  4. [公開] をクリックします。

  5. 今アップロードした拡張に外部リソースが含まれる場合は、Content Security Policy のオリジンを許可リストに追加する必要があります。「Content Security Policy の管理」を参照してください。

エクステンションの編集

一度にエクステンションを 1 つ編集できます。

次の手順を実行します。

  1. 管理コンソール で、[エクステンション] セクションに移動し、編集したいエクステンションのチェックボックスを選択します。

  2. 右上にある [編集] をクリックします。

    既存のエクステンションを置き換える場合のオプション、およびタグを追加または削除する場合のオプションョンと一緒に編集パネルが表示されます。

  3. 編集して保存します。

エクステンションの削除

次の手順を実行します。

  1. 管理コンソール で、[エクステンション] セクションに移動し、削除したいエクステンションのチェックボックスを選択します。
  2. 右上にある [削除] をクリックします。
情報メモエクステンションを削除すると、すべてのリソースに影響します。テナント内のすべてのユーザーは削除による影響を受けます。

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

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

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