Funkcije SaveData, LoadData in ClearData v aplikaciji Power Apps

Članek
03/10/2022
3 min za branje

Shranite in znova naložite zbirko iz shrambe gostitelja aplikacije.

Opomba

Te funkcije je zdaj mogoče uporabiti pri predvajanju aplikacije v spletnem brskalniku kot poskusne funkcije. Ta funkcija je privzeto onemogočena. Če jo želite omogočiti, odprite Nastavitve > Prihajajoče funkcije > Poskusno > **Omogočene funkcije SaveData, LoadData, ClearData v spletnem predvajalniku.**« in vklopite stikalo. Če želite poslati povratne informacije o tej poskusni funkciji, pojdite v forum skupnosti Power Apps.

Opis

Funkcija SaveData shrani zbirko za poznejšo uporabo z imenom.

Funkcija LoadData znova naloži zbirko po imenu, s katerim je bila prej shranjena v funkciji SaveData. Te funkcije ne morete uporabiti za nalaganje zbirke iz drugega vira.

Funkcija ClearData izbriše pomnilnik pod določenim imenom ali izbriše ves pomnilnik, povezan z aplikacijo, če ime ni navedeno.

Opomba

Ime, ki si ga delijo funkcije SaveData, LoadData in ClearData, je ime ključa in ne datoteke. Ni treba, da je zapleteno, saj so imena enolična za vsako aplikacijo in ni nevarnosti, da bi prišlo do spora zaradi imena. Ime ne sme vsebovati teh znakov: *".?:\<>|/.
Možnost SaveData je omejena na 1 MB podatkov za izvajanje Power Apps v Teams in spletnem brskalniku. Omejitev za Power Apps, ki se izvaja v predvajalniku prenosnih naprav, ni določena, spodaj pa so vseeno pojasnjene praktične omejitve.
Ne uporabljajte SaveData za shranjevanje občutljivih podatkov v spletu, saj bodo shranjeni v golem besedilu.

Uporabite te funkcije in izboljšajte učinkovitost zagona aplikacije, tako da:

predpomnite podatke v formuli App.OnStart pri prvem zagonu.
znova naložite lokalni predpomnilnik pri naslednjih zagonih.

Te funkcije lahko uporabite tudi za dodajanje preprostih zmogljivosti v načinu brez povezave v aplikacijo.

Teh funkcij v brskalniku ne morete uporabljati, če:

ustvarjate aplikacijo v Power Apps Studio.

Če želite preskusiti svojo aplikacijo, jo zaženite v Power Apps Mobile v telefonu iPhone ali napravi s sistemom Android.

Te funkcije so omejene s količino razpoložljivega pomnilnika, ker delujejo v zbirki znotraj pomnilnika. Razpoložljivi pomnilnik je odvisen od različnih dejavnikov:

Naprava in operacijski sistem.
Pomnilnik, ki ga uporablja predvajalnik Power Apps.
Zapletenost aplikacije z zasloni in kontrolniki.

Preskusite svojo aplikacijo s pričakovanimi scenariji v vrsti naprav, v katerih pričakujete, da se bo aplikacija zagnala pri shranjevanju velikih količin podatkov. Pričakujte, da boste imeli na voljo med 30 in 70 MB pomnilnika.

Te funkcije so odvisne od zbirke, ki je implicitno določena s funkcijo Collect ali ClearCollect. Ni vam treba klicati funkcije Collect ali ClearCollect, da naložite podatke v zbirko in jo tako opredelite. To je pogost primer pri uporabi funkcije LoadData, če ste prej uporabili funkcijo SaveData. Potrebna je le prisotnost teh funkcij v formuli za implicitno določitev strukture zbirke. Če želite več informacij, glejte članek o ustvarjanju in odstranjevanju spremenljivk.

Naloženi podatki bodo priloženi v zbirko. Če želite začeti s prazno zbirko, uporabite funkcijo Clear, preden prikličete funkcijo LoadData.

Vgrajeni prostori preizkusnega okolja aplikacije v napravi se uporabljajo za izolacijo shranjenih podatkov iz drugih aplikacij.

Naprava lahko tudi šifrira podatke; lahko pa uporabite orodje za upravljanje mobilnih naprav, kot je Microsoft Intune. Podatki, shranjeni med predvajanjem aplikacije v spletnem brskalniku, niso šifrirani.

Sintaksa

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

Collection – obvezno. Zbirka za shranjevanje ali nalaganje.
Name – obvezno. Ime shrambe. Za shranjevanje in nalaganje istega nabora podatkov mora biti ime enako. Imenski prostor ni v skupni rabi z drugimi aplikacijami ali uporabniki. Imena ne smejo vsebovati teh znakov: *".?:\<>|/.
IgnoreNonexistentFile – neobvezno. Logična vrednost, ki označuje, kaj morate storiti, če datoteka še ne obstaja. Uporabite false (privzeto), da vrnete napako, in true, da preprečite napako.

ClearData( [Ime] )

Ime – izbirno. Ime shrambe, ki je bila predhodno shranjena s funkcijo SaveData. Če Ime ni navedeno, se izbriše vsa shramba, povezana z aplikacijo.

Primeri

Formula	Opis	Rezultat
SaveData( LocalCache, "MyCache" )	Shranite zbirko LocalCache v uporabnikovo napravo pod imenom »MyCache«, da jo bo funkcija LoadData pozneje lahko pridobila.	Podatki se shranijo v gostitelja aplikacije pod imenom »MyCache«.
LoadData( LocalCache, "MyCache" )	Naloži zbirko LocalCache iz uporabnikove naprave pod imenom »MyCache«, ki je bila shranjena s klicem funkcije SaveData.	Podatki se naložijo iz gostitelja aplikacije pod imenom »MyCache«.
ClearData( "MyCache" )	Izbriše shrambo pod imenom »MyCache«. Podatki, shranjeni pod tem imenom, ne bodo več na voljo prek LoadData.	Podatki se odstranijo iz gostitelja aplikacije pod imenom »MyCache«.
ClearData()	Izbrišite celotno shrambo, povezano s to aplikacijo. To ne vpliva na podatke, ki jih shranjujejo druge aplikacije.	Vsi podatki so odstranjeni iz gostitelja aplikacije.

Enostavne primer v načinu brez povezave

Spodnji enostaven primer zajame in shrani imena in slike vsakdanjih predmetov v načinu brez povezave. Informacije shrani v lokalni pomnilnik naprave za poznejšo uporabo. To omogoča zapiranje aplikacije ali vnovični zagon naprave brez izgube podatkov.

Opomba

Ta primer uporablja kontrolnik kamere za zajemanje slik. Odkar je funkcija SaveData omejena na 1 MB podatkov pri izvajanju v Teams ali spletnem brskalniku, ta primer ne bo deloval z več kot nekaj slikami. Poleg tega je odvisno tudi od kamere, ali bo deloval že z eno sliko. Uporabite napravo, da predelate ta celoten primer ali odstranite del kontrolnik kamere in slike tega primera, da ga zaženete v Teams ali spletnem brskalniku.

Ustvarite prazno aplikacijo delovnega območja s postavitvijo za tablični računalnik. Za več podrobnosti preberite članek o ustvarjanju aplikacije iz predloge in izberite Postavitev za tablični računalnik pod možnostjo Prazna aplikacija.
Dodajte kontrolnik Text input in kontrolnik Camera ter ju razporedite približno tako, kot je prikazano:
Dodajte kontrolnik Button.
Dvokliknite kontrolnik »Button« in spremenite besedilo gumba v Dodaj element (ali spremenite lastnost Besedilo).
Nastavite lastnost OnSelect kontrolnika »Button« na to formulo, ki bo dodala element v našo zbirko:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Dodajte še en kontrolnik Button.
Dvokliknite kontrolnik »Button« in spremenite besedilo kontrolnika v Shrani podatke (ali spremenite lastnost Besedilo).
Nastavite lastnost OnSelect kontrolnika »Button« na to formulo, da shranite našo zbirko v lokalno napravo:
```
SaveData( MyItems, "LocalSavedItems" )
```
Morda boste želeli preskusiti gumb, saj ne vpliva na nič. Vendar se bo prikazala napaka, saj ustvarjate v spletnem brskalniku. Najprej shranite aplikacijo in jo odprite v napravi, preden sledite spodnjim korakom za preskus te formule:
Dodajte tretji kontrolnik Button.
Dvokliknite kontrolnik »Button« in spremenite besedilo gumba v Naloži podatke (ali spremenite lastnost Besedilo).
Nastavite lastnost OnSelect kontrolnika »Button« na to formulo, da naložite našo zbirko iz lokalne naprave:
```
LoadData( MyItems, "LocalSavedItems" )
```
Dodajte kontrolnik Gallery z navpično postavitvijo, ki vključuje območja za slike in besedilo:
Ko ste pozvani, izberite zbirko MyItems kot vir podatkov za to galerijo. S tem nastavite lastnost Items za kontrolnik Gallery:

Kontrolnik slike v predlogi galerije mora imeti privzeto nastavljeno lastnost Slika na ThisItem.Picture, kontrolniki oznak pa bi morali imeti privzeto nastavljeno lastnost Besedilo na ThisItem.Item. Če po dodajanju elementov v naslednjih korakih v galeriji ne vidite ničesar, preverite te formule.
Kontrolnik postavite desno od ostalih kontrolnikov:
Shranite aplikacijo. Če ste jo shranili prvič, je ni treba objaviti. V nasprotnem primeru po shranjevanju objavite aplikacijo.
Odprite aplikacijo v napravi, na primer v telefonu ali tabličnem računalniku. Funkcij SaveData in LoadData ni mogoče uporabljati v Studiu ali v spletnem brskalniku. Če aplikacije ne vidite takoj, osvežite seznam aplikacij, saj lahko traja nekaj sekund, da se aplikacija prikaže v vaši napravi. Pomaga tudi, če se izpišete in znova vpišete v račun.

Ko je aplikacija prenesena, lahko prekinete povezavo z omrežjem in zaženete aplikacijo brez povezave.
Vnesite ime in fotografirajte predmet.
Izberite gumb Dodaj element. Nekajkrat ponovite dodajaje elementa, da naložite svojo zbirko.
Izberite gumb Shrani podatke. S tem boste shranili podatke v svoji zbirki v lokalno napravo.
Zaprite aplikacijo. Vaša zbirka v pomnilniku bo izgubljena, vključno z vsemi imeni in slikami elementov, vendar bodo še vedno v shrambi naprave.
Znova zaženite aplikacijo. Zbirka v pomnilniku bo v galeriji znova prikazana kot prazna.
Izberite gumb Naloži podatke. Zbirka bo znova izpolnjena s shranjenimi podatki v napravi, elementi pa bodo znova v galeriji. Zbirka je bila prazna, preden je ta gumb poklical funkcijo LoadData; pred nalaganjem podatkov iz shrambe ni bilo treba klicati funkcije Collect ali ClearCollect.
Znova izberite gumb Naloži podatke. Shranjeni podatki bodo priloženi na koncu zbirke in v galeriji bo prikazan drsni trak. Če ne želite priložiti podatkov, ampak jih zamenjati, uporabite funkcijo Clear in počistite zbirko, preden pokličete funkcijo LoadData.