SaveData, LoadData és ClearData függvény

Cikk
03/22/2024

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

Ment és újra betölt egy gyűjteményt az alkalmazás állomásának tárhelyről.

Feljegyzés

Ezek a függvények már használhatók, ha egy alkalmazást kísérleti funkcióként egy webböngészőben játszanak le. Alapértelmezetten ez a funkció le van tiltva. Engedélyezéséhez navigáljon a Beállítások>Hamarosan megjelenő funkciók>Kísérleti>SaveData, LoadData, ClearData engedélyezése a webes lejátszóban menüponthoz, és kapcsolja be a kapcsolót. Ha visszajelzést szeretne küldeni erről a kísérleti funkcióról, menjen a Power Apps közösségi fórumra.

Ismertetés

A SaveData függvény későbbi használatra tárol egy gyűjteményt egy megadott név alatt.

A LoadData függvény újra betölti a gyűjteményt azon a néven, amelyen korábban a SaveData használatával mentették. Ezzel a függvénnyel más forrásból származó gyűjteményt nem lehet betölteni.

A ClearData függvény egy adott név alatt törli a tárolóterületet, vagy törli az alkalmazáshoz társított összes tárolóterületet, ha nincs megjelölve név.

Feljegyzés

A SaveData, a LoadData és a ClearData között megosztott név egy kulcs, nem egy fájlnév. Nem szükséges összetettnek lennie, mivel a nevek egyediek az egyes alkalmazásokhoz, és nincs veszély a nevek ütközésére. A név nem tartalmazhat ilyen karaktereket: *".?:\<>|/.
A SaveData legfeljebb 1 MB-os adat lehet Teamsben vagy webböngészőben futó Power Apps alkalmazások esetében. A mobi lejátszón futó Power Apps esetén nincs rögzített korlát, de a gyakorlati korlátozásokról az alábbiakban olvashat.
Ne tároljon bizalmas adatokat a weben a SaveData segítségével, mert az egyszerű szövegben lesz tárolva.

Ezekkel a funkciókkal javíthatja az alkalmazások indítási teljesítményét az alábbiak szerint:

Az App.OnStart képletben lévő adatok gyorsítótárazása az első futtatáskor.
A helyi gyorsítótár újratöltése a következő futtatásoknál.

Ezekkel a függvényekkel egyszerű, kapcsolat nélküli képességeket adhat hozzá az alkalmazáshoz.

Ezek a függvények nem használhatók böngészőn belül, ha:

Alkalmazás szerkesztése a Power Apps Studio megoldásban.

Az alkalmazás teszteléséhez futtassa a Power Apps Mobile megoldásban egy iPhone-on vagy Android készüléken.

Ezeket a függvényeket a rendelkezésre álló alkalmazásmemória korlátozza, mert a memóriában tárolt gyűjteményben működnek. A rendelkezésre álló memóriaterület az alábbi tényezőktől függően változhat:

Az eszköz és az operációs rendszer.
A Power Apps lejátszó által használt memória.
Az alkalmazás bonyolultsága képernyőkkel és vezérlőelemekkel.

Ellenőrizze az alkalmazást a várt helyzetekben azon eszközök típusán, amelyek nagy adatok tárolása esetén elvárják, hogy az alkalmazás fusson. Elvárják, hogy a 30 MB és 70 MB közötti rendelkezésre álló memóriát általában.

Ezek a függvények attól függnek, hogy a Collect vagy a ClearCollect implicit módon van-e definiálva. Nem szükséges a Collect vagy ClearCollect meghívása a gyűjteménybe az adatok betöltéséhez meghatározáshoz. Gyakori eset, ha a LoadData van használatban egy korábbi SaveData után. Mindez szükséges, hogy ezeknek a függvényeknek a jelenléte a képletben implicit módon határozza meg a gyűjtemény felépítését. További tájékoztatás a változók létrehozása és eltávolítása című témakörben olvasható.

A betöltött adatok a gyűjteményhez lesznek hozzáfűzve. Ha üres gyűjteménnyel szeretne kezdeni, használja a Clear függvényt a LoadData hívása előtt.

Adatbiztonság

Gondosan mérlegelje a SaveData segítségével tárolt adatok elkülönítését és titkosítását, és döntse el, hogy megfelelő-e az Ön igényeinek, különösen, ha az eszközöket több felhasználó osztja meg.

A SaveData segítségével tárolt adatokat a játékosok elkülönítik Power Apps egymástól Power Apps . Az adatok tárolása az alkalmazás alkalmazásazonosítója alapján történik, automatikusan elkülönítve a SaveData névteret közöttük Power Apps.

Az operációs rendszer és a böngésző felelős az adatok elkülönítéséért az eszközön lévő más alkalmazások és a webhelyek között Power Apps . Például az operációs rendszer felelős a tárolt Microsoft Outlook adatok elkülönítéséért a tárolt Power Apps adatoktól, valamint az adatok elkülönítéséért olyan webhelyektől, mint a Bing.com vagy PowerApps.com. Az operációs rendszer beépített alkalmazás-tesztkörnyezetét a SaveData tárolására használják, amely általában nem érhető el vagy rejtve van a felhasználó elől.

Ha ugyanazt az alkalmazást használja, az operációs rendszer és a böngésző felelős az adatok elkülönítéséért az operációs rendszer különböző szintű felhasználói között. Ha például két különböző felhasználó osztozik egy számítógépen, és két különböző Windows bejelentkezési hitelesítő adatot használ, az operációs rendszer felelős a két Windows-felhasználó közötti adatok elkülönítéséért.

Az adatok elkülöníthetők a különböző Power Apps felhasználók között, vagy nem, ha az operációs rendszer felhasználója azonos. Nem minden Power Apps játékos kezeli ezt ugyanúgy. Ha például ugyanazzal a Windows-felhasználóval van bejelentkezve, a lejátszóban a Power Apps felhasználó kijelentkezik Power Apps , majd másik Power Apps felhasználóként jelentkezik be. Az alkalmazásban a felhasználóváltás Power Apps előtt tárolt adatok az alkalmazáson belül a második Power Apps felhasználó számára is elérhetők lehetnek. Az adatok el is távolíthatók, és előfordulhat, hogy az első Power Apps felhasználó már nem férhet hozzájuk. A viselkedés játékosonként Power Apps változik.

Az operációs rendszer titkosíthatja is az adatokat, vagy használhat mobileszköz-kezelő eszközt, például a Microsoft Intune-t. Az alkalmazások webböngészőben való lejátszásakor tárolt adatok nincs titkosítva.

Szintaxis

SaveData( Collection, Name )
LoadData( Collection, Name [, IgnoreNonexistentFile ])

Gyűjtemény – kötelező. A tárolni vagy betölteni kívánt gyűjtemény.
Név - kötelező. A tároló neve. Adott adatkészlet mentéséhez és betöltéséhez ugyanazt a nevet kell használni. A névtér nincs megosztva más alkalmazásokkal. A név nem tartalmazhat ilyen karaktereket: *".?:\<>|/.
IgnoreNonexistentFile – Nem kötelező. Logikai érték, amely azt jelzi, hogy mi a teendő, ha a fájl még nem létezik. A hamis (alapértelmezés) segítségével visszaállíthat egy hibát, és az igaz választással lehet elnyomni a hibát.

ClearData( [Név] )

Név – Nem kötelező. A SaveData elemmel korábban mentett tároló neve. Ha a Név nincs megadva, akkor az alkalmazáshoz társított összes tárhely törlődik.

Példák

Képlet	Ismertetés	Eredmény
SaveData( LocalCache, "MyCache" )	Mentse a LocalCache gyűjteményt a felhasználó eszközére a "MyCache" néven, amely alkalmas a LoadData számára a későbbi lekérésre.	A rendszer adatokat ment az alkalmazás állomására "MyCache" néven.
LoadData( LocalCache, "MyCache" )	Betölti a LocalCache gyűjteményt a felhasználó eszközéről a "MyCache" néven, amelyet korábban SaveData-hívással tárolt.	A rendszer adatokat tölt be az alkalmazás állomásáról a "MyCache" név alatt.
ClearData( "MyCache" )	Törli a tárolóterületet a "MyCache" név alatt. Az ezen a néven tárolt adatok a továbbiakban nem lesznek elérhetők a LoadData elemen keresztül.	A rendszer adatokat távolít el az alkalmazás állomásáról a "MyCache" név alatt.
ClearData()	Törölje az alkalmazáshoz társított összes tárhelyet. A más alkalmazások által tárolt adatokat ez nem érinti.	A rendszer minden adatot eltávolít az alkalmazás állomásról.

Egyszerű kapcsolat nélküli példa

A következő egyszerű példa rögzíti és tárolja a mindennapi elemek neveit és képeit kapcsolat nélküli módban. A rendszer az eszköz helyi tárhelyén tárolja az információkat későbbi használat céljából. Ez lehetővé teszi, hogy az alkalmazást lezárja, vagy az eszköz az adatok elvesztése nélkül újrainduljon.

Feljegyzés

Ez a példa egy kameravezérlőt használ a képek rögzítésére. Mivel a SaveData 1 MB-nyi adatra van korlátozva a Teamsben vagy webböngészőben való futtatás esetén, ez a példa csak néhány kép esetén használható. A fényképezőgéptől függően előfordulhat, hogy még egy képpel sem működik. Használjon egy eszközt, hogy végighaladjon ezen a példán, illetve eltávolíthatja a kameravezérlő és kép részét ennek a példafuttatásnak a Teamsben vagy egy webböngészőben.

Hozzon létre egy üres vászon alkalmazást tablet elrendezéssel. További részletekért olvassa el az alkalmazás létrehozása sablonból és válassza a Tablet elrendezés elemet az Üres alkalmazás területen.
Vegyen fel egy Szövegbevitel vezérlőt és egy Kamera vezérlőt, és gondoskodjon róla, hogy nagyjából így legyenek elrendezve:
Egy Gomb vezérlő hozzáadása.
Kattintson duplán a gomb vezérlőre, és módosítsa a gomb szövegét az Elem hozzáadása lehetőségre (vagy módosítsa a Szöveg tulajdonságot).
Állítsa be a gomb vezérlő OnSelect tulajdonságát erre a képletre, amely egy elemet vesz fel a gyűjteménybe:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Még egy Gomb vezérlő hozzáadása.
Kattintson duplán a gomb vezérlőre, és módosítsa a gomb szövegét az Adatok mentése lehetőségre (vagy módosítsa a Szöveg tulajdonságot).
Állítsa be a gomb vezérlő OnSelect tulajdonságát erre a képletre, hogy elmentsük a gyűjteményünket a helyi eszközre:
```
SaveData( MyItems, "LocalSavedItems" )
```
Nagy a kísértés, hogy teszteljék a gombot, mivel nem érint semmit. De csak egy hibaüzenet jelenik meg, mivel webböngészővel dolgozunk. Mentse az alkalmazást először, és nyissa meg egy eszközön, mielőtt a következő lépések végrehajtásával teszteli a képletet:
Adja hozzá a harmadik Gomb vezérlőt.
Kattintson duplán a gomb vezérlőre, és módosítsa a gomb szövegét az Adatok betöltése lehetőségre (vagy módosítsa a Szöveg tulajdonságot).
Állítsa be a gomb vezérlő OnSelect tulajdonságát erre a képletre, hogy betöltsük a gyűjteményünket a helyi eszközről:
```
LoadData( MyItems, "LocalSavedItems" )
```
Adjon hozzá egy olyan függőleges elrendezésű Katalógus vezérlőt, amely kép- és szöveg területeket tartalmaz:
Amikor a rendszer kéri, jelölje ki a MyItems gyűjteményt, mint a katalógus adatforrását. Beállítja az Elemek tulajdonságát a Katalógus vezérlőnek:

A katalógussablon kép vezérlőelemének Kép tulajdonságának alapértelmezés szerint ThisItem.Picture értékűnek , a címke vezérlőelemek Szöveg tulajdonságának pedig ThisItem.Item értékre kell állítania a Szöveg tulajdonságát. Ellenőrizze ezeket a képleteket, ha a következő lépésekben szereplő elemek hozzáadása után nem lát semmit a katalógusban.
Mozgassa a vezérlőt a többi vezérlőtől jobbra levő pozícióra:
Mentse az alkalmazást. Ha ez az első mentés, nem kell közzétennie. Ha nem ez az első mentés, akkor a mentés után tegye közzé az alkalmazást.
Nyissa meg az alkalmazást egy eszközön, például telefonon vagy táblagépen. A SaveData és a LoadData nem használható stúdióban vagy böngészőben. Ha nem látja azonnal az alkalmazást, akkor frissítse az alkalmazás listáját: eltarthat néhány másodpercig, amíg az alkalmazás megjelenik az eszközön. A fiókjából való kijelentkezés, majd bejelentkezés is segíthet.

Az alkalmazás letöltése után bonthatja a kapcsolatot a hálózattal, és offline is futtathatja az alkalmazást.
Adja meg a nevet, és készítsen képet egy elemről.
Nyomja meg az Elem hozzáadása gombot. Ismételje meg az elemek hozzáadását néhány alkalommal a katalógus feltöltéséhez.
Kattintson az Adatok mentése gombra. Ezzel a rendszer menti a kollekció adatait a helyi eszközre.
Alkalmazás bezárása. A memóriában tárolt kollekció elvész, beleértve az összes elem nevét és képét, de az eszköz tárolójában továbbra is megtalálhatók lesznek.
Az alkalmazás indítása újra. A memóriában lévő gyűjtemény ismét üresként jelenik meg a katalógusban.
Kattintson az Adatok betöltése gombra. A rendszer újra feltölti a kollekciót az eszközön tárolt adatokkal, és az elemek visszakerülnek a galériába. A kollekció üres volt, mielőtt ez a gomb meghívja a LoadData függvényt, nem volt szükség a Collect vagy a ClearCollect meghívására, mielőtt betölti az adatokat a tárhelyről.
Kattintson az Adatok betöltése gombra újra. A tárolt adatok a kollekció végéhez lesznek hozzáfűzve, és egy görgetősáv jelenik meg a galériában. Ha a hozzáfűzés helyett a csere funkciót szeretné használni, akkor először használja a Clear függvényt, hogy a LoadData funkció hívása előtt törölje a gyűjteményt.