# 上傳和管理視覺化延伸

延伸功能可為 Qlik Cloud 應用程式新增自訂視覺化功能。您可以在 管理 活動中心上傳及管理延伸。

Qlik Cloud 政府備註Qlik Cloud 政府 支援第三方延伸。根據您組織的安全與合規性要求，使用這些功能可能需要獲得核准，作為機構營運授權的一部分。

## 使用延伸

Qlik Cloud 中的視覺化延伸功能可新增標準視覺化以外的視覺元件。使用它們來調整您呈現和探索資料的方式。

如需更多資訊，請參閱 [Qlik 開發人員：延伸 Qlik](https://qlik.dev/extend/)。如需視覺示範，請參閱 [在 Qlik Cloud 中使用第三方視覺化延伸](https://share.vidyard.com/watch/kq8gkpB6jfLuVDWERgAgXE?) 和 [延伸和 API 金鑰](https://share.vidyard.com/watch/KzZMkq1RDQVcnWc8ShfYje?)。

## 需要的角色

若要上傳和管理延伸，您必須擁有下列其中一個角色：

* 租用戶管理員

* 分析管理員

* 具備管理延伸權限並設定為允許的自訂角色

## 檔案要求與限制

請遵循以下規則，以確保您的延伸能正確上傳並運作。

### 檔案限制

延伸 ZIP 檔案有以下限制：

* ZIP 檔案大小上限：30 MB

* 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/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm)。

### 不支援的檔案格式

基於安全因素，延伸不可包含含有不允許 MIME 類型的檔案。MIME 類型 (多用途網際網路郵件延伸) 指示檔案的格式。如果您的延伸包含不允許的 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. 按一下刪除。