Revert 函式
適用於: 畫布應用
描述
Revert 函式會重新整理整個資料來源或該資料來源中的單一記錄。 您會看到其他使用者所做的變更。
針對已還原的記錄,Revert 也會清除 Errors 函式傳回的 資料表中之任何錯誤。
如果 Errors 函式在 Patch 或其他資料作業之後報告衝突,將記錄 Revert 至衝突版本開始,並重新套用變更。
還原沒有返回值。 您可以只能在 行為公式 中使用它。
語法
還原 ( DataSource [, 記錄 ])
- DataSource –必需。 您要還原的資料來源。
- record - 可選。 您要還原的記錄。 如果您未指定記錄,則會還原整個資料來源。
範例
在此範例中,您將還原名為 IceCream 的資料來源,其從這個資料表開始︰
另一個裝置上的使用者會將 Strawberry 中的 Quantity 屬性變更為 400。 在幾乎同一時間,您將同一筆記錄的相同屬性變更為 500,不知道其他變更。
您使用 Patch 函式來更新記錄︰
Patch (IceCream,LookUp(IceCream,Flavor =“草莓”), { 數量:500 } )
您檢查 Errors 資料表,並發現錯誤︰
記錄 | 列 | 訊息 | 錯誤 |
---|---|---|---|
{ ID:1,口味:草莓“,數量:300 } | 空白 | 「您嘗試修改的記錄已由其他使用者修改。 請還原記錄,然後再試一次。」 | ErrorKind.Conflict |
根據Error 行,您具有 OnSelect 屬性要設為此公式的 Reload 按鈕︰
還原 (IceCream,LookUp(IceCream,Flavor =“草莓”))
選取 Reload 按鈕後,Errors 資料表是 空白,並會載入Strawberry 的新值︰
您在先前的變更上重新套用您的變更,您因為衝突解決而成功變更。