上傳和管理視覺化延伸
延伸功能可為 Qlik Cloud 應用程式新增自訂視覺化功能。您可以在 管理 活動中心上傳及管理延伸。
使用延伸
Qlik Cloud 中的視覺化延伸功能可新增標準視覺化以外的視覺元件。使用它們來調整您呈現和探索資料的方式。
如需更多資訊，請參閱 Qlik 開發人員：延伸 Qlik。如需視覺示範，請參閱 在 Qlik Cloud 中使用第三方視覺化延伸 和 延伸和 API 金鑰。
需要的角色
若要上傳和管理延伸，您必須擁有下列其中一個角色：
-
租用戶管理員
-
分析管理員
-
具備管理延伸權限並設定為允許的自訂角色
檔案要求與限制
請遵循以下規則，以確保您的延伸能正確上傳並運作。
檔案限制
延伸 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)。
不支援的檔案格式
基於安全因素，延伸不可包含含有不允許 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 正在改善平台處理延伸的方式。在此轉換期間，現有延伸會移至新服務。移轉狀態欄位是暫時性的，只會在進行此工作時顯示。
自 2025-11-17 起，您上傳或存取的任何延伸會自動使用新服務。如果您的延伸正在定期使用中，則不需要採取任何動作。
大多數延伸在使用時會自動移轉。您最近未使用的延伸可能需要手動排入佇列，才能納入排定的移轉執行中。為了保護客戶擁有的內容，Qlik 不會移轉延伸，除非它們被存取或您確認移轉。如果您想保留未使用的延伸 (狀態為 未移轉)，您可以手動移轉它。
移轉狀態值：
-
未移轉：延伸尚未移轉。
-
已排入移轉佇列：延伸已排入佇列，並將在下次排定的移轉執行期間移轉。
-
移轉進行中：延伸目前正在移轉。
-
已移轉：延伸已成功移轉。
移轉也適用於佈景主題。如需詳細資訊，請參閱 上傳和管理佈景主題。
新增延伸
請執行下列動作：
- 在 管理 活動中心，前往延伸。
-
按一下新增。
-
按一下瀏覽以選取延伸檔案，或在指定區域放置檔案。
-
也可以選擇新增標記。
-
按一下發佈。
編輯延伸
請執行下列動作：
- 在 管理 活動中心，前往延伸。
-
在您要編輯的延伸上，按一下
並選取編輯。 -
使用編輯面板取代延伸或更新標籤。
-
儲存變更。
下載延伸
使用此功能可在編輯延伸之前備份延伸，或將其移至另一個租用戶。
請執行下列動作：
- 在 管理 活動中心，前往延伸。
-
在您要下載的延伸上，按一下
並選取 下載。 -
儲存 ZIP 檔案。
移轉延伸
使用下列步驟以移轉狀態為未移轉的延伸。
請執行下列動作：
- 在 管理 活動中心，前往延伸。
-
在您要移轉的延伸上，按一下
並選取 移轉。
狀態會隨著移轉進度更新：已排入移轉佇列、移轉進行中，最後是 已移轉。
刪除延伸
刪除延伸可能會影響所有資源，進而影響租用戶內的所有使用者。
請執行下列動作：
- 在 管理 活動中心，前往延伸。
- 選取您要刪除的延伸。
- 按一下刪除。