Funktsioon Validate Power Appsis

Funktsioon Validate kontrollib, kas ühe veeru või täieliku kirje väärtus on andmeallika jaoks kehtiv.

Kirjeldus

Enne, kui kasutaja esitab andmete muutmise, saate anda kohest tagasisidet selle esitamise kehtivuse kohta, mille tulemuseks on parem kasutajakogemus.

Andmeallikad võivad anda teavet selle kohta, mis on kirjes kehtivad väärtused. See teave võib sisaldada mitmeid piiranguid, näiteks järgmisi.

  • Kas veerg nõuab väärtust
  • Kui pikk võib tekstistringi olla
  • Kui suur ja väike võib arv olla
  • Kui varajane ja hiline võib kuupäeva olla

Funktsioon Validate kasutab seda teavet, et teha kindlaks, kas väärtus on kehtiv, ja et tagastada sobiva tõrketeate, kui väärtus ei ole kehtiv. Funktsiooniga DataSourceInfo saate vaadata sama teavet, mida funktsioon Validate kasutab.

Andmeallikad varieeruvad selles, kui palju kinnitamise teavet nad pakuvad või ei sisalda seda üldse. Funktsioon Validate saab kontrollida ainult selle teabe põhjal antud väärtusi. Isegi juhul, kui funktsioon Validate probleemi ei leia, võib andmete muutmise rakendamine siiski nurjuda. Funktsiooni Errors saate kasutada tõrke kohta teabe saamiseks.

Kui funktsioon Validate leiab probleemi, tagastab funktsioon tõrketeate, mida saate rakenduse kasutajale kuvada. Kui kõik väärtused on kehtivad, tagastab funktsioon Validate väärtuse blank. Kui töötate kogumiga, millel pole kinnitamise teavet, on väärtused alati kehtivad.

Süntaks

Validate( DataSource, Column, Value )

  • DataSource – nõutav. Andmeallikas kinnitamiseks.
  • Column – nõutav. Veerg kinnitamiseks.
  • Value – nõutav. Valitud veeru väärtus kinnitamiseks.

Validate( DataSource, OriginalRecord, Updates )

  • DataSource – nõutav. Andmeallikas kinnitamiseks.
  • OriginalRecord – nõutav. Kirje, millesse värskendused tuleb kinnitada.
  • Updates – nõutav Algsele kirjele rakendatavad muudatused.

Näited

Nende näidete korral peavad väärtused andmeallika Scores veerus Percentage olema vahemikus 0–100 (kaasa arvatud). Kui andmed on kinnitatud, tagastab funktsioon väärtuse blank. Vastasel juhul tagastab funktsioon tõrketeate.

Kinnita ühe veeruga

Valem Kirjeldus Tulem
Validate( Scores, Percentage, 10 ) Kontrollib, kas 10 on andmeallika Scores veeru Percentage kehtiv väärtus. blank
Validate( Scores, Percentage, 120 ) Kontrollib, kas 120 on andmeallika Scores veeru Percentage kehtiv väärtus. "Väärtused peavad jääma vahemikku 0 kuni 100."

Kinnita koos täieliku kirjega

Valem Kirjeldus Tulem
Validate( Scores, EditRecord, Gallery.Updates ) Kontrollib, kas andmeallika Scores veergude väärtused kehtivad. Selles näites on veeru Percentage väärtuseks 10. blank
Validate( Scores, EditRecord, Gallery.Updates ) Kontrollib, kas andmeallika Scores veergude väärtused kehtivad. Selles näites on veeru Percentage väärtuseks 120. "Väärtused peavad jääma vahemikku 0 kuni 100."