“应用完成”是长期存储 Tulip 应用数据的一种方式。本文将向您展示具体操作方法。
通过本文,您将了解:* 为何您的应用应设置“完成”按钮* 不同类型的应用完成触发条件* 应用完成或取消时会保存哪些数据* 应用完成的最佳实践
Read more about [completions](/r230/docs/<span translate=)">Completions data.
如何完成应用
要保存 Tulip 应用中的信息,操作员必须“完成该应用”。为此,您需要在应用中添加一个“完成”按钮。
每当操作员点击“完成”按钮时,“完成记录”标签页中就会新增一行记录。每行记录包含以下信息:
- 应用完成信息,例如站点名称、操作员的徽章 ID 以及应用的开始和结束日期/时间。
- 应用程序完成时所有变量及其值。
- 可选:选择将完成时已加载到应用中的任何表记录包含并存储
应用程序中定义的每个变量(例如条形码、操作员登录状态、耗时、检查结果)都将在该视图中作为一列显示。当操作员“完成应用程序”时,您将在列表中创建另一行。
当您“完成”一个应用程序时,所有表单步骤中的值都会被存储并清空。
事实上,如果您导航至每个应用程序的“完成”选项卡,您将看到的就是这些内容。

当操作员完成一个应用后,有几种方法可以“完成该应用”。
您可以使用应用程序编辑器中内置的“完成”按钮,或者构建一个带有“完成应用程序”过渡效果的自定义触发器。
“完成”按钮
从工具栏中选择**“按钮**”,然后选择**“完成**”。

您可以通过“添加新过渡”按钮手动添加应用完成过渡:

使用自定义触发器:
在上例中,“完成”按钮的逻辑默认设置为:
- 当“按钮被按下时”;
- 则,“应用” → “完成应用”。

不过,您可以将此过渡效果添加到任何对应于工作流结尾的触发器中。例如:

- 当,“设备”、“GPIO”在“此站点”输出,且事件为“引脚低电平”时
- 如果,“设备输出”的“引脚”状态为“静态值”的“整数”值“2”
- **则,“**应用” “完成应用”
在此示例中,任何物联网设备若在此步骤向 GPIO I/O 网关的第 2 引脚发送“引脚低电平”信号,都将导致应用完成。
除了“完成应用”之外,还有另外两个选项:
完成后切换至:完成该应用后切换至另一个应用。
“完成后切换到步骤”:完成该应用后,切换到同一应用内的另一个步骤,或切换到另一个应用中的特定步骤。
**“完成并转至启动画面”:**完成该应用后转至其启动画面。在操作员按下“开始”按钮之前,应用不会启动。
**“完成并注销当前用户”:**完成应用后注销当前用户
“完成后按名称切换应用”:完成该应用后,转至另一个应用;该应用可通过变量中的应用值等进行指定。
**完成并跳转至指定步骤:**完成应用程序后,跳转至同一应用程序中的另一个步骤,该步骤可通过变量等形式从应用程序中获取的值进行指定。
注意:应用程序仅在通过Tulip Player运行时才能完成**。**当应用程序完成时,操作员将看到如下所示的消息。

取消应用程序
假设您不希望保存本次应用使用产生的数据。在这种情况下,您需要“取消应用”并可能返回某个特定步骤。这将清除自应用上次打开以来产生的所有数据。
有 5 个触发过渡,它们与应用完成触发过渡直接对应:

- 取消应用
- 取消后转至
- 取消后转至步骤
- 取消并转至启动画面
- 取消并注销当前用户
应用完成的技术细节
以下是每次应用完成或取消时自动保存的所有数据点:
- **开始时间:**操作员打开第一个步骤的日期和时间
- **结束时间:**操作员点击“完成”或“取消”按钮的日期和时间
- **持续时间:**开始时间与结束时间之间的时间间隔
- **登录用户:**基于登录 Tulip Player 人员的工牌 ID
- **工位名称:**应用使用所在工位的名称,由“车间”选项卡确定
- **备注:**在 Player 菜单中针对该应用整体所做的任何备注
- **版本:**应用完成时的版本号
- **已取消:**该应用程序是否已被取消
- **执行 ID:**该应用特定运行的唯一标识符
- **最后查看的步骤名称:**用户完成或取消该应用程序前最后查看的步骤名称
最佳实践
在车间设置中,通常会在工位组级别或特定工位上分配应用的“最新发布版本”。
为了使工位开始运行最新发布的版本,必须满足以下条件之一:
- 通过**“菜单**/重启应用程序”重启该应用程序。
- 使用“应用程序 / 完成应用程序...”过渡。
- 使用“应用 / 取消应用...”过渡。
因此,最佳实践是确保您的 Tulip 应用在使用过程中某个环节使用此类过渡。
:::(警告) (在无头应用中使用“应用 / 完成应用”)
如果您正在使用“无头应用”(例如用于运行“机器与设备”触发器),请考虑添加一个定时器触发器,以定期执行“应用 / 完成应用”过渡。
只要将 Tulip Station 分配给“最近的published version ”,这将确保应用在该最近的published version 上运行,同时还能缓解潜在内存泄漏可能引发的问题。
:::
从应用完成记录中删除数据
为了符合 GxP 生产标准,Tulip 中的数据无法被删除。
不过,有一个变通方法:您可以复制该应用并删除旧的,这样就会得到一个没有条目的新表。
在“分析”中隐藏完成数据
您可能希望将“完成”选项卡中的某些数据从分析中排除。现在,您可以通过在“完成”选项卡中找到需要排除的记录,并取消勾选“包含在分析中”复选框来实现。这将过滤分析结果,使其不包含该记录。

将该记录从分析中排除不会将其从“完成”数据中移除,因此该数据的导出操作不会受到影响。
