在应用中使用表格

以下是通过一线运营应用读写 Tables 的方法。

在本指南中，您将学习……

• 如何在应用中读取现有的表记录
• 如何在应用中更新现有的表记录
• 如何在应用中创建新的表格记录
• 如何根据应用完成情况分析表格中的数据

在应用编辑器中，您可以读取、编辑和创建单个表格记录。由于表格无需编写任何代码，您可以在播放器中运行应用，并实时观察表格的更新情况。

本指南将介绍如何将表格与应用程序结合使用，以创建功能更强大的应用程序。

读取或更新任何表格记录包括以下三个步骤：

**1-**创建一个“记录占位符”，为应用中的该特定表格记录命名

**2-**在触发器操作中加载（或创建）该记录

**3a-**若需更新记录中的单个字段，请将该表记录包含在“Then”语句中。

**3b-**若需针对表格记录中的值编写逻辑，请将该表格记录包含在“If”语句中

应用变量与表记录

在构建应用时，您可能需要决定某项特定数据应存储在变量中还是表记录中。

变量更适合存储与该特定应用的个人使用相关的数据。表则更适合存储需要被多个应用访问的数据。

表常用于跟踪以下概念：* 工作单* 单个产品的 SKU* 物料清单 (BOM)* 技能矩阵* ……等等

在阅读本文之前，建议您先阅读《表格概述》，以全面了解表格的功能。

步骤 1——创建记录占位符

首先，您需要在将要访问该表记录的应用中创建一个**“记录占位符”**。这些占位符用于存放稍后将在触发器逻辑中动态加载的记录。

例如，如果您想在应用中编辑“工作单”表中的某条记录，可能会创建一个名为“活跃工作单”的记录占位符。

随后，您将根据操作员的输入动态加载一条记录，但该记录始终会被称为“Active Work Order”

要设置这些占位符，请点击“步骤列表”旁边的“记录”选项卡。

然后选择“添加表”。接下来，点击“添加记录占位符”。您可以为将从触发器动态加载的记录命名（例如“活动工作单”）。

请注意有一个“保存以供分析”的设置。选中后，系统会将加载到此记录占位符中的表格记录保存到应用的完成记录中。

步骤 2——在触发器编辑器中访问记录

创建“记录占位符”后，您现在可以编写逻辑，根据操作员的输入动态加载或创建记录。

您可以使用“表记录”和“数据操作”触发器操作来实现这一点。具体操作如下。

添加“Then”语句

您可以通过多种类型的触发器操作来读取或修改表记录。以下是简要总结。

**表记录/加载记录：**加载具有特定 ID 的现有记录

**表记录/加载记录：**加载具有特定 ID 的现有记录

**表记录/创建或加载记录：**如果不存在具有特定 ID 的记录，则创建该记录；否则，加载具有特定 ID 的记录。

加载现有记录

要读取或编辑记录，您必须先将该记录加载到应用程序中，并为其指定一个占位符名称。此操作通常由步骤打开或按钮点击触发。

每次只能加载一条记录，且必须使用唯一 ID（表格的第一个字段，文本值）来选择该记录。

请使用“表记录”中的“加载记录”语句来实现此操作。

{height="" width="600px"}* “表记录”* “加载记录”* 按 ID： “text” - 0146* 加载到 “active_wo” 占位符中

在此示例中，工作订单表中已存在一个 ID 为“0146”的记录。

由于每个表中的“ID”字段均为文本字段，因此必须使用文本来访问单个记录。您可以使用所有常规选项来选择 ID：

• 表记录
• 表达式
• 静态值
• 应用信息
• 变量

以下是一个使用变量的示例：

• “表格记录”
• “加载记录”
• 按 ID："变量"
• "text_wo_id"
• 导入到：“有效工作单”

创建新记录

若要在表中创建新记录，必须使用“创建”或“创建或加载”选项。

如果使用“创建”，您必须创建一个 ID 在表中尚未存在的新记录**。**如果该记录在表中已存在，应用程序将抛出错误。

如果您使用“创建或加载”，如果该 ID 的记录已存在，则加载该记录；如果该 ID 在表中不存在，则创建新记录。

在此示例中，我们使用 ID “123” 来创建一条新记录。

• “表记录” “创建记录”
• 按 ID： “静态值” “文本” “123”
• 目标表：“活跃工单”

通常，您必须在此字段中使用动态值（如变量），因为每次操作员使用该应用时，您都希望生成一个新值。

步骤 3a——在触发器编辑器中编辑记录

要编辑记录，请使用“数据操作”操作，然后使用“存储”来编辑或更新记录中的值。

要编辑记录，您必须已通过“表记录”>“加载”或“表记录”>“创建”将其加载为记录占位符。

以下是一个示例，您将更新已加载为“active_wo”的记录中的“status”字段。

• “数据操作”
• “存储”
• “文本”："通过"
• "表记录" “active_wo”
• 字段：“status”

通常会使用小部件触发器来实现这一点，例如，当操作员按下按钮以指示发生变化时。

您还可以增量更新表记录中的某个值。请参阅此库存表指南以了解具体方法

步骤 3b——在表记录中使用条件逻辑

您可能还希望根据特定记录中某个字段的值来更改应用逻辑。

要实现这一点，请确保已加载一条记录。然后，从该记录中选择一个字段，并使用与其他“if”语句相同的逻辑。

*表记录：*检查已加载表记录中某个字段是否包含特定值。

{height="" width=""}* “表记录” “active_wo” “status”* “包含”* "静态值" "text" "通过"

*表：*检查表中是否已存在具有特定 ID 的记录。

• "表" "工作单" "是否存在 ID 为" "静态值" "文本" "001"

以下是创建一条错误消息的方法，该消息会提示操作员输入不同的工单号。

IF* "表" "工作订单" "存在ID为"* "静态值" "文本" "024dfg45"

THEN* "显示错误" "静态值" "文本" "该工单已存在，请输入新的工单号"。

第 4 步——在步骤中显示表记录

要将此记录添加到步骤中，请在小部件菜单的“文本”按钮下选择“表记录”选项。

在上下文窗格的“控件”选项卡中，从“记录”旁边的选项中选择您的记录占位符，即可在播放器中查看该记录。

这通常用于向操作员显示工作单详细信息等。

要重新排列或从显示中删除单个字段，请单击“上下文窗格”中该属性的“x”或网格符号。

要更改列数，请使用侧边窗格中的“列”选项。

要更改标签和值的显示方式，请在侧边窗格中调整颜色和字体大小。

要查看操作员将如何看到这些数据，请在播放器中运行该应用程序，您将能够看到整个表记录。如果您先加载一条记录，则会包含相关值。

清除记录占位符

有时，您可能需要清除记录占位符，以便该记录占位符下不加载任何特定记录到应用程序中。

操作方法如下：

• “表记录” “清除记录占位符”

删除记录占位符

要删除记录占位符，请从屏幕左侧的“记录列表”中选择该占位符。在下图示例中，您需要选择“Active Work Order”。

然后，从弹出的菜单中选择“删除”。

显示用户及其字段

您还可以为用户及其关联字段创建一个Record Placeholder ，然后通过该 加载特定用户。更多详细信息，请参阅关于用户字段的单独指南。

进一步阅读

• 创建您的第一个表格（分步指南）：关于如何将表格与应用结合使用的完整分步指南
• 在应用中显示记录列表：使用交互式表格控件一次性显示大量表格记录

您找到想要的内容了吗？

您也可以访问community.tulip.co发布问题，或查看其他人是否遇到过类似问题！