管理扩展
扩展在扩展页面上的 管理控制台 中受管理。
包含外部资源的资源请求的扩展必须在Content Security Policy中将其来源列入白名单,否则将阻止该扩展呈现。
有关添加和使用扩展的可视化演示,请参阅在 Qlik Cloud 中使用第三方可视化扩展以及扩展和 API 密钥。
扩展概览
在 管理控制台 的扩展页面中,显示以下属性。
属性 | 说明 |
---|---|
Name |
这是包含在 QEXT 文件中的元数据名称,其不同于 QEXT 文件名。 |
Description |
扩展的简短描述。 |
Tags |
用于筛选的标签。 |
Author |
扩展的创建者。 |
QEXT 文件名 |
必须为唯一的标识符。扩展定义文件的文件名。和扩展的名称不同。 |
QEXT 版本 |
包含在 QEXT 文件中的元数据版本。 |
Published |
发布日期。 |
在表格中,通过在属性标题中使用箭头来排序。通过使用标签下拉列表或通过选择表格中的标签来进行筛选。 d
带外部资源的扩展
包含外部资源的资源请求的扩展必须在Content Security Policy中将其来源列入白名单,否则将阻止该扩展呈现。
另请参见:管理 Content Security Policy
不支持的文件格式
扩展文件夹中的文件的最大大小为 15 MB。
出于安全考虑,不允许扩展包含具有不允许的 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'
创建和上载扩展的准则
Qlik Cloud 和 Qlik Sense Enterprise Client-Managed 使用不同的扩展服务,因此它们具有不同的功能。创建可视化扩展并将其上载到 Qlik Cloud 时,应遵循以下准则:
-
扩展 ZIP 文件的大小应小于 15 MB。这确保了扩展上传不会超时或存在问题。
-
缩小代码文件。
-
在扩展 ZIP 文件中只包含扩展正常运行所需的文件。下表显示了可视化扩展所需的基本文件。
文件扩展名 描述 .qext 扩展元数据文件 .js 扩展的 JavaScript 代码 .html
呈现扩展的 HTML 代码 .css 用于设置扩展样式的自定义 CSS
-
不要上传图像文件。GIF、PNG、JPG 和其他图像文件应该在外部托管,可以托管在个人应用服务器、S3 存储段或公共内容管理系统上。它们可以是来自扩展代码的引用。
信息注释可以从主扩展代码中引用一些代码文件和内容。从扩展中引用外部内容需要在租户上实现内容安全策略。有关更多信息,请参阅管理 Content Security Policy。 -
Qlik Cloud 扩展服务不支持捆绑扩展(包含其他扩展 ZIP 文件的 ZIP 文件)。
-
不要上载包含 Qlik Sense QVF 或 QVD 文件的扩展,因为这些文件无法从扩展服务访问。先删除这些文件,然后才能上载扩展。
-
要将 QVF 或 QVD 文件上载到 Qlik Cloud 租户,请执行以下操作之一:
新增扩展
执行以下操作:
- 在 管理控制台 中,转到扩展部分,然后单击右上角的添加。
-
在弹出窗口中,单击浏览选择扩展文件,或在指定区域中放置文件。
信息注释不能将与现有文件相同的 QEXT 文件名用于上传扩展。 -
可以选择性添加标签。
-
单击发布。
-
如果刚刚上载的扩展包含外部资源,则需要在Content Security Policy中将来源加入许可名单。请参阅管理 Content Security Policy。
编辑扩展
您可以一次编辑一个扩展。
执行以下操作:
- 在 管理控制台 中,转到扩展部分并选择要编辑的扩展的复选框。
-
在右上角,单击编辑。
编辑面板显示用于替换现有扩展和添加或删除标签的选项。
-
进行编辑并保存。
删除扩展
执行以下操作:
- 在 管理控制台 中,转到扩展部分并选择要删除的扩展的复选框。
- 在右上角,单击删除。