创建注释表

执行以下操作：

1. 在资产面板中，打开 图表。

2. 在可视化下，将注释表拖到工作表上。

3. 单击添加维度，然后选择维度或字段。

4. 通过在属性面板中的数据下单击 来添加其他维度和度量列。将打开一个下拉菜单。选择以下任一选项：

   • 字段和主条目：打开一个可搜索的对话框，显示每个字段和主条目。您可以选择将任何条目添加为维度或度量。
   • 自定义表达式：打开一个对话框，您可以在其中输入表达式，或打开表达式编辑器 。

5. 通过在属性面板中的数据下单击 ，然后选择可编辑列，来添加可编辑列。

6. 为表定义一个或多个主键。在注释表中，在可编辑列内，单击定义，然后选择一个或多个维度列用作主键。

   有关主键的更多信息，请参阅 主键。

7. 单击保存。

创建注释表后，允许用户与其交互并向可编辑列添加更改。您还可以通过配置其属性并将其合并到自定义主题中来定制注释表的外观。请参阅：

• 配置写入表属性

• Qlik Developer Portal：注释表主题属性

在注释表中，可编辑列允许用户在分析期间动态输入数据。通过将更改保存到可编辑列，用户将更改写入更改存储，应用程序开发人员和集成商可以从中检索这些更改。

有关在何处创建可编辑列的更多信息，请参阅 创建注释表。

添加可编辑列后，您可以通过以下方式进一步自定义它以满足您的需求：

• 更改数据下的交互设置。请参阅 管理可编辑列的交互设置。

• 在 样式面板中设置可编辑列的样式。请参阅 设置可编辑列的样式。

管理可编辑列的交互设置

执行以下操作：

1. 在属性面板中的数据下，单击可编辑列。

   列属性将打开。

2. 您可以更改以下任何属性：

   • 标题：更改默认列标题。

   • 显示内容：更改用户在表中编辑数据的方式。您可以选择：

     • 单选：指定一组值，用户在编辑时可以为每个单元格选择这些值。例如，您可以为订单状态添加两个值：On Track 和 Late。然后，用户在对数据记录进行评论时可以在这些值之间进行选择。

       对于单选，您可以使用固定值或动态值：

       • 固定：通过在输入框中键入值来手动定义值。这些值是静态的，不会随应用程序数据而改变。

       • 动态：使用表达式定义可根据表达式的值而改变的输入值。例如，您可以将值链接到数据模型字段，或链接到应用程序变量。您可以指定值和标签，或者仅指定值。

         有关在可视化中使用表达式的更多信息，请参阅 在可视化中使用表达式。
         提示注释

         语法：

         使用 | 分隔值，使用 ~ 分隔值和标签，如下所示：value1|value2 或 value1~label1|value2~label2。

         信息注释

         最多支持 1000 个值。超出限制的值将被忽略。

         示例

         =Concat(Country, '|')

         =Concat(DISTINCT City & '~' & Upper(City), '|')

         ='Product A|Product B|Product C'

         ='$(vMyVariable)'

         ='ProductA-value~ProductA-label|ProductB-value~ProductB-label'

     • 手动用户输入：用户通过在单元格中手动键入文本来编辑数据。

   • 显示列：切换列是可见还是隐藏。

   • 列宽：设置列的宽度。

更改存储

更改存储是由 Qlik 管理的存储位置，其中包含用户从注释表中的可编辑列添加的更改。更改存储是一个临时存储位置——更改最多存储 90 天，之后将被删除。

注释表的更改存储已为您的租户预先配置，并且可以通过 change-stores API 访问。使用您的更改存储 ID，您可以制定 API 请求和自动化，将用户更改同步到永久位置，例如电子表格或数据库。有关更多信息，请参阅 提取和使用更改。

您可以通过两种方式复制更改存储 ID：

• 在创建注释表后的工作表编辑模式下。在属性面板中的更改存储 > 更改存储 ID 下，单击 。

  

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

  

要向注释表添加可编辑列，您需要定义至少一个主键。

主键是一个字段，用于将对可编辑列的更改链接回数据模型中的原始数据。主键提供注释表中的记录（代表数据模型中的数据）与用户在可编辑列中引入的编辑之间的映射。

主键可以是单个字段，也可以是跨越多个字段的复合键。

在注释表中定义主键后，您可以随时更改它们。在属性面板中的更改存储 > 主键下，单击修改。

当您从 change-stores API 提取更改时，主键也很重要。

使用 Qlik Automate 提取注释表更改

可以使用 Qlik Automate 中 Qlik Cloud Services 连接器中的 Change Store 块来提取保存在更改存储中的更改。此连接器会自动连接到自动化所有者的 Qlik 帐户，因此无需执行其他步骤进行身份验证。

有关 Qlik Automate 的更多信息，请访问 Qlik Automate。

列出更改存储中的当前更改

List Current Changes From Change Store 块使用 API 端点 /changes/tabular-views，并且仅返回每个单元格的最新值（换句话说，它返回当前值）。它将这些值作为对象列表返回，其中每个对象包含主键和更改值。每条记录还扩展了一个 updatedAt 时间戳（表示最后一次更新记录的日期时间）和一个 updatedBy 用户 ID（表示进行此更改的用户）。

列出更改存储历史记录

List Change Store History 块使用 API 端点 /changes 并返回每个单元格的完整历史记录。如果一个单元格已更新多次，则此块将返回每次更新的每个值、userId 和 updatedAt 时间戳。

使用模板

如果您要将数据提取到 MySQL 数据库，也可以从自动化模板开始。以下模板在 Insights to Action 下可用：

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

这些模板将 Change Store 块（如上所述）与其他块排列在一起，以帮助您更快地提取数据。只需调整块参数以连接到您的资源。有关详细的演练，请参阅这篇社区文章。