EditForm, NewForm, SubmitForm, ResetForm ja ViewForm funktsioonid Power Appsis

Üksuse vaatamine, redigeerimine või loomine, sisu salvestamine ja juhtelementide lähtestamine juhtelemendis Edit form (Redigeeri vormi).

Ülevaade

Need funktsioonid muudavad juhtelemendi Edit form olekut. Vormi juhtelement võib olla ühes järgmistest olekutest.

Režiim Kirjeldus
FormMode.Edit Vorm on asustatud olemasoleva kirjega ja kasutaja saab väljade väärtusi muuta. Pärast lõpuleviimist saab kasutaja kirje muudatused salvestada.
FormMode.New Vorm on asustatud vaikeväärtustega ja kasutaja saab väljade väärtusi muuta. Pärast lõpuleviimist saab kasutaja lisada kirje andmeallikale.
FormMode.View Vorm on asustatud olemasoleva kirjega, kuid kasutaja ei saa väljade väärtusi muuta.

Kirjeldus

Need funktsioonid käivitatakse sageli valemiga OnSelect juhtelemendis Button või Image, nii et kasutaja saab salvestada muudatusi, neid hüljata või luua kirje. Täieliku lahenduse loomiseks saate kasutada juhtelemente ja funktsioone koos.

Need funktsioonid ei tagasta väärtusi.

Neid funktsioone saate kasutada ainult käitumise valemites.

SubmitForm

Juhtelemendi Form muudatuste salvestamiseks andmeallikasse kasutage funktsiooni SubmitForm nupu atribuudis OnSelect, et salvestada muudatused juhtelemendis Form andmeallikasse.

Enne muudatuste esitamist kontrollib see funktsioon valideerimise probleeme mis tahes väljaga, mis on märgitud nõutavana või millel on selle väärtuse jaoks üks või mitu piirangut. See käitumine sobib funktsiooni Validate omaga.

SubmitForm kontrollib ka vormi atribuuti Valid, mis on Valid atribuutide koondamine Card juhtelementides, mida Form juhtelement sisaldab. Kui ilmneb probleem, siis andmeid ei esitata ja juhtelemendi Form Error ja ErrorKind atribuudid määratakse vastavalt.

Kui valideerimine möödub, edastab SubmitForm muudatuse andmeallikasse.

  • Kui see on edukas, käivitub juhtelemendi Form käitumine OnSuccess ning Error ja ErrorKind atribuudid tühjendatakse. Kui vorm oli FormMode.New režiimis, viiakse see tagasi FormMode.Edit režiimile.
  • Kui ei õnnestu, siis käivitatakse Formi OnFailure käitumine ning Error ja ErrorKind atribuudid määratakse vastavalt.. Vormi režiimi ei muudeta.

EditForm

Funktsioon EditForm muudab vormi juhtelemendi režiimiks FormMode. Edit. Selles režiimis kasutatakse juhtelemendi Vormi atribuuti Item vormi täitmiseks. Kui SubmitForm funktsioon käivitub, kui vorm on selles režiimis, muudetakse kirjet, mitte ei looda. FormMode.Edit on juhtelemendi Vorm vaikeväärtus.

NewForm

Funktsioon NewForm muudab juhtelemendi Vorm režiimiks FormMode.New. Selles režiimis ignoreeritakse vormi juhtelemendi atribuudi Item sisu ja vormi atribuudi DataSource vaikeväärtused asustavad vormi. Kui SubmitForm funktsioon käivitub, kui vorm on selles režiimis, luuakse kirje, mitte ei muudeta.

ResetForm

Funktsioon ResetForm lähtestab vormi sisu algsetele väärtustele, enne kui kasutaja on muudatused teinud. Kui vorm on FormMode.New režiimis, lähtestatakse vorm FormMode.Edit režiimile. Ka OnReset käitumine käivitatakse vormi juhtelemendis. Üksikuid juhtelemente saab lähtestada ka funktsiooniga Reset, kuid ainult vormi seest.

ViewForm

Funktsioon ViewForm muudab vormi juhtelemendi režiimiks FormMode.View. Selles režiimis kasutatakse juhtelemendi Vormi atribuuti Item vormi täitmiseks. SubmitForm ja ResetForm funktsioonid ei mõjuta seda režiimi.

Atribuut DisplayMode

Praegust režiimi saab lugeda atribuudi Režiim kaudu. Režiim määratleb ka DisplayMode atribuudi väärtuse, mida saavad kasutada andmete kaardid ja juhtelemendid vormi juhtelemendis. Sageli saab andmekaardi atribuudi DisplayMode seada väärtusele Parent.DisplayMode (viitab vormile), nagu ka juhtelemendi atribuudi DisplayMode (viitab andmekaardile):

Režiim Kuvarežiim Kirjeldus
FormMode.Edit DisplayMode.Edit Andmete kaardid ja juhtelemendid on muudetavad, valmis kirje muudatuste aktsepteerimiseks.
FormMode.New DisplayMode.Edit Andmete kaardid ja juhtelemendid on muudetavad, uue kirje aktsepteerimiseks.
FormMode.View DisplayMode.View Andmete kaarte ja juhtelemente ei saa redigeerida ja optimeerida vaatamiseks.

Süntaks

SubmitForm( FormName )

  • FormName - nõutav. Vormi juhtelement, mille soovite andmeallikas esitada.

EditForm( FormName )

  • FormName - nõutav. Vormi juhtelement, et aktiveerida FormMode.Edit režiim.

NewForm( FormName )

  • FormName - nõutav. Vormi juhtelement, et aktiveerida FormMode.New režiim.

ResetForm( FormName )

  • FormName - nõutav. Vormi juhtelement, mis lähtestatakse algsetele väärtustele. Lülitab ka vormi režiimi FormMode.New režiimile FormMode.Edit.

ViewForm( FormName )

  • FormName - nõutav. Vormi juhteelement, et aktiveerida FormMode.View režiim.

Näited

Vt jaotist Andmevormide mõistmine, et näha rohkem näiteid.

  1. Lisage juhtelement Nupp, seadke selle atribuut Text kuvama Salvesta ja seadke selle atribuut OnSelect sellele valemile:

    SubmitForm( EditForm )

  2. Seadke vormi juhtelemendi atribuut OnFailure väärtusele tühi ja selle atribuut OnSuccess valemile:

    Back()

  3. Andke juhtelemendile Label nimi ErrorText ja seadke selle atribuut Text valemile:

    EditForm.Error

    Kui kasutaja valib nupu Salvesta, esitatakse vormi juhtelemendi muudatused aluseks olevale andmeallikale.

    • Kui edastus õnnestub, salvestatakse kõik muudatused või kui vormi juhtelement on režiimis Uus, luuakse kirje. ErrorText on tühi ja eelmine ekraan kuvatakse uuesti.
    • Kui edastus nurjub, ErrorText kuvab kasutajasõbraliku tõrketeate ja praegune ekraan jääb nähtavaks, et kasutaja saaks probleemi lahendada, ja proovige siis uuesti.
  4. Lisage juhtelement nupp, seadke selle atribuut Text kuvama Tühista ja seadke selle atribuut OnSelect valemile:

    ResetForm( EditForm ); Back()

    Kui kasutaja valib nupu Tühista, siis vormi juhtelemendi väärtused lähtestatakse nii, nagu nad enne kasutaja redigeerimist olid, kuvatakse eelmine ekraan ja vormi juhtelement tagastatakse režiimi Redigeeri, kui see oli režiimis New.

  5. Lisage juhtelement ja seadke selle atribuut Text kuvama Uus ja seadke selle atribuut OnSelect valemile:

    NewForm( EditForm ); Navigate( EditScreen, None )

    Kui kasutaja valib nupu Uus, lülitub vormi juhtelement režiimi Uus, juhtelemendi vormi andmeallika vaikeväärtused asustavad selle juhtelemendi ning kuvatakse vormi juhtelementi sisaldav ekraan. Kui SubmitForm funktsioon käitatakse, luuakse kirje selle värskendamise asemel.