SaveData, LoadData eta ClearData funtzioak

Artikulua
03/22/2024

Honi dagokio: Canvas aplikazioei

Gorde eta berriro kargatzen du bilduma aplikazioaren ostalariaren biltegitik.

Oharra

Funtzio hauek web arakatzaile batean aplikazio bat erreproduzitzerakoan erabil daitezke orain ezaugarri esperimentala. Ezaugarri hau lehenespenez desgaituta dago. Gaitzeko, joan hona Ezarpenak>Datozen ezaugarriak>Esperimentala>SaveData, LoadData, ClearData gaituta web erreproduzitzailean." eta aktibatu etengailua. Eginbide esperimental honi buruzko iritzia bidaltzeko, joan hona Power Apps komunitatearen foroa.

Deskribapenak

SaveData funtzioak bilduma bat gordetzen du izen bereko erabilerarako.

LoadData funtzioak bilduma bat kargatzen du aurretik gordetako izenarekin SaveData. Ezin duzu funtzio hau bilduma beste iturburu batetik kargatu.

ClearData funtzioak izen jakin baten azpian biltegiratzea garbitzen du edo aplikazioarekin lotutako biltegiratze guztia garbitzen du izenik ematen ez bada.

Oharra

Artean partekatutako izena SaveData, LoadData, eta ClearData gakoa da, ez fitxategi izen bat. Ez da konplexua izan behar izenak aplikazio bakoitzarentzat bakarra denik eta izen gatazka arriskurik ez dagoelako. Izenak ez du karaktere hauetakoren bat eduki behar: *".?:\<>|/.
SaveData 1 MBko datuetara mugatuta dago Power Apps Teams-en eta web-arakatzaile batean exekutatzen. Ez dago mugikor finkorik erreproduzitzaile mugikor batean exekutatzen diren Power Apps aplikazioetarako, baina jarraian azaltzen diren muga praktikoak daude.
Ez erabili SaveData datu sentikorra webean gordetzeko, testu arruntean gordeko baita.

Erabili funtzio hauek aplikazioaren abiaraztearen errendimendua hobetzeko:

Memoria cachearen datuak App.OnStart formula lehenengo exekuzio batean.
Tokiko cachea berriro kargatu hurrengo exekuzioetan.

Funtzio horiek gehitzeko ere erabil ditzakezu lineaz kanpoko gaitasun errazak zure aplikaziora.

Ezin dituzu arakatzaile baten barruan funtzio hauek erabili:

Aplikazioa idaztea Power Apps Studio-n.

Zure aplikazioa probatzeko, exekutatu Mugikorretarako Power Apps-en, iPhone edo Android gailu batean.

Funtzio horiek eskuragarri dagoen aplikazioaren memoria kopuruaren arabera mugatzen dira memoriaren bilduma batean funtzionatzen dutenean. Memoria eskuragarri faktoreen arabera alda daiteke:

Gailua eta sistema eragilea.
Power Apps erreproduzigailuak erabiltzen duen memoria.
Aplikazioaren konplexutasuna pantailekin eta kontrolekin.

Probatu aplikazioa datu handiak gordetzean aplikazioa exekutatzea espero duzun gailu moten inguruan. Espero orokorrean 30 MB eta 70 MB arteko memoria eskuragarri izatea.

Funtzio horiek bilduma inplizituki zehazten den araberakoak dira Collect edo ClearCollect. Ez duzu deitu beharrik Collect edo ClearCollect datuak bilduman kargatzeko, hori zehazteko. Erabilitakoan kasu arrunta da LoadData aurreko baten ondoren SaveData. Behar den guztia funtzio hauen presentzia da bildumaren egitura inplizituki definitzeko formula batean. Informazio gehiago lortzeko, ikusi aldagaiak sortu eta kentzea.

Kargatutako datuak bildumari erantsiko zaizkio. Erabili Clear funtzioa deitu aurretik LoadData funtzioa bilduma huts batekin hasi nahi baduzu.

Datuen segurtasuna

Kontuan izan arretaz SaveData -rekin gordetako datuen isolamendua eta enkriptatzea eta erabaki zure beharretarako egokia den, batez ere gailuak hainbat erabiltzailek partekatzen baditu.

SaveData rekin biltegiratutako datuak beste Power Apps etatik isolatzen dituzte Power Apps erreproduzitzaileek. Datuak aplikazioaren Aplikazioaren IDan oinarrituta gordetzen dira, eta SaveData izenen tartea automatikoki isolatuta dago Power Apps.

Sistema eragilea eta arakatzailea arduratzen da Power Apps ren eta gailu bateko eta webguneetako beste aplikazio batzuen arteko datuak isolatzeaz. Esate baterako, sistema eragilea arduratzen da Microsoft Outlook n gordetako datuak Power Appsn gordetako datuetatik isolatzeaz eta datu horiek Bing.com edo PowerApps.com. Sistema eragilearen barnean dauden aplikazioen sandbox instalazioak SaveData biltegiratzeko erabiltzen dira, eta normalean erabiltzaileak ez du eskura edo ezkutatu.

Aplikazio bera erabiltzean, sistema eragilea eta nabigatzailea ere arduratzen dira datuak isolatzeaz sistema eragilearen maila desberdinetako erabiltzaileen artean. Adibidez, bi erabiltzaile ezberdinek ordenagailu bat partekatzen badute eta Windows saio-hasierarako bi kredentzial ezberdin erabiltzen badituzte, sistema eragilea arduratuko da Windows bi erabiltzaileen arteko datuak isolatzeaz.

Datuak Power Apps erabiltzaile ezberdinen artean isolatuta egon daitezke ala ez, sistema eragilearen erabiltzailea bera bada. Power Apps Jokalari guztiek ez dute hori berdin tratatzen. Adibidez, Windows-eko erabiltzaile berarekin saioa hasita dagoen bitartean, Power Apps erreproduzitzailean, erabiltzailea Power Apps saioa amaitzen du eta beste Power Apps erabiltzaile gisa hasten da saioa. Aplikazio batean Power Apps erabiltzailea aldatu baino lehen gordetako datuak bigarren Power Apps erabiltzaileak erabil ditzake aplikazio berean. Baliteke datuak ere kendu eta lehen Power Apps erabiltzaileak ezin izango ditu atzitu. Jokalarien arteko Power Apps portaera aldatzen da.

Baliteke sistema eragileak datuak enkriptatzea edo gailu mugikorren kudeaketa tresna bat erabil dezakezu, esate baterako, Microsoft Intune. Web-arakatzaile batean aplikazio bat erreproduzitzean gordetako datuak ez daude enkriptatuta.

Sintaxia

Gorde datuak( Bilduma, Izena )
LoadData( Bilduma, Izena [, IgnoreNonexistentFile ])

Bilduma - Beharrezkoa. Gorde edo kargatu beharreko bilduma.
Izena - Beharrezkoa. Biltegiaren izena. Izen bera izan behar da datu multzo bera gordetzeko eta kargatzeko. Izenaren espazioa ez da beste aplikazio batzuekin partekatzen. Izenek ez dute karaktere hauetakoren bat eduki behar: *".?:\<>|/.
IgnoreNonexistentFile - Aukerakoa. Fitxategia lehendik ez badago, egin beharrekoa adierazten duen balio boolearra. Erabili faltsua (lehenetsia) errore bat itzultzeko eta egia errorea ezabatzeko.

ClearData( [Izena] )

Izena - Aukerakoa. Aurretik gordetako biltegiaren izena SaveData. Bada Izena ez da ematen, aplikazioarekin lotutako biltegiratze guztia garbitu egiten da.

Adibideak

Formula	Deskribapenak	Emaitza
SaveData( LocalCache, "MyCache")	Gorde LocalCache bilduma erabiltzailearen gailura "MyCache" izenarekin, egokia da LoadData geroago berreskuratzeko.	Datuak aplikazioaren ostalarian gordetzen dira "MyCache" izenarekin.
LoadData( LocalCache, "MyCache")	LocalCache bilduma kargatzen du erabiltzailearen gailutik "MyCache" izenarekin, aurretik dei batekin gordeta SaveData.	Datuak aplikazioaren ostalaritik kargatzen dira "MyCache" izenarekin.
GarbituData( "NireCache")	Biltegia "MyCache" izenarekin garbitzen du. Izen honekin gordetako datuak ez dira erabilgarri egongo LoadData.	Datuak aplikazioaren ostalaritik kentzen dira "MyCache" izenarekin.
GarbituData()	Garbitu aplikazio honi lotutako biltegiratze guztia. Beste aplikazio batzuek gordetako datuek ez dute eraginik.	Datu guztiak aplikazioaren ostalaritik kentzen dira.

Lineaz kanpoko adibide sinplea

Adibide soil bat jarraituz, lineaz kanpoko argazkiak dauden eguneroko elementuen izenak eta argazkiak gordetzen eta gordetzen ditu. Gailua bertako biltegian gordetzen du informazioa gero erabiltzeko. Horri esker, aplikazioa itxi edo gailua berrabiarazi daiteke datuak galdu gabe.

Oharra

Adibide honek kameraren kontrola erabiltzen du irudiak ateratzeko. Geroztik SaveData 1 MBko datuetara mugatuta dago Teams-en edo web-arakatzaile batean exekutatzen denean, adibide honek ez du funtzionatuko irudi gutxi batzuekin. Gainera, kameraren arabera, baliteke irudi batekin ere ez funtzionatzea. Erabili gailu bat adibide osoa lantzeko, edo kendu adibide honen kameraren kontrola eta irudiaren zatia Teams-en edo web-arakatzaile batean exekutatzeko.

Sortu mihise-aplikazio huts bat tableta diseinuarekin. Xehetasun gehiago nahi izanez gero, irakurri aplikazio bat txantiloi batetik sortuz eta hautatu Tabletaren diseinua beherako Aplikazio hutsa.
Gehitu Text input kontrola eta a Kamera kontrola eta antolatu gutxi gorabehera erakusten den moduan:
Gehitu Button kontrola.
Egin klik bikoitza botoiaren kontrolean botoiaren testua aldatzeko Gehitu elementua (edo aldatu Testua propietatea).
Ezar ezazu botoiaren kontrolaren OnSelect propietatea gure bilduman elementu bat gehituko duen formula honetara:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Gehitu beste Botoia kontrol bat.
Egin klik bikoitza botoiaren kontrolean botoiaren testua aldatzeko Gorde datuak (edo aldatu Testua propietatea).
Ezar ezazu botoiaren kontrolaren OnSelect propietatea gure bilduma gordetzeko tokiko gailuan:
```
SaveData( MyItems, "LocalSavedItems" )
```
Pentsagarria da botoia probatzea, ezer eragiten ez duelako. Baina web arakatzaile batean idazten ari zarenean errore bat bakarrik ikusiko duzu. Gorde aplikazioa lehenik eta ireki gailuan formula hau probatzeko hurrengo pausoak jarraitu aurretik:
Gehitu hirugarren Botoia kontrola.
Egin klik bikoitza botoiaren kontrolean botoiaren testua aldatzeko Kargatu datuak (edo aldatu Testua propietatea).
Ezar ezazu botoiaren kontrolaren OnSelect propietatea gure bilduma kargatzeko tokiko gailutik:
```
LoadData( MyItems, "LocalSavedItems" )
```
Gehitu Galeria kontrola irudi eta testu eremuak biltzen dituen diseinu bertikalarekin:
Eskatuz gero, hautatu MyItems bilduma galeria honetarako datu-iturburu gisa. Horrek ezarriko du Galeria kontrolaren Elementuak propietatea:

Galeria txantiloian dagoen irudi-kontrolak Image propietatearen ThisItem.Picture eta etiketa-kontrolek biak beharko lukete. lehenetsita euren Testua propietateak ThisItem.Item. Begiratu formula hauek ondorengo urratsetan elementuak gehitu ondoren galerian ez duzula ezer ikusten.
Eraman kontrola beste kontrol batzuen eskuinaldera:
Gorde aplikazioa. Gorde den lehen aldia bada, ez da argitaratu beharrik. Lehen aldia ez bada, argitaratu aplikazioa gorde ondoren.
Ireki aplikazioa gailu batean, telefonoan edo tabletan adibidez. SaveData eta LoadData ezin dira Studio-n edo web-arakatzaile batean erabili. Aplikatu zerrenda berriztatu aplikazioa berehala ikusten ez baduzu, segundo batzuk behar izan ditzakezu aplikazioa zure gailuan agertzeko. Hasi saioa edo berriro saioa zure kontuan ere lagun dezake.

Zure aplikazioa deskargatu ondoren, saretik deskonektatu eta aplikazioa lineaz kanpo exekutatu dezakezu.
Idatzi izena eta atera elementu baten argazkia.
Sakatu Gehitu elementua botoia. Errepikatu elementuak bi aldiz gehituz zure bilduma kargatzeko.
Hautatu Gorde datuak botoia. Horrek zure bildumako datuak tokiko gailuan gordeko ditu.
Itxi aplikazioa. Memoriako bilduma galdu egingo da elementu izen eta argazki guztiak barne, baina gailuaren biltegian egongo dira.
Abiarazi aplikazioa berriro. Memoriako bilduma galerian hutsik agertuko da berriro.
Hautatu Kargatu datuak botoia. Bilduma zure gailuan gordetako datuetatik berriz berriro beteko da eta zure elementuak galeriara itzuliko dira. Bilduma hutsik zegoen botoi hau deitu aurretik LoadData funtzioa; ez zegoen deitu beharrik Collect edo ClearCollect datuak biltegitik kargatu aurretik.
Hautatu Kargatu datuak botoia berriro. Biltegiratutako datuak bildumaren amaieran erantsiko dira eta korritze barra bat agertuko da galerian. Erantsi nahi baduzu, erabili nahi baduzu Clear funtzioa lehenbizi bilduma garbitzeko deitu aurretik LoadData funtzioa.