# 上传和管理可视化扩展

扩展为 Qlik Cloud 应用程序添加自定义可视化功能。您可以在 Administration 活动中心上传和管理扩展。

Qlik Cloud Government 注释在 Qlik Cloud 政府 中支持第三方扩展。使用它们可能需要批准，作为机构操作授权的一部分，具体取决于您组织的安全和合规性要求。

## 使用扩展

Qlik Cloud 中的可视化扩展添加了超越标准可视化的新可视化组件。使用它们来定制您呈现和探索数据的方式。

有关更多信息，请参阅 [Qlik 开发人员：扩展 Qlik](https://qlik.dev/extend/)。有关可视化演示，请参阅 [在 Qlik Cloud 中使用第三方可视化扩展](https://share.vidyard.com/watch/kq8gkpB6jfLuVDWERgAgXE?) 和 [扩展和 API 密钥](https://share.vidyard.com/watch/KzZMkq1RDQVcnWc8ShfYje?)。

## 所需角色

要上传和管理扩展，您必须拥有以下角色之一：

* 租户管理员

* 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)](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm)。

### 不支持的文件格式

出于安全原因，扩展不能包含不允许的 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 文件，请使用以下方法之一：

* 在 活动中心的创建页面上传Analytics应用程序。

* 使用 `qlik-cli` 上传应用程序。

* 在 Analytics 活动中心的创建页面上传 QVD。

* 使用 Qlik DataTransfer 上传 QVD。

## 管理扩展

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

### 扩展表信息

* 名称：QEXT 文件中的元数据名称

* QEXT 版本：元数据版本

* QEXT 文件名：扩展定义文件的唯一标识符

* 状态：扩展的迁移状态

### 关于迁移状态

Qlik 已将扩展从旧版存储迁移到用于管理扩展的服务。迁移状态表示扩展当前的迁移状态。

迁移状态值：

* 已迁移：扩展已成功迁移并可用。

* 不可用：该扩展不再可用，且无法迁移。从 Administration 活动中心删除扩展。

## 添加扩展

执行以下操作：

1. 在 Administration 活动中心内，前往扩展。

2. 单击添加。

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

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

5. 单击发布。

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

## 编辑扩展

执行以下操作：

1. 在 Administration 活动中心内，前往扩展。

2. 在要编辑的扩展上，单击 the 编辑 icon 并选择。

3. 使用编辑面板替换扩展或更新标签。

4. 保存您的更改。

## 下载扩展

使用此功能可在编辑扩展之前备份扩展，或将其移动到其他租户。

执行以下操作：

1. 在 Administration 活动中心内，前往扩展。

2. 在要下载的扩展上，单击 the 下载 icon 并选择 。

3. 保存 ZIP 文件。

## 删除扩展

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

执行以下操作：

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