管理扩展
扩展通过实现 Qlik Sense 应用程序的自定义可视化,对 Qlik Cloud 分析平台的功能进行扩展。您可以从 Administration 活动中心上传和编辑扩展。
创建和上载扩展的准则
创建可视化扩展并将其上传到 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 中将这些资源来源列入许可名单,否则将阻止该扩展呈现。
不支持的功能
不支持以下功能:
捆绑的扩展
Qlik Cloud 不支持包含其他扩展 ZIP 文件的 ZIP 文件。
QVF 和 QVD 文件
不要在扩展 ZIP 文件中包含 Qlik Sense QVF 或 QVD 文件,因为无法从扩展服务访问这些文件。先删除这些文件,然后再上传扩展。
要将 QVF 或 QVD 文件上传到 Qlik Cloud 租户,请使用以下方法之一:
-
在 Analytics 活动中心的“创建”页面上传应用程序。
-
使用 qlik-cli 上传应用程序。
-
在 Analytics 活动中心的创建页面上传 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。
添加和管理扩展
扩展的管理在 Administration 活动中心的扩展页面中进行。
在扩展表格中:
-
名称表示 QEXT 文件中的元数据名称。
-
QEXT 版本表示 QEXT 文件中的元数据版本。
-
QEXT 文件名是唯一标识符和扩展定义文件的名称。
您可以按标签筛选扩展。
新增扩展
执行以下操作:
- 在 Administration 活动中心内,前往扩展。
-
单击添加。
-
单击浏览选择扩展文件,或在指定区域中放置文件。
-
可以选择性添加标签。
-
单击发布。
编辑扩展
执行以下操作:
- 在 Administration 活动中心内,前往扩展。
-
在要编辑的扩展上,单击 并选择编辑。
编辑面板显示用于替换现有扩展和添加或删除标签的选项。
-
保存您的更改。
删除扩展
删除扩展可能会影响全部资源,从而影响租户内的所有用户。
执行以下操作:
- 在 Administration 活动中心内,前往扩展。
- 选择要删除的扩展。
- 单击删除。