Revert 函式

適用於: 畫布應用程式

重新載入 資料來源記錄,並清除其錯誤。

描述

Revert 函式會重新整理整個資料來源或該資料來源中的單一記錄。 您會看到其他使用者所做的變更。

針對已還原的記錄,Revert 也會清除 Errors 函式傳回的 資料表中之任何錯誤。

如果 Errors 函式在 Patch 或其他資料作業之後報告衝突,將記錄 Revert 至衝突版本開始,並重新套用變更。

Revert 沒有傳回值。 您可以只能在 行為公式 中使用它。

語法

Revert (DataSource [,Record ])

  • DataSource – 必要項目。 您要還原的資料來源。
  • Record - 非必要。 您要還原的記錄。 如果您未指定記錄,則會還原整個資料來源。

範例

在此範例中,您將還原名為 IceCream 的資料來源,其從這個資料表開始︰

IceCream 範例。

另一個裝置上的使用者會將 Strawberry 中的 Quantity 屬性變更為 400。 在幾乎同一時間,您將同一筆記錄的相同屬性變更為 500,不知道其他變更。

您使用 Patch 函式來更新記錄︰
Patch( IceCream, LookUp( IceCream, Flavor = "Strawberry" ), { Quantity: 500 } )

您檢查 Errors 資料表,並發現錯誤︰

記錄 訊息 錯誤
{ ID: 1, Flavor: "Strawberry", Quantity: 300 } 空白 「您嘗試修改的記錄已由其他使用者修改。 請還原記錄,然後再試一次。」 ErrorKind.Conflict

根據Error 行,您具有 OnSelect 屬性要設為此公式的 Reload 按鈕︰
Revert( IceCream, LookUp( IceCream, Flavor = "Strawberry" ) )

選取 Reload 按鈕後,Errors 資料表是 空白,並會載入Strawberry 的新值︰

草莓冰淇淋的新值。

您在先前的變更上重新套用您的變更,您因為衝突解決而成功變更。

重新套用變更並解決衝突。