创建写入表
您可以在工作表上创建写入表,根据需要添加维度、度量和可编辑列。在应用程序中创建写入表后,拥有该应用程序访问权限以及写入表权限的用户将能够对可编辑列进行更改。然后可以将更改导出到外部系统。
创建写入表
您可以随时将注释表添加到您的工作表。
执行以下操作:
-
在资产面板中,打开 图表。
-
在 可视化 下,将注释表拖动到工作表。
单击添加维度,然后选择维度或字段。
通过在属性面板中数据下单击
来添加额外的维度和度量列。将打开一个下拉列表。选择以下任一项:
- 字段和主条目:打开一个可搜索的对话框,显示每个字段和主条目。您可以选择添加任何项目作为维度或度量。
- 自定义表达式:打开一个对话框,您可以在其中键入表达式或打开表达式编辑器
。
通过点击属性面板中数据下的
,并选择可编辑列,添加可编辑列。
为该表定义一个或多个主键。在写入表中,在可编辑列中,点击定义,并选择一个或多个维度列用作主键。
有关主键的更多信息,请参阅主键。
单击保存。
创建写入表后,允许用户与其交互并向可编辑列添加更改。您还可以通过配置写入表的属性来自定义其外观。请参阅配置写入表属性。
提取并使用更改
当用户在 可编辑列 中添加数据时,其更改不会应用于应用程序的数据模型。它们也是临时的 — 更改会存储在 Qlik 管理的 更改存储 中 90 天,之后会被删除。
您可以通过 更改存储 API 检索这些更改。这些更改可以通过多种方式使用,包括:
-
将更改加载到 QVD 文件或应用程序中,以便在 Qlik Cloud 中进行永久存储和使用。
-
提取更改,并将其添加到外部系统,例如 Excel 电子表格或 SQL 数据库。
-
将数据动态集成到自动化流程中,例如发送电子邮件和采购库存。
-
构建您自己的应用程序,并将对 更改存储 API 的调用集成到您的操作工作流中。
先决条件
在访问更改存储中保存的数据之前,您需要能够访问 更改存储 API。为此,您需要:
用于提取更改的可用工具
您可以使用以下工具从更改存储 API中提取和使用更改:
-
Qlik Automate
-
通过Qlik脚本编写和数据准备提供的REST连接器。
相关示例和用例,请参见:
概念
本部分提供了写入表的基本概念概览。
可编辑列
在写入表中,可编辑列允许用户在分析期间即时输入数据。通过将更改保存到可编辑列,用户将更改写入更改存储,应用程序开发人员和集成商可以从中检索这些更改。
有关创建可编辑列位置的更多信息,请参阅 创建写入表。
添加可编辑列后,您可以进一步自定义它以满足您的需求。
执行以下操作:
-
在属性面板中,在数据下,单击可编辑列。
列属性打开。
-
您可以更改以下任何属性:
-
标题:更改默认列标题。
-
显示内容:更改用户在表中编辑数据的方式。您可在以下项目之间选择:
-
单选:指定用户在编辑时可为每个单元格选择的一组值。例如,您可以为订单状态添加两个值:正常 和 延迟。用户在评论数据记录时可以选择这些值。
-
手动用户输入:用户通过手动在单元格中键入文本来编辑数据。
-
-
显示列:切换列是可见还是隐藏。
-
列宽:设置列的宽度。
-
更改存储
更改存储是一个Qlik管理的存储位置,其中包含写入表中可编辑列中用户添加的更改。更改存储是一个临时存储位置——更改最多存储 90 天,之后将被删除。
您的写入表的更改存储已为您的租户预配置,并且可通过更改存储 API访问。使用您的更改存储 ID,您可以制定 API 请求和自动化,将用户更改同步到永久位置,例如工作表或数据库。有关更多信息,请参阅提取并使用更改。
您可以通过两种方式复制更改存储 ID:
-
在工作表编辑模式下,创建写入表后。在属性面板中,在更改存储> 更改存储ID下,点击
。
从属性面板复制更改存储ID。

-
在分析模式下查看写入表时。单击右下角的
图标。单击
以复制更改存储 ID。
查看写入表时复制更改存储 ID。

主键
要向写入表添加可编辑列,您需要定义至少一个主键。
主键是一个字段,用于将对可编辑列的更改链接回数据模型中的原始数据。主键提供写入表(表示数据模型中的数据)中的记录与用户在可编辑列中引入的编辑之间的映射。
主键可以是单个字段,也可以是跨多个字段的复合键。
在写入表中定义主键后,您可以随时更改它们。在属性面板中,在更改存储 > 主键下,单击修改。
主键在您从 更改存储 API 拉取更改时也很重要。
使用 Qlik Cloud 工具从写入表中提取更改
使用 Qlik Automate 提取写入表更改
通过使用 Qlik Automate 中 Qlik Cloud Services 连接器中的 Change Store 块,可以提取更改存储中保存的更改。此连接器会自动连接到自动化所有者的 Qlik 账户,因此无需额外的身份验证步骤。
有关 Qlik Automate 的更多信息,请访问 Qlik Automate。
访问可用的 Qlik Automate 块以提取写入表更改

列出更改存储中的当前更改
List Current Changes From Change Store块使用API端点/changes/tabular-views,并且只会返回每个单元格的最新值(换句话说,它返回当前值)。它将这些值作为对象列表返回,其中每个对象都包含主键和更改值。每条记录还扩展了一个updatedAt时间戳,用于记录上次更新的日期时间,以及一个updatedBy用户ID,用于标识进行此更改的用户。
List Current Changes From Change Store块位于Qlik Automate中

此块还有一个增量变体List Current Changes From Change Store Incrementally。此变体的工作方式如下:
-
首次运行时,此块会检索所有记录。
- 在后续运行中,此块仅以相同的记录格式检索新增和更新的值。
- 如果记录中仅更新了一个值,则此块将仅返回该值(以及主键和updatedAt和updatedBy参数)。如果同一单元格在此块的两次运行之间更新了多次,则此块将仅返回最终更新(即“当前”值)。
列出更改存储历史记录
The List Change Store History 块使用 /changes API 端点,并返回每个单元格的完整历史记录。如果一个单元格被多次更新,那么这个块将返回每次更新的每个值、userId 和 updatedAt 时间戳。
List Change Store History 块在 Qlik Automate 中

权限
要创建写入表并与 更改存储 API 交互,您需要特定的权限。有关更多信息,请参阅注释表权限。