Early Access: The content on this website is provided for informational purposes only in connection with pre-General Availability Qlik Products.
All content is subject to change and is provided without warranty.
跳到主要内容 跳到补充内容
video thumbnail
video thumbnail

上传和管理可视化扩展

扩展通过实现 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)。有关更多信息,请参阅管理内容安全策略 (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. 单击删除

本页面有帮助吗?

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