刷新数据源记录并清除错误。

说明

Revert 函数可用于刷新整个数据源或者数据源中的单个记录。 这样你就可以看到其他用户进行的更改。

对于还原的记录,Revert 还可以从返回了 Errors 函数的中清除所有错误。

如果 Errors 函数在执行 Patch 或其他数据操作后报告了冲突,则还原记录,从冲突版本开始并重新应用更改。

Revert 函数没有返回值。 只能在行为公式中使用。

语法

Revert( DataSource [, Record ] )

  • DataSource – 必需。 要还原的数据源。
  • Record - 可选。 要还原的记录。 如果不指定记录,则会还原整个数据源。

示例

在本例中,你将还原名为 IceCream 的数据源,这个数据源刚开始包含下表中的数据:

另一个设备上的用户将 Strawberry 记录的 Quantity 属性改成了 400。 几乎在同一时间,你将同一条记录的同一个属性改成了 500,但不知道他人也进行了更改。

随后你使用 Patch 函数更新记录:
Patch( IceCream, First( Filter( IceCream, Flavor = "Strawberry" ) ), { Quantity: 500 } )

当你检查 Errors 表时,发现了如下错误:

记录 消息 错误
{ ID: 1, Flavor: "Strawberry", Quantity: 300 } blank “另一个用户修改了你尝试修改的记录。请还原记录,然后重试。” ErrorKind.Conflict

根据 Error 列中的内容,你可以看到一个“重新加载”按钮,其 OnSelect 属性设置为以下公式:
Revert( IceCream, First( Filter( IceCream, Flavor = "Strawberry" ) ) )

选择“重新加载”按钮后,Errors 表变为空白,并且 Strawberry 的新值已加载:

完成上述更改之后,你重新应用了更改,这次成功了,因为已经解决了冲突。