提交窗体

已完成

使用窗体控件的最后一步是提交编辑。 为此,我们将使用 SubmitForm 函数。 通常在标记为保存提交按钮控件中添加此函数。 OnSelect 公式为 SubmitForm(YourFormName)

此函数提取在数据卡控件中输入的所有数据并将数据保存到窗体控件的数据源。 在调用 SubmitForm 时要写入数据源的公式窗体中,窗体控件上的每个数据卡均具有用于指定数据的 Update 属性。 如已解锁卡,可以修改此公式。 除特殊情况以外,通常无需修改公式。

重要提示

开始修改卡片公式时,您需要匹配源所需的数据类型,否则您可能会收到错误,并且数据输入可能无法正确保存。

提交窗体后

窗体控件易于使用,因为调用 SubmitForm 函数即可迅速提取数据并更新数据源。 窗体控件包含三个在提交数据后根据提交结果进行处理的属性。 这三个属性分别为 OnSuccessOnFailureOnReset。 此外,LastSubmit 属性还为您提供从窗体提交的数据的记录。

注意

如果要提交窗体来执行其他操作(例如导航到另一个屏幕),请将编码添加到这三个窗体属性之一。 不要向任何调用 SubmitForm 操作的按钮、图标或函数添加其他代码。

可以为每个属性输入公式。 例如,要让用户在成功提交数据后转到其他屏幕,可以在 OnSuccess 中使用函数 Navigate(SuccessScreen, ScreenTransition.Cover) 将用户转到名为 SuccessScreen 的屏幕。

OnFailure 属性

如果提交数据时出错,请使用 OnFailure 属性。 您可以使用公式指定失败时显示的警告消息。 以下示例公式展示使用 Notify 函数为用户提供更多信息。

Notify("Your data was not saved. Please try again or contact an administrator.", NotificationType.Error)

此函数在屏幕顶部显示红色警告,消息内容为“数据未保存。 请重试或联系管理员。”此消息有助于用户轻松解决问题。

OnReset 属性

窗体重置时使用 OnReset 属性。 使用 ResetForm 函数时重置窗体。 ResetForm 函数将窗体重新设置为默认值,然后运行 OnReset 属性中指定的所有公式。 例如,要重置用于与窗体交互的变量计时器控件时。

LastSubmit 属性

成功提交窗体后,可以直接引用提交的记录。 使用包含整条记录的 LastSubmit 属性可以获得最后提交的记录。 要访问记录,可以使用公式 FormName.LastSubmit(将 FormName 替换为您的窗体名称)。 您还可以在应用中插入标签控件,然后使用诸如 FormName.LastSubmit.ID 之类的公式返回最后提交的记录的 ID 属性,从而访问 LastSubmit 记录中的元素。 开始构建关系数据时,您需要知道上次提交窗体时的值,此时了解 LastSubmit 概念会非常有用。

在下一单元中,我们将讨论窗体控件的一些有价值的特殊属性。