Funkcie EditForm, NewForm, SubmitForm, ResetForm a ViewForm v službe PowerAppsEditForm, NewForm, SubmitForm, ResetForm, and ViewForm functions in PowerApps

Slúžia na zobrazenie, úpravy a vytváranie položiek, ukladanie obsahu a obnovenie ovládacích prvkov v ovládacom prvku Formulár na úpravy.View, edit, or create an item, save the contents, and reset the controls in an Edit form control.

PrehľadOverview

Tieto funkcie zmenia stav ovládacieho prvku Formulár na úpravy.These functions change the state of the Edit form control. Ovládací prvok formulára môže byť v jednom z týchto režime:The form control can be in one of these modes:

RežimMode PopisDescription
FormMode.EditFormMode.Edit Formulár sa naplní existujúcim záznamom a používateľ môže upraviť hodnoty polí.The form is populated with an existing record and the user can modify the values of the fields. Po dokončení môže používateľ zmeny záznamu uložiť.Once complete, the user can save the changes to the record.
FormMode.NewFormMode.New Formulár sa naplní predvolenými hodnotami a používateľ môže upraviť hodnoty polí.The form is populates with default values and the user can modify the values of the fields. Po dokončení môže používať pridať záznam do zdroja údajov.Once complete, the user can add the record to the data source.
FormMode.ViewFormMode.View Formulár sa naplní existujúcim záznamom, alebo používateľ nemôže upravovať hodnoty polí.The form is populated with an existing record but the user cannot modify the values of the fields.

PopisDescription

Tieto funkcie sa často volajú zo vzorca OnSelect ovládacieho prvku Tlačidlo alebo Obrázok, aby používateľ mohol ukladať a zahodiť úpravy alebo vytvoriť záznam.These functions are often invoked from the OnSelect formula of a Button or Image control so that the user can save edits, abandon edits, or create a record. Ovládacie prvky môžete použiť spoločne s týmito funkciami a vytvoriť tak kompletné riešenie.You can use controls and these functions together to create a complete solution.

Tieto funkcie nevracajú žiadnu hodnotu.These functions return no values.

SubmitFormSubmitForm

Funkcia SubmitForm vo vlastnosti OnSelect ovládacieho prvku Tlačidlo slúži na ukladanie všetkých zmien v ovládacom prvku Form do zdroja údajov.Use the SubmitForm function in the OnSelect property of a Button control to save any changes in a Form control to the data source.

Pred odoslaním akýchkoľvek zmien táto funkcia skontroluje problémy s overením v prípade všetkých polí, ktoré sú označené ako povinné alebo ktorých hodnota má nastavené nejaké obmedzenie.Before submitting any changes, this function checks for validation issues with any field that's marked as required or that has one or more constraints on its value. Toto správanie sa zhoduje so správaním funkcie Validate.This behavior matches that of the Validate function.

Funkcia SubmitForm tiež skontroluje vlastnosť Valid ovládacieho prvku Formulár, ktorá predstavuje agregáciu všetkých vlastností Valid ovládacích prvkov Karta v ovládacom prvku Formulár.SubmitForm also checks the Valid property of the Form, which is an aggregation of all the Valid properties of the Card controls that the Form control contains. Ak dôjde k problému, údaje sa neodošlú a vlastnosti Error a ErrorKind ovládacieho prvku Formulár sa nastavia zodpovedajúcim spôsobom.If a problem occurs, the data isn't submitted, and the Error and ErrorKind properties of the Form control are set accordingly.

V prípade úspešného overenia odošle funkcia SubmitForm zmenu do zdroja údajov.If validation passes, SubmitForm submits the change to the data source.

  • V prípade úspechu sa v prípade ovládacieho prvku Formulár spustí akcia OnSuccess a vlastnosti Error a ErrorKind sa vymažú.If successful, the Form's OnSuccess behavior runs, and the Error and ErrorKind properties are cleared. Ak bol formulár v režime FormMode.New, vráti sa späť do režimu FormMode.Edit.If the form was in FormMode.New mode, it is returned to FormMode.Edit mode.
  • V prípade neúspechu sa v prípade ovládacieho prvku Formulár spustí akcia OnFailure a vlastnosti Error a ErrorKind sa nastavia zodpovedajúcim spôsobom.If unsuccessful, the Form's OnFailure behavior runs, and the Error and ErrorKind properties are set accordingly. Režim formulára zostane bez zmeny.The mode of the form is unchanged.

EditFormEditForm

Funkcia EditForm zmení režim ovládacieho prvku Formulár na hodnotu FormMode.Edit.The EditForm function changes the Form control's mode to FormMode.Edit. V tomto režime slúži obsah vlastnosti Item ovládacieho prvku Formulár na naplnenie formulára.In this mode, the contents of the Form control's Item property are used to populate the form. Ak sa spustí funkcia SubmitForm v prípade formulára v tomto režime, záznam sa nevytvorí, ale zmení.If the SubmitForm function runs when the form is in this mode, a record is changed, not created. FormMode.Edit je predvolený režim ovládacieho prvku Formulár.FormMode.Edit is the default for the Form control.

NewFormNewForm

Funkcia NewForm zmení režim ovládacieho prvku Formulár na hodnotu FormMode.New.The NewForm function changes the Form control's mode to FormMode.New. V tomto režime sa obsah vlastnosti Item ovládacieho prvku Formulár ignoruje a formulár sa naplní predvolenými hodnotami vlastnosti Zdroj údajov ovládacieho prvku Formulár.In this mode, the contents of the Form control's Item property are ignored, and the default values of the Form's DataSource property populate the form. Ak sa spustí funkcia SubmitForm v prípade formulára v tomto režime, záznam sa nezmení, ale vytvorí.If the SubmitForm function runs when the form is in this mode, a record is created, not changed.

ResetFormResetForm

Než používateľ vykoná zmeny, funkcia ResetForm obnoví obsah formulára na pôvodné hodnoty.The ResetForm function resets the contents of a form to their initial values, before the user made any changes. Ak je formulár v režime FormMode.New, obnoví sa na režim FormMode.Edit.If the form is in FormMode.New mode, the form is reset to FormMode.Edit mode. Spustí sa tiež akcia OnReset ovládacieho prvku formulára.The OnReset behavior of the form control also runs. Pomocou funkcie Reset môžete tiež obnoviť jednotlivé ovládacie prvky, ale iba v rámci formulára.You can also reset individual controls with the Reset function but only from within the form.

ViewFormViewForm

Funkcia ViewForm zmení režim ovládacieho prvku Formulár na hodnotu FormMode.View.The ViewForm function changes the Form control's mode to FormMode.View. V tomto režime slúži obsah vlastnosti Item ovládacieho prvku Formulár na naplnenie formulára.In this mode, the contents of the Form control's Item property are used to populate the form. V tomto režime nemajú funkcie SubmitForm a RestForm žiadny vplyv.The SubmitForm and RestForm functions have no effect when in this mode.

Vlastnosť DisplayModeDisplayMode Poperty

Aktuálny režim je možné čítať prostredníctvom vlastnosti Mode.The current mode can be read through the Mode property. Tento režim tiež určuje hodnotu vlastnosti DisplayMode, ktorú môžu používať údajové karty a ovládacie prvky v rámci ovládacieho prvku formulára.The mode also determines the value of the DisplayMode property which can be used by data cards and controls within the form control. Vlastnosť DisplayMode údajovej karty sa často nastaví na hodnotu Parent.DisplayMode (odkazujúcu na formulár) rovnako ako vlastnosť DisplayMode ovládacieho prvku (odkazujúcu na údajovú kartu):Often, the data card's DisplayMode property will be set to Parent.DisplayMode (refernceing the form) as will the control's DisplayMode property (referncing the data card):

RežimMode DisplayModeDisplayMode PopisDescription
FormMode.EditFormMode.Edit DisplayMode.EditDisplayMode.Edit Údajové karty a ovládacie prvky sa dajú upravovať, je možné urobiť zmeny v zázname.Data cards and controls are editable, ready to accept changes to a record.
FormMode.NewFormMode.New DisplayMode.EditDisplayMode.Edit Údajové karty a ovládacie prvky sa dajú upravovať, je možné vytvoriť nový záznam.Data cards and controls are editable, ready to accept a new record.
FormMode.ViewFormMode.View DisplayMode.ViewDisplayMode.View Údajové karty a ovládacie prvky sa nedajú upravovať, sú optimalizované na zobrazenie.Data cards and controls are not editable and optimized for viewing.

SyntaxSyntax

SubmitForm( NázovFormulára )SubmitForm( FormName )

  • NázovFormulára – povinné.FormName - Required. Ovládací prvok formulára na odoslanie do zdroja údajov.Form control to submit to the data source.

EditForm( NázovFormulára )EditForm( FormName )

  • NázovFormulára – povinné.FormName - Required. Ovládací prvok formulára na prepnutie do režimu FormMode.Edit.Form control to switch to FormMode.Edit mode.

NewForm( NázovFormulára )NewForm( FormName )

  • NázovFormulára – povinné.FormName - Required. Ovládací prvok formulára na prepnutie do režimu FormMode.New.Form control to switch to FormMode.New mode.

ResetForm( NázovFormulára )ResetForm( FormName )

  • NázovFormulára – povinné.FormName - Required. Ovládací prvok formulára na obnovenie na počiatočné hodnoty.Form control to reset to initial values. Tiež prepína formulár z režimu FormMode.New do režimu FormMode.Edit.Also switches the form from FormMode.New mode to FormMode.Edit mode.

ViewForm( NázovFormulára )ViewForm( FormName )

  • NázovFormulára – povinné.FormName - Required. Ovládací prvok formulára na prepnutie do režimu FormMode.View.Form control to switch to FormMode.View mode.

PríkladyExamples

Úplné príklady nájdete v článku Princípy údajových formulárov.See Understand data forms for complete examples.

  1. Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na hodnotu Save a nastavte jeho vlastnosť OnSelect na tento vzorec:Add a Button control, set its Text property to show Save, and set its OnSelect property to this formula:

    SubmitForm( EditForm )SubmitForm( EditForm )

  2. Nastavte vlastnosť OnFailure ovládacieho prvku Formulár na prázdnu hodnotu a jeho vlastnosť OnSuccess na tento vzorec:Set the OnFailure property of a Form control to blank and its OnSuccess property to this formula:

    Back()Back()

  3. Pomenujte ovládací prvok Označenie ako ErrorText a nastavte jeho vlastnosť Text na tento vzorec:Name a Label control ErrorText, and set its Text property to this formula:

    EditForm.ErrorEditForm.Error

    Keď používateľ vyberie tlačidlo Save, všetky zmeny v ovládacom prvku Formulár sa pošlú do podkladového zdroja údajov.When the user selects the Save button, any changes in the Form control are submitted to the underlying data source.

    • Ak sa odoslanie podarí, všetky zmeny sa uložia, alebo v prípade, že je ovládací prvok Formulár v režime New, vytvorí sa záznam.If the submission succeeds, any changes are saved or, if the Form control is in New mode, a record is created. Vlastnosť ErrorText je prázdna a znova sa objaví predchádzajúca obrazovka.ErrorText is blank and the previous screen reappears.
    • Ak sa odoslanie nepodarí, ErrorText zobrazí prívetivé chybové hlásenie a aktuálna obrazovka zostane zobrazená, aby používateľ mohol opraviť problém a akciu zopakovať.If the submission fails, ErrorText shows a user-friendly error message, and the current screen remains visible so that the user can correct the problem and try again.
  4. Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na Cancel a vlastnosť OnSelect nastavte na tento vzorec:Add a Button control, set its Text property to show Cancel, and set its OnSelect property to this formula:

    ResetForm( EditForm ); Back()ResetForm( EditForm ); Back()

    Keď používateľ vyberie tlačidlo Cancel, hodnoty v ovládacom prvku Formulár sa obnovia na hodnoty, ktoré ovládací prvok obsahoval pred tým, než používateľ začal s úpravami. Znova sa objaví predchádzajúca obrazovka a ovládací prvok Formulár sa vráti do režimu Edit v prípade, že bol v režime New.When the user selects the Cancel button, the values in the Form control are reset to what they were before the user started to edit it, the previous screen reappears, and the Form control is returned to Edit mode if it was in New mode.

  5. Pridajte ovládací prvok Tlačidlo, nastavte jeho vlastnosť Text na hodnotu New a nastavte jeho vlastnosť OnSelect na tento vzorec:Add a Button control, set its Text property to show New, and set its OnSelect property to this formula:

    NewForm( EditForm ); Navigate( EditScreen, None )NewForm( EditForm ); Navigate( EditScreen, None )

    Keď používateľ vyberie tlačidlo New, ovládací prvok Formulár sa prepne do režimu New a naplní sa predvolenými hodnotami zo zdroja údajov a zobrazí sa obrazovka obsahujúca tento ovládací prvok.When the user selects the New button, the Form control switches to New mode, the default values for the Form control's data source populate that control, and the screen that contains the Form control appears. Pri spustení funkcie SubmitForm sa záznam neaktualizuje, ale vytvorí sa nový.When the SubmitForm function runs, a record is created instead of updated.