事务

Transaction（事务）动作可向接入点企业应用程序发送数据或从接入点企业应用程序接收数据。

对于导致数据从企业应用程序流出的事务（例如数据库选择操作或存储过程），触发器的 Output（输出）选项卡将返回输出变量。

参数描述

参数	描述
Transport Map（传输映射）	使用 Transport Map（传输映射）下拉列表可选择在节点上定义的传输映射。例如，MATERIAL_LOT_INSERT 支持 SQL 插入操作。 Input（输入）选项卡将以传输映射 MATERIAL_LOT_INSERT 中映射变量的名称填充请注意 col_LOT_ID、col_DESCRIPTION 等名称。这些是定义传输映射时定义的映射变量。
Use LUW（使用 LUW）	仅当在 Transport Map（传输映射）选择列表中选择了数据库传输映射时，才显示此字段。可用于指示 Transaction（事务）是逻辑工作单元的一部分。通过执行 Logical Unit of Work Begin（逻辑工作单元开始）动作可获取 36 个字符的 LUWId。选项包括 True 和 False。 False - 此为默认值。选定后，Input（输入）选项卡将不显示 LUWId 参数。 True - 选定后，Input（输入）选项卡将显示 LUWId 参数设置的元素数。

参数

描述

Transport Map（传输映射）

使用 Transport Map（传输映射）下拉列表可选择在节点上定义的传输映射。

例如，MATERIAL_LOT_INSERT 支持 SQL 插入操作。
Input（输入）选项卡将以传输映射 MATERIAL_LOT_INSERT 中映射变量的名称填充

请注意 col_LOT_ID、col_DESCRIPTION 等名称。这些是定义传输映射时定义的映射变量。

Use LUW（使用 LUW）

仅当在 Transport Map（传输映射）选择列表中选择了数据库传输映射时，才显示此字段。可用于指示 Transaction（事务）是逻辑工作单元的一部分。通过执行 Logical Unit of Work Begin（逻辑工作单元开始）动作可获取 36 个字符的 LUWId。

选项包括 True 和 False。

False - 此为默认值。选定后，Input（输入）选项卡将不显示 LUWId 参数。
True - 选定后，Input（输入）选项卡将显示 LUWId 参数

设置的元素数。

输入选项卡

在 Input（输入）选项卡上，可将触发器中的变量与传输映射中定义的映射变量进行关联。为此，您可以选择局部变量、静态变量、事件变量、设备变量或宏变量，或在 Value（值）列中输入常量。

参数	描述
Input Variables（输入变量）	Input（输入）选项卡上的参数将基于传输映射的定义显示。例如，用于数据库插入操作的传输映射将具有每个数据库表列的映射变量。

输入选项卡示例

选择了设备变量、宏和常量的已完成 Input（输入）选项卡可能如下所示：

在此事务动作示例中，每次执行触发器时，都会将触发器中的变量插入至 MATERIAL_LOT_INSERT 传输映射中标识的数据库表中。

输出选项卡

Output（输出）选项卡可以包含将用作事务输出的映射变量以及在执行传输映射后更新的其他输出变量。其他输出变量取决于正在使用的传输映射的类型。对于使用数据库操作的事务，（事务）动作的 Output（输出）选项卡提供 resultCount（结果计数）、resultStatus（结果状况）以及可选的 resultKey（结果键值）输出变量。

输出	描述
Output variables（输出变量）
resultStatus	提供一个返回值，用于指示动作成功。0 表示动作成功。
resultCount	提供一个返回值，用于指示从数据库插入、更新、选择和存储过程操作的结果中处理的行数。
resultKey	此 INT8 字段仅可用于数据库 INSERT 事务动作。其中将包含使用 $GENERATED 宏的事务成功执行后自动生成的列的值。

包含输出变量的输出选项卡示例

Output（输出）选项卡还将包含传输映射中定义的变量：

如果已选择针对数据库的选择或存储过程操作所定义的传输映射，Output（输出）选项卡将包含在传输映射的 Output（输出）选项卡中定义的输出变量。这意味着数据库数据值将从事务动作中输出，并且可以通过在 Value（值）列中选择变量来映射至变量。

另一个示例所示为 Output（输出）选项卡，其中包含一个输出变量以及与 PLC 设备变量关联的 resultStatus（结果状况）和 resultCount（结果计数）变量。

路径选项卡

Transaction（事务）动作将具有 Store and Forward（存储和转发）的 On Result（基于结果）行，可用于 Transaction（事务）动作，其中所引用的传输映射将引用可支持存储和转发函数的传输。

基于结果	描述
Success（成功）	成功完成动作后所要采用的路径。
Failure（失败）	动作完成失败时所要采用的路径。
Store and Forward（存储和转发）	在 Transaction（事务）动作的结果是将事务数据写入存储和转发队列的情况下所采用的路径。与事务动作的传输映射关联的传输必须具备存储和转发功能，并且必须启用该功能。有关传输以及如何启用存储和转发的信息，请参见传输。使用画布编辑器时，Transaction（事务）动作会有相应的输出端口（路径）用于存储和转发结果。