# ビジュアライゼーション エクステンションのアップロードと管理

拡張機能により、Qlik Cloud アプリケーションに独自のビジュアライゼーション機能を追加できます。拡張機能のアップロードおよび管理は、管理 アクティビティ センターで実行します。

Qlik Cloud Government に関する注意Qlik Cloud Governmentでは、サードパーティの拡張機能がサポートされています。ただし、組織のセキュリティやコンプライアンス要件によっては、拡張機能を使用するにあたり、運用認可の一環として承認が必要となる場合があります。

## 拡張機能の使用

Qlik Cloud のビジュアライゼーション エクステンションは、標準で用意されているビジュアライゼーションに加え、新たな視覚的コンポーネントを提供します。これらを活用することで、データの表示方法や探索方法をカスタマイズできます。

詳細については、「[Qlik 開発者: Qlik の拡張](https://qlik.dev/extend/)」を参照してください。ビジュアル デモについては、「[Qlik Cloud におけるサードパーティのビジュアライゼーション エクステンションの使用](https://share.vidyard.com/watch/kq8gkpB6jfLuVDWERgAgXE?)」および「[拡張および API キー](https://share.vidyard.com/watch/KzZMkq1RDQVcnWc8ShfYje?)」を参照してください。

## 必要なロール

拡張機能をアップロードおよび管理するには、次のいずれかのロールが必要です。

* テナント管理者

* 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) の管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm)をご覧ください。

### 未対応ファイル形式

セキュリティ上の理由から、拡張には許可されていない 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 は、拡張をレガシー ストレージから、拡張の管理に使用されるサービスに移行しました。移行ステータスは、拡張の現在の移行状態を示します。

移行ステータスの値:

* 移行済み: 拡張の移行は正常に完了し、利用可能です。

* 利用不可: この拡張は現在使用不可であり、移行できません。管理 アクティビティ センターから拡張を削除します。

## 拡張の追加

次の手順を実行します。

1. 管理 アクティビティ センターで、 [拡張] に移動します。

2. [追加] をクリックします。

3. [参照] をクリックし、拡張ファイルを選択するか、指定されたエリアにファイルをドロップします。

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

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

情報メモ既存のファイルと同じ QEXT ファイル名の拡張はアップロードできません。

## 拡張機能の編集

次の手順を実行します。

1. 管理 アクティビティ センターで、 [拡張] に移動します。

2. 編集する拡張で the 詳細 icon をクリックし、 [編集] を選択します。

3. 編集パネルを使用して、拡張を置き換えるかタグを更新します。

4. 変更内容を保存します。

## 拡張のダウンロード

拡張を編集する前のバックアップや、別のテナントへの移行の際に実行してください。

次の手順を実行します。

1. 管理 アクティビティ センターで、 [拡張] に移動します。

2. ダウンロードする拡張で、the 詳細 icon をクリックし、[ダウンロード] を選択します。

3. ZIP ファイルを保存します。

## 拡張機能の削除

拡張を削除すると、すべてのリソースに影響し、テナント内のすべてのユーザーに影響する可能性があります。

次の手順を実行します。

1. 管理 アクティビティ センターで、 [拡張] に移動します。
2. 削除する拡張を選択します。
3. [Delete] (削除)をクリックします。