跳到主要内容 跳到补充内容

上传和管理可视化扩展

扩展通过实现 Qlik Sense 应用程序的自定义可视化,对 Qlik Cloud 分析平台的功能进行扩展。您可以从 Administration 活动中心上传和编辑扩展。

Qlik Cloud Government 注释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 租户,请使用以下方法之一:

  • 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'

扩展中的所有文件都必须具有文件名和文件扩展名。不符合此要求的文件将被忽略。被忽略的文件的示例包括 .gitignoreREADME

添加和管理扩展

扩展的管理在 Administration 活动中心的扩展页面中进行。

扩展表格中:

  • 名称表示 QEXT 文件中的元数据名称。

  • QEXT 版本表示 QEXT 文件中的元数据版本。

  • QEXT 文件名是唯一标识符和扩展定义文件的名称。

您可以按标签筛选扩展。

新增扩展

执行以下操作:

  1. Administration 活动中心内,前往扩展
  2. 单击添加

  3. 单击浏览选择扩展文件,或在指定区域中放置文件。

  4. 可以选择性添加标签。

  5. 单击发布

信息注释不能将与现有文件相同的 QEXT 文件名用于上传扩展。

编辑扩展

执行以下操作:

  1. Administration 活动中心内,前往扩展
  2. 在要编辑的扩展上,单击 更多 并选择编辑

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

  3. 保存您的更改。

删除扩展

删除扩展可能会影响全部资源,从而影响租户内的所有用户。

执行以下操作:

  1. Administration 活动中心内,前往扩展
  2. 选择要删除的扩展。
  3. 单击删除

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!