跳到主要内容

管理扩展

扩展在扩展页面上的 管理控制台 中受管理。

Qlik Sense Enterprise SaaS Government 注释Qlik Sense Enterprise SaaS - Government (US) 中支持第三方扩展。但是,第三方扩展的使用可能需要作为机构权限的一部分进行定义和批准,以进行操作,具体取决于您的组织遵循的安全性和合规性要求。

包含外部资源的资源请求的扩展必须在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'
信息注释扩展中的所有文件都必须具有文件名和文件扩展名。不符合此要求的文件将被忽略。被忽略的文件的示例:.gitignoreREADME

创建和上载扩展的准则

Qlik Sense SaaSQlik Sense Enterprise Client-Managed 使用不同的扩展服务,因此它们具有不同的功能。创建可视化扩展并将其上载到 Qlik Sense SaaS 时,应遵循以下准则:

  • 扩展 ZIP 文件的大小应小于 15 MB。这确保了扩展上传不会超时或存在问题。

  • 缩小代码文件。

  • 在扩展 ZIP 文件中只包含扩展正常运行所需的文件。下表显示了可视化扩展所需的基本文件。

    文件扩展名 描述
    .qext 扩展元数据文件
    .js 扩展的 JavaScript 代码

    .html

    呈现扩展的 HTML 代码
    .css

    用于设置扩展样式的自定义 CSS

  • 不要上传图像文件。GIF、PNG、JPG 和其他图像文件应该在外部托管,可以托管在个人应用服务器、S3 存储段或公共内容管理系统上。它们可以是来自扩展代码的引用。

    信息注释可以从主扩展代码中引用一些代码文件和内容。从扩展中引用外部内容需要在租户上实现内容安全策略。有关更多信息,请参阅管理 Content Security Policy
  • Qlik Sense SaaS 扩展服务不支持捆绑扩展(包含其他扩展 ZIP 文件的 ZIP 文件)。

  • 不要上载包含 Qlik Sense QVF 或 QVD 文件的扩展,因为这些文件无法从扩展服务访问。先删除这些文件,然后才能上载扩展。

  • 要将 QVF  或 QVD 文件上载到 Qlik Sense SaaS 租户,请执行以下操作之一:

    • 从云中心上传应用程序。

    • 使用 qlik-cli 上传应用程序。

    • 从云中心上传 QVD。

    • 使用 Qlik DataTransfer 上传 QVD。

新增扩展

执行以下操作:

  1. 管理控制台 中,转到扩展部分,然后单击右上角的添加
  2. 在弹出窗口中,单击浏览选择扩展文件,或在指定区域中放置文件。

    信息注释不能将与现有文件相同的 QEXT 文件名用于上传扩展。
  3. 可以选择性添加标签。

  4. 单击发布

  5. 如果刚刚上载的扩展包含外部资源,则需要在Content Security Policy中将来源加入许可名单。请参阅管理 Content Security Policy

编辑扩展

您可以一次编辑一个扩展。

执行以下操作:

  1. 管理控制台 中,转到扩展部分并选择要编辑的扩展的复选框。
  2. 在右上角,单击编辑

    编辑面板显示用于替换现有扩展和添加或删除标签的选项。

  3. 进行编辑并保存。

删除扩展

执行以下操作:

  1. 管理控制台 中,转到扩展部分并选择要删除的扩展的复选框。
  2. 在右上角,单击删除
信息注释删除扩展会影响所有资源。租户中的所有用户都会受到删除的影响。