Hibák funkció

A következőkre vonatkozik: Vászonalapú alkalmazások Modellvezérelt alkalmazások

Tájékoztatást nyújt az adatforrások korábban végrehajtott módosításaival kapcsolatos hibákról.

Áttekintés

Hibák általában az adatforrások rekordjainak módosításakor fordulnak elő. Számos okuk lehet, többek között hálózati kimaradás, a megfelelő jogosultságok hiánya vagy szerkesztési ütközések.

Az adatforrásokban található adatokat módosító függvények (például Patch, Collect, Remove, Removelf, Update, Updatelf és SubmitForm) kétféleképpen jelentik a hibákat:

  • Ezen függvények mindegyike hibaértéket ad vissza a művelet eredményeként. A hibák az IsError használatával észlelhetők, illetve az IfError és az App.OnError használatával helyettesíthetők vagy visszavonhatók. További információt lásd: Hibakezelés.
  • A művelet után az Errors függvény visszaadja a korábbi műveletek hibáit is. A segítségével megjeleníthető egy hibaüzenet az űrlapképernyőn anélkül, hogy a hibát állapotváltozóban kellene rögzíteni.

Bizonyos hibák már az előfordulásuk előtt is elkerülhetők a Validate és a DataSourceInfo függvény használatával. A hibák kezeléséről és elkerüléséről az adatforrások kezelésével kapcsolatos témakörben találhat további javaslatokat.

Ismertetés

Az Errors függvény egy hibákból álló táblát ad vissza, amely a következő oszlopokat tartalmazza:

  • Rekord. Az adatforrás azon rekordja, amelyben a hiba jelentkezett. Ha a hiba egy rekord létrehozása közben történt, ez az oszlop üres marad.
  • Oszlop. A hibát okozó oszlop, ha a hiba egyetlen oszlopnak tulajdonítható. Ellenkező esetben ez a mező üres lesz.
  • Üzenet. A hiba leírása. Ez a hibasztring megjeleníthető a végfelhasználó számára. Vegye figyelembe, hogy ezt az üzenetet valószínűleg az adatforrás generálja, ezért előfordulhat, hogy hosszú lesz, és olyan nyers oszlopneveket tartalmaz, amelyeket a felhasználó nem ismer.
  • Hiba. Egy hibakód, amely képletekben használható a hiba feloldásához:
ErrorKind Ismertetés
ErrorKind.Conflict Egy másik módosítást hajtottak végre ugyanazon a rekordon, és ez a módosítások ütközését eredményezte. Töltse be újra rekordot a Refresh függvénnyel, és próbálja meg újból végrehajtani a módosítást.
ErrorKind.ConstraintViolation Egy vagy több megszorítást megsértettek.
ErrorKind.CreatePermission Az aktuális felhasználó megpróbált létrehozni egy rekordot, de nem rendelkezik a rekordok létrehozásához szükséges jogosultsággal.
ErrorKind.DeletePermission Az aktuális felhasználó megpróbált törölni egy rekordot, de nem rendelkezik a rekordok törléséhez szükséges jogosultsággal.
ErrorKind.EditPermission Az aktuális felhasználó megpróbált szerkeszteni egy rekordot, de nem rendelkezik a rekordok szerkesztéséhez szükséges jogosultsággal.
ErrorKind.GeneratedValue A felhasználó megpróbált módosítani egy olyan oszlopot, amelyet az adatforrás generál automatikusan.
ErrorKind.MissingRequired Az egyik szükséges oszlop értéke hiányzik a rekordból.
ErrorKind.None Nincs hiba.
ErrorKind.NotFound A felhasználó megpróbált törölni vagy szerkeszteni egy rekordot, de a rekordot nem találta a rendszer. Lehetséges, hogy egy másik felhasználó módosította a rekordot.
ErrorKind.ReadOnlyValue A felhasználó megpróbált módosítani egy írásvédett oszlopot.
ErrorKind.Sync Az adatforrás hibát jelentett. Ha további információra van szüksége, ellenőrizze az Üzenet oszlopot.
ErrorKind.Unknown Ismeretlen típusú hiba történt.
ErrorKind.Validation Olyan általános érvényesítési probléma merült fel, amely egyik hibatípusba sem volt besorolható.

A hibák a teljes adatforrásra, illetve a függvény Rekord argumentumának megadása esetén egy bizonyos sorra vonatkozóan is visszaadhatók.

Előfordulhat, hogy a Patch vagy egy másik adatfüggvény üres értéket ad vissza, ha például egy rekord nem hozható létre. Ha az Errors függvény végrehajtásához üres értéket ad át, akkor a megfelelő hibainformációkat adja vissza. Ha az adatfüggvények újra ugyanazon az adatforráson használja, a rendszer törli ezeket a hibainformációkat.

Ha nincsenek hibák, az Errors által visszaadott tábla üres lesz; a tábla az IsEmpty függvénnyel ellenőrizhető.

Szintaxis

Errors( Adatforrás [, Rekord] )

  • DataSource (Adatforrás) – kötelező. Annak az adatforrásnak a neve, amelynek a hibáit keresi.
  • Rekord – Nem kötelező. Egy konkrét rekord, amelynek a hibáit keresi. Ha ez az argumentum nincs megadva, a függvény a teljes adatforrásra vonatkozóan adja vissza a hibákat.

Példák

Lépésről lépésre

Ebben a példában a Jégkrém adatforrással fogunk dolgozni:

Fagylalt.

Egy felhasználó az alkalmazásban betölti a Csokoládé rekordot egy adatbeviteli űrlapra, és a Mennyiség értékét 90-re módosítja. A rendszer az EditRecord környezeti változóban helyezi el a kezelendő rekordot:

  • UpdateContext( { EditRecord: LookUp( Jégkrém, Íz = "Csokoládé" ) } )

Ez a módosítás a Patch függvénnyel végezhető el az adatforrásban:

  • Patch ( Jégkrém, EditRecord, Gallery.Updates )

ahol a Gallery.Updates kiértékelt értéke { Mennyiség: 90 }, mivel csak a Mennyiség tulajdonság módosult.

Sajnos azonban közvetlenül a Patch függvény hívása előtt valaki más módosította a Csokoládéhoz tartozó Mennyiség tulajdonságot 80-ra. A Power Apps ezt észlelni fogja, és nem engedélyezi az ütköző módosítás végrehajtását. Az alábbi képlettel ellenőrizhető, hogy fennáll-e ez a helyzet:

  • IsEmpty ( Errors( Jégkrém, EditRecord ) )

amely false (hamis) értéket fog visszaadni, mert az Errors függvény az alábbi táblázatot adta vissza:

Rekord Oszlop Üzenet Hiba
{ Íz: "Csokoládé", Mennyiség: 100 } üres „Egy másik felhasználó módosította a rekordot, amelyet módosítani próbál. Töltse be újra a rekordot, és próbálkozzon újra.” ErrorKind.Conflict

Elhelyezhet egy címkét az űrlapon, amellyel jelezheti a hibát a felhasználó számára.

  • A hiba megjelenítéséhez a címke Text (Szöveg) tulajdonságát állítsa be a következő képletre:
    Label.Text = First(Errors( Jégkrém, EditRecord )).Message

Egy Újratöltés gombot is elhelyezhet a lapon, hogy a felhasználó egyszerűbben feloldhassa az ütközést.

  • Ha azt szeretné, hogy a rendszer csak akkor jelenítse meg a gombot, ha ütközést észlel, állítsa a gomb Visible (Látható) tulajdonságát a következő képletre:
    !IsEmpty( Lookup( Errors( Jégkrém, EditRecord ), Error = ErrorKind.Conflict ) )
  • Ha azt szeretné, hogy a gomb használatakor a rendszer visszaállítsa a módosítást, állítsa a gomb OnSelect (Kijelöléskor) tulajdonságát a következő képletre:
    ReloadButton.OnSelect = Revert( Jégkrém, EditRecord )