Formular übermitteln

  • 7 Minuten

Der letzte Schritt bei der Arbeit mit einem Formular-Steuerelement ist das Einreichen der Änderungen. Hierzu verwenden wir die Funktion SubmitForm. Diese Funktion wird häufig in einem Steuerelement Schaltfläche namens Speichern oder Übermitteln platziert. Die Formel für OnSelect lautet SubmitForm(YourFormName).

Diese Funktion erfasst alle Daten, die in den Steuerelementen Ihrer Datenkarten eingegeben wurden, und speichert sie in der Datenquelle für das Formular-Steuerelement. Jede Datenkarte in Ihrem Steuerelement Formular verfügt über eine Eigenschaft Update, die die Daten in Formelform angibt, die zur Datenquelle geschrieben werden, wenn SubmitForm aufgerufen wird. Wenn Sie Ihre Karte entsperrt haben, können Sie diese Formel ändern. Dies ist häufig nicht erforderlich und erfolgt nur unter besonderen Umständen.

Wichtig

Wenn Sie damit beginnen, Kartenformeln zu bearbeiten, müssen Sie den Datentyp anpassen, den Ihre Quelle erwartet. Andernfalls erhalten Sie möglicherweise eine Fehlermeldung, und Ihre Dateneingabe wird möglicherweise nicht ordnungsgemäß gespeichert.

Nach dem Übermitteln des Formulars

Das Formular-Steuerelement ist einfach zu verwenden, da nach einem Klick auf die Funktion SubmitForm Ihre Daten sofort weitergeleitet werden und Ihre Datenquelle aktualisiert wird. Das Formular-Steuerelement weist drei Eigenschaften auf, die nach dem Übermitteln der Daten entsprechend der Ausgabe der Übermittlung verarbeitet werden. Diese Eigenschaften sind OnSuccess, OnFailure und OnReset. Zudem bietet Ihnen die Eigenschaft LastSubmit einen Datensatz dazu, welche Daten über das Formular übermittelt wurden.

Hinweis

Wenn Sie mit dem Absenden Ihres Formulars etwas anderes tun möchten, zum Beispiel um zu einem anderen Bildschirm zu navigieren, fügen Sie den Code in eine dieser drei Formulareigenschaften ein. Fügen Sie den Schaltflächen, Symbolen oder Funktionen, die die Aktion SubmitForm aufrufen, keinen zusätzlichen Code hinzu.

Für jede dieser Eigenschaften können Sie eine Formel eingeben. Wenn Sie z.B. möchten, dass Benutzer nach dem erfolgreichen Übermitteln ihrer Daten zu einem anderen Bildschirm weitergeleitet werden, verwenden Sie in OnSuccess die Funktion Navigate(SuccessScreen, ScreenTransition.Cover), um die Benutzer zum Bildschirm namens SuccessScreen weiterzuleiten.

Eigenschaft „OnFailure“

Verwenden Sie die Eigenschaft OnFailure, wenn beim Übermitteln der Daten ein Fehler auftritt. Sie können eine Formel verwenden, um eine Warnmeldung anzugeben, die bei einem Fehler angezeigt wird. Die folgende Formel ist ein Beispiel für die Verwendung der Notify-Funktion, um dem Benutzer weitere Informationen bereitzustellen.

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

Diese Funktion zeigt am oberen Rand des Bildschirms eine rote Warnung mit folgender Meldung an: „Ihre Daten wurden nicht gespeichert. Versuchen Sie es nochmal, oder wenden Sie sich an einen Administrator.“ Diese Meldung hilft den Benutzern beim Lösen des Problems.

Eigenschaft „OnReset“

Verwenden Sie die Eigenschaft OnReset, wenn das Formular zurückgesetzt wurde. Ein Formular wird zurückgesetzt, wenn die Funktion ResetForm verwendet wird. Die Funktion ResetForm setzt das Formular auf seine Standardwerte zurück und führt dann eine Formel aus, die in der Eigenschaft OnReset festgelegt wurde. Diese Funktion können Sie beispielsweise nutzen, wenn Sie ein Steuerelement Variable oder Zeitgeber zurücksetzen möchten, das während der Interaktion mit dem Formular verwendet wurde.

LastSubmit-Eigenschaft

Nachdem Ihr Formular erfolgreich übermittelt wurde, können Sie direkt auf den übermittelten Datensatz verweisen. Der letzte übermittelte Datensatz ist über die Eigenschaft LastSubmit verfügbar, die den gesamten Datensatz enthält. Sie können mit der Formelformula FormName.LastSubmit (ersetzen Sie den Namen Ihrer Formel mit FormName). Sie können auch auf ein Element des Datensatzes LastSubmit zugreifen, indem Sie ein Steuerelement Beschriftung in Ihre App einfügen und dann die Formel wie FormName.LastSubmit.ID des letzten mithilfe des Steuerelements IDübermittelten Datensatzes zurückzugeben. Das Verstehen von LastSubmit stellt ein leistungsstarkes Konzept dar, da Sie damit relationale Daten erstellen, bei denen Sie den Wert aus einer vorherigen Formularübermittlung kennen müssen.

In der nächsten Lerneinheit besprechen wir einige wertvolle Spezialeigenschaften des form-Steuerelements.