上傳和管理視覺化延伸
延伸可實現 Qlik Sense 應用程式的自訂視覺化,以延伸 Qlik Cloud 分析平台的功能。您可以從 管理 活動中心上傳並編輯延伸。
建立和上傳延伸的指導方針
建立視覺化延伸並上傳至 Qlik Cloud 時應遵守以下指導方針。
如需關於新增和使用延伸的視覺示範,請參閱在 Qlik Cloud 中使用第三方視覺化延伸和延伸和 API 金鑰。
延伸的 ZIP 檔案限制
-
ZIP 檔案大小上限:30 MB
-
ZIP 中檔案的檔案大小上限:30 MB
-
ZIP 中的檔案數量上限:500
-
ZIP 中檔案的解壓縮檔案大小總計上限:100 MB
最佳做法
-
縮小程式碼檔案。
-
僅包含必要檔案。確保 ZIP 檔案僅包含延伸所需檔案以便正確運作。
-
在上傳前檢閱延伸及其代碼。請參閱視覺化延伸 (僅提供英文版)瞭解更多資訊。
延伸所需的基本檔案
確保您的延伸 ZIP 檔案包含以下基本檔案:
-
.qext:延伸中繼資料檔案
-
.js:用於延伸的 JavaScript 程式碼
-
.html:用於轉譯延伸的 HTML 程式碼
-
.css:用於設定延伸樣式的自訂 CSS
影像檔案的外部託管
請勿上傳延伸 ZIP 檔案內的影像檔案 (例如 GIF、PNG、JPG)。而應在外部託管於個人應用程式伺服器、S3 值區或公用內容管理系統。在您的延伸程式碼中參考這些外部影像。
參考外部程式碼檔案和內容
您可以在主要延伸程式碼中參考程式碼檔案和內容,但這需要在租用戶上實施內容安全性政策 (CSP)。如需詳細資訊,請參閱管理 Content Security Policy (CSP)。
若延伸請求外部資源,這些資源來源必須在 CSP 中列入允許清單,否則將會封鎖延伸以免轉譯。
不支援的功能
不支援以下功能:
搭售延伸
Qlik Cloud 不支援包含其他延伸 ZIP 檔案的 ZIP 檔案。
QVF 和 QVD 檔案
請勿在延伸 ZIP 檔案中納入 Qlik Sense QVF 或 QVD 檔案,因為這些無法從延伸服務存取。請先移除這些檔案再上傳延伸。
若要將 QVF 或 QVD 檔案上傳至 Qlik Cloud 租用戶,使用下列方法之一:
-
在 分析 活動中心的「建立」頁面中上傳應用程式。
-
使用 qlik-cli 上傳應用程式。
-
在 分析 活動中心的建立頁面中上傳 QVD。
-
使用 Qlik DataTransfer 上傳 QVD。
不支援的檔案格式
基於安全因素,延伸不可包含含有不允許 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'
延伸中的所有檔案都必須有檔案名稱和檔案延伸。將會忽略沒有遵守的檔案。忽略的檔案範例包括 .gitignore 和 README。
新增和管理延伸
可在 管理 活動中心內的延伸頁面管理延伸。
在延伸表格中:
-
名稱是指 QEXT 檔案中的中繼資料名稱。
-
QEXT 版本指示 QEXT 檔案中的中繼資料版本。
-
QEXT 檔案名稱是延伸定義檔案的唯一識別碼和名稱。
您可以依照標記篩選延伸。
新增新的延伸
請執行下列動作:
- 在 管理 活動中心,前往延伸。
-
按一下新增。
-
按一下瀏覽以選取延伸檔案,或在指定區域放置檔案。
-
也可以選擇新增標記。
-
按一下發佈。
編輯延伸
請執行下列動作:
- 在 管理 活動中心,前往延伸。
-
在您要編輯的延伸上,按一下 並選取編輯。
就會顯示編輯面板,其中含有選項可取代現有的延伸和新增或移除標記。
-
儲存變更。
刪除延伸
刪除延伸可能會影響所有資源,進而影響租用戶內的所有使用者。
請執行下列動作:
- 在 管理 活動中心,前往延伸。
- 選取您要刪除的延伸。
- 按一下刪除。