Funkcijas SaveData, LoadData un ClearData

Raksts
03/22/2024

Attiecas uz: Audekla programmām

Saglabā un atkārtoti ielādē kolekciju no lietojumprogrammas viesošanas krātuves.

Note

Šīs funkcijas tagad var izmantot, spēlējot programmu tīmekļa pārlūkprogrammā kā eksperimentālu līdzekli. Šis līdzeklis ir atspējots pēc noklusējuma. Lai iespējotu opciju, pārejiet uz Iestatījumi>Gaidāmie līdzekļi>Eksperimentāli>Iespējot SaveData, LoadData, ClearData tīmekļa atskaņotājam." un ieslēdziet to. Lai iesniegtu atsauksmes par šo eksperimentālo līdzekli, apmeklējiet Power Apps kopienas forumu.

Apraksts

Funkcija SaveData glabā kolekciju vēlākai lietošanai ar nosaukumu.

Funkcija LoadData pārlādē kolekciju pēc nosaukuma, kas iepriekš tika saglabāts ar funkciju SaveData. Šo funkciju nevarat izmantot, lai ielādētu kolekciju no cita avota.

Izmantojot ClearData funkciju, krātuve tiek notīrīta ar noteiktu nosaukumu vai tiek notīrīta visa ar šo lietojumprogrammu saistītā krātuve, ja nosaukuma nav.

Note

Nosaukums, kas tiek koplietots starp SaveData, LoadData un ClearData, ir atslēga, nevis faila nosaukums. Tam nav jābūt sarežģītam, jo nosaukumi ir unikāli katrai programmai un nepastāv nosaukumu konfliktu apdraudējums. Nosaukumā nedrīkst būt šādas rakstzīmes: *".?:\<>|/
SaveData ir 1 MB datu ierobežojums, kas Power Apps tiek rādīti programmā Teams un tīmekļa pārlūkprogrammā. Nav fiksētu ierobežojumu programmai Power Apps, kas palaista mobilajā atskaņotājā, bet ir praktiski ierobežojumi, kas ir aprakstīti tālāk.
Nelietojiet SaveData, lai glabātu sensitīvus datus tīmeklī, jo tie tiks saglabāti vienkāršā tekstā.

Izmantojiet šīs funkcijas, lai uzlabotu programmas startēšanas veiktspēju ar šādiem līdzekļiem:

Datu saglabāšana kešatmiņā formulā App.OnStart pirmās palaišanas laikā.
Lokālās kešatmiņas pārlādēšana nākamās palaišanas laikā.

Varat arī lietot šīs funkcijas, lai savai programmai pievienotu vienkāršas bezsaistes iespējas.

Šīs funkcijas nevarat lietot pārlūkā, kad:

Autorējat programmu pakalpojumā Power Apps Studio.

Lai testētu programmu, palaidiet to Power Apps Mobile ierīcē iPhone vai Android.

Šo funkciju ierobežojums ir pieejamās programmas atmiņas daudzums, jo tās darbojas atmiņas kolekcijā. Pieejamā atmiņa var atšķirties atkarībā no faktoriem, piemēram:

Ierīce un operētājsistēma
Atmiņa, kuru izmanto Power Apps atskaņotājs.
Programmas sarežģītība ar ekrāniem un vadīklām.

Testējiet programmu ar sagaidāmajiem scenārijiem tāda veida ierīcēs, kurās paredzat palaist programmu, glabājot lielus datus. Kopumā ieplānojiet, ka pieejamā atmiņa būs no 30 MB līdz 70 MB.

Šīs funkcijas ir atkarīgas no tā, ka kolekcija tiek netieši definēta ar funkcijām Collect vai ClearCollect. Jums nav jāizsauc funkcija Collect vai ClearCollect, lai ielādētu datus kolekcijā tās definēšanai. Tas ir parasts pieteikums, izmantojot funkciju LoadData pēc iepriekšējās SaveData. Ir nepieciešama tikai šo funkciju klātbūtne, lai netieši definētu kolekcijas struktūru. Papildinformāciju skatiet sadaļā mainīgo izveide un noņemšana.

Ielādētie dati tiks pievienoti kolekcijai. Izmantojiet funkciju Clear pirms izsaucat LoadData, ja vēlaties sākt ar tukšu kolekciju.

Datu drošība

Rūpīgi apsveriet ar SaveData saglabāto datu izolāciju un šifrēšanu un izlemiet, vai tie ir piemēroti jūsu vajadzībām, it īpaši, ja ierīces koplieto vairāki lietotāji.

Datus, kas tiek glabāti ar SaveData , Power Apps spēlētāji izolē no citiem Power Apps . Dati tiek glabāti, pamatojoties uz lietotnes lietotnes ID, automātiski izolējot SaveData nosaukuma atstarpi starp tām Power Apps.

Operētājsistēma un pārlūkprogramma ir atbildīga par datu izolēšanu starp Power Apps un citām lietotnēm ierīcē un ar vietnēm. Piemēram, operētājsistēma ir atbildīga par Microsoft Outlook glabāto datu izolēšanu no datiem, kas tiek glabāti Power Apps, kā arī šo datu izolēšanu no tādām vietnēm kā Bing.com vai PowerApps.com. Operētājsistēmas iebūvētās lietotņu smilškastes iekārtas tiek izmantotas SaveData krātuvei , kas parasti nav pieejama vai paslēpta no lietotāja.

Izmantojot vienu un to pašu lietotni, operētājsistēma un pārlūkprogramma ir atbildīga arī par datu izolēšanu starp dažādiem operētājsistēmas līmeņa lietotājiem. Piemēram, ja divi dažādi lietotāji koplieto datoru un izmanto divus dažādus Windows pieteikšanās akreditācijas datus, operētājsistēma ir atbildīga par datu izolēšanu starp diviem Windows lietotājiem.

Dati var būt vai nebūt izolēti starp dažādiem Power Apps lietotājiem, ja operētājsistēmas lietotājs ir viens un tas pats. Ne katrs Power Apps spēlētājs pret to izturas vienādi. Piemēram, kamēr esat pieteicies kā tas pats Windows lietotājs, atskaņotājā Power Apps lietotājs izrakstās un pierakstās Power Apps kā cits Power Apps lietotājs. Dati, kas lietotnē saglabāti pirms lietotāja maiņas Power Apps , var būt pieejami otrajam Power Apps lietotājam tajā pašā lietotnē. Dati var arī tikt noņemti, un pirmais Power Apps lietotājs, iespējams, vairs nevarēs tiem piekļūt. Spēlētāju uzvedība atšķiras Power Apps .

Operētājsistēma var arī šifrēt datus vai izmantot mobilo ierīču pārvaldības rīku, piemēram, Microsoft Intune. Dati, kas tiek glabāti, lietojumprogrammu spēlējot tīmekļa pārlūkprogrammā, nav šifrēti.

Sintakse

SaveData( Kolekcija, Nosaukums )
LoadData( Kolekcija, Nosaukums [, IgnoreNonexistentFile ])

Kolekcija – Obligāti. Glabājamā vai ielādējamā kolekcija.
Nosaukums— Obligāts. Glabātuves nosaukums. Nosaukumam ir jābūt vienādam, lai saglabātu un ielādētu vienu un to pašu datu kopu. Nosaukuma vieta netiek koplietota ar citām programmām. Nosaukumi nedrīkst saturēt nevienu no šīm rakstzīmēm: *".?:\<>|/.
IgnoreNonexistentFile — Neobligāti. Būla vērtība, kura norāda, kā rīkoties, ja fails jau nepastāv. Izmantojiet vērtību false noklusējuma, lai atgrieztu kļūdu, un vērtību true, lai kļūdu izlaistu.

ClearData( [Name] )

Nosaukums — Neobligāts. Ar SaveData iepriekš saglabātas krātuves nosaukums. Ja Nosaukums netiek nodrošināts, tiek notīrīta visa ar šo lietojumprogrammu saistītā krātuve.

Piemēri

Formula	Apraksts	Rezultāts
SaveData( LocalCache, "MyCache" )	Saglabājiet kolekciju LocalCache lietotāja ierīcē ar nosaukumu "MyCache", kas ir piemērots LoadData vēlākai izgūšanai.	Dati tiek saglabāti lietojumprogrammas viesošanas vietnē ar nosaukumu "MyCache".
LoadData( LocalCache, "MyCache" )	Ielādē kolekciju LocalCache no lietotāja ierīces ar nosaukumu "MyCache", kas iepriekš saglabāta ar izsaukumu funkcijai SaveData.	Dati tiek ielādēti no lietojumprogrammas viesošanas vietnē ar nosaukumu "MyCache".
ClearData( "MyCache" )	Notīra krātuvi ar nosaukumu "MyCache". Jebkuri ar šo nosaukumu saglabātie dati vairs nebūs pieejami, izmantojot LoadData.	Dati tiek izdzēsti no lietojumprogrammas viesošanas vietnē ar nosaukumu "MyCache".
ClearData()	Notīriet visu krātuvi, kas saistīta ar šo programmu. Citu programmu saglabātie dati netiek ietekmēti.	Visi dati tiek noņemti no programmas viesošanas vietas.

Vienkāršs bezsaistes piemērs

Ievērojot šo vienkāršo piemēru, tiek tverti un uzglabāti ikdienas vienumu nosaukumi un attēli, atrodoties bezsaistē. Tajā informācija tiek glabāta ierīces lokālajā krātuvē, lai to izmantotu vēlāk. Tādējādi var aizvērt programmu vai restartēt ierīci, nezaudējot datus.

Note

Šajā piemērā attēlu tveršanai tiek izmantota kameras vadīkla. Tā kā SaveData ir 1 MB datu ierobežojums, palaižot Teams vai tīmekļa pārlūkprogrammu, šis piemērs nedarbosies vairāk kā ar dažiem attēliem. Atkarībā no kameras var arī nebūt darba ar vienu attēlu. Izmantojiet ierīci, lai strādātu ar šo pilno piemēru, vai noņemiet šī piemēram kameras vadīklu un attēla daļu, lai to izpildītu komandās vai tīmekļa pārlūkprogrammā.

Izveidojiet tukšu pamatnes programmu ar planšetdatora izkārtojumu. Papildinformāciju skatiet rakstā programmas izveide no veidnes un sadaļā Tukša programma atlasiet Planšetdatora izkārtojums.
Pievienojiet Teksta ievades vadīklu un Kameras vadīklu un sakārtojiet tās aptuveni tā, kā parādīts:
Pievienojiet vadīklu Button.
Veiciet dubultklikšķi uz pogas vadīklas, lai mainītu pogas tekstu uz Pievienot elementu (vai pārveidotu Teksta rekvizītu).
Iestatiet pogas vadīklas rekvizītu OnSelect uz šo formulu, kas pievienos elementu mūsu kolekcijai:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Pievienojiet citu Pogas vadīklu.
Veiciet dubultklikšķi uz pogas vadīklas, lai mainītu pogas tekstu uz Saglabāt datus (vai pārveidotu Teksta rekvizītu).
Iestatiet pogas vadīklas rekvizītu OnSelect uz šo formulu, lai saglabātu mūsu kolekciju lokālajā ierīcē:
```
SaveData( MyItems, "LocalSavedItems" )
```
Ir vilinoši testēt pogu, jo tas neko neietekmē. Taču jūs redzēsit vienīgi kļūdu, jo jūs rediģējat tīmekļa pārlūkā. Vispirms saglabājiet programmu ierīcē, pirms veicat tālākās darbības šīs formulas testēšanai:
Pievienojiet trešo Pogas vadīklu.
Veiciet dubultklikšķi uz pogas vadīklas, lai mainītu pogas tekstu uz Ielādēt datus (vai pārveidotu Teksta rekvizītu).
Iestatiet pogas vadīklas rekvizītu OnSelect uz šo formulu, lai ielādētu mūsu kolekciju no lokālās ierīces:
```
LoadData( MyItems, "LocalSavedItems" )
```
Pievienojiet Gallery vadīklu, izmantojot vertikālo izkārtojumu, kurā ir attēls un teksta apgabali:
Kad tas tiek piedāvāts, atlasiet kolekciju MyItems kā šīs galerijas datu avotu. Tādējādi tiks iestatīts Galerijas vadīklas rekvizīts Elementi:

Attēla vadīklai galerijas veidnē pēc noklusējuma ir jābūt attēla rekvizītam ThisItem.Picture , un etiķešu vadīklām pēc noklusējuma tekstarekvizītiir jābūt ThisItem.Item. Pārbaudiet šīs formulas, ja pēc elementu pievienošanas šajās darbībās galerijā neko neredzat.
Novietojiet vadīklu pa labi no citām vadīklām:
Saglabājiet programmu. Ja šī ir pirmā reize, kad tā tiek saglabāta, nav vajadzības to publicēt. Ja šī nav pirmā reize, pēc saglabāšanas publicējiet programmu.
Atveriet savu programmu ierīcē, piemēram, tālrunī vai planšetdatorā. Funkcijas SaveData un LoadData nevar izmantot pakalpojumā Studio vai tīmekļa pārlūkā. Atsvaidziniet programmu sarakstu, ja savu programmu neredzat uzreiz. Lai programma parādītos ierīcē, var paiet dažas sekundes. Var palīdzēt arī izrakstīšanās un atkārtota pierakstīšanās kontā.

Kad lietotne ir lejupielādēta, varat pārtraukt savienojumu ar tīklu un palaist programmu bezsaistē.
Ievadiet elementa nosaukumu un uzņemiet tā fotoattēlu.
Atlasiet pogu Pievienot elementu. Atkārtoti pievienojiet elementus pāris reizes, lai ielādētu kolekciju.
Saglabājiet pogu Saglabāt datus. Tādējādi jūsu kolekcijas dati tiks saglabāti lokālajā ierīcē.
Aizveriet programmu. Jūsu kolekcijas atmiņā tiks zaudētas, ieskaitot visu elementu nosaukumus un attēlus, bet tie joprojām būs pieejami ierīces krātuvē.
Atkārtoti palaidiet programmu. Atmiņas kolekcija atkal galerijā tiks rādīta kā tukša.
Atlasiet pogu Ielādēt datus. Kolekcija tiks papildināta no jauna no jūsu ierīcē glabātajiem datiem, un jūsu elementi tiks atgriezti galerijā. Kolekcija bija tukša, pirms šī poga izsauca funkciju LoadData; nebija vajadzības izsaukt funkcijas Collect vai ClearCollect pirms datu ielādes no krātuves.
Vēlreiz atlasiet pogu Load Data. Saglabātie dati tiks pievienoti kolekcijas beigām, un galerijā tiks parādīta ritjosla. Ja vēlaties aizstāt, nevis pievienot, vispirms izmantojiet funkciju Clear, lai noņemtu kolekciju, pirms tiek izsaukta funkcija LoadData.