上传和管理可视化扩展
扩展为 Qlik Cloud 应用程序添加自定义可视化功能。您可以在 Administration 活动中心上传和管理扩展。
使用扩展
Qlik Cloud 中的可视化扩展添加了超越标准可视化的新可视化组件。使用它们来定制您呈现和探索数据的方式。
有关更多信息，请参阅 Qlik 开发人员：扩展 Qlik。有关可视化演示，请参阅 在 Qlik Cloud 中使用第三方可视化扩展 和 扩展和 API 密钥。
所需角色
要上传和管理扩展，您必须拥有以下角色之一：
-
租户管理员
-
Analytics 管理员
-
具有管理扩展权限并设置为允许的自定义角色
文件要求和限制
请遵循以下规则，以确保您的扩展正确上传和运行。
文件限制
扩展 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)，并将您的扩展需要访问的外部源列入允许列表。
如果某个源未列入允许列表，您的扩展将无法渲染。
有关更多信息，请参阅管理内容安全策略 (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。
管理扩展
扩展在 Administration 活动中心的扩展页面中进行管理。
扩展表信息
-
名称：QEXT 文件中的元数据名称
-
QEXT 版本：元数据版本
-
QEXT 文件名：扩展定义文件的唯一标识符
-
状态：迁移状态（临时）
关于迁移状态
Qlik 正在改进平台处理扩展的方式。在此过渡期间，现有扩展将迁移到新服务。迁移状态列是临时的，仅在此工作进行期间显示。
自 2025-11-17 起，您上传或访问的任何扩展都将自动使用新服务。如果您的扩展正在正常使用中，则无需执行任何操作。
大多数扩展在使用时会自动迁移。您最近未使用的扩展可能需要手动排队，才能包含在计划的迁移运行中。为保护客户拥有的内容，除非扩展被访问或您确认迁移，否则 Qlik 不会迁移扩展。如果您想保留未使用的扩展（状态为未迁移），可以手动迁移它。
迁移状态值：
-
未迁移：该扩展尚未迁移。
-
已排队等待迁移：该扩展已排队，将在下一次计划的迁移运行期间进行迁移。
-
正在迁移：该扩展当前正在迁移。
-
已迁移：扩展已成功迁移。
迁移也适用于主题。有关详细信息，请参阅上传和管理主题。
添加扩展
执行以下操作：
- 在 Administration 活动中心内，前往扩展。
-
单击添加。
-
单击浏览选择扩展文件，或在指定区域中放置文件。
-
可以选择性添加标签。
-
单击发布。
编辑扩展
执行以下操作：
- 在 Administration 活动中心内，前往扩展。
-
在要编辑的扩展上，单击
并选择编辑。 -
使用编辑面板替换扩展或更新标签。
-
保存您的更改。
下载扩展
使用此功能可在编辑扩展之前备份扩展，或将其移动到其他租户。
执行以下操作：
- 在 Administration 活动中心内，前往扩展。
-
在要下载的扩展上，单击
并选择 下载。 -
保存 ZIP 文件。
迁移扩展
使用以下步骤迁移状态为未迁移的扩展。
执行以下操作：
- 在 Administration 活动中心内，前往扩展。
-
在要迁移的扩展上，单击
并选择迁移。
状态会随着迁移的进行而更新：已排队等待迁移、正在迁移，最后是已迁移。
删除扩展
删除扩展可能会影响全部资源，从而影响租户内的所有用户。
执行以下操作：
- 在 Administration 活动中心内，前往扩展。
- 选择要删除的扩展。
- 单击删除。