SaveData, LoadDataun ClearData funkcijas

Attiecas uz: Audekla programmām

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

Apraksts

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

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

Funkcija ClearData notīra krātuvi ar noteiktu nosaukumu vai notīra visu ar programmu saistīto krātuvi, ja nosaukums nav norādīts.

Note

• Nosaukums, kas tiek koplietots starp SaveData, LoadDataun ir ClearData 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 ierobežots līdz 1 MB datu Power Apps, kas darbojas 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.
• Neizmantojiet SaveData , lai glabātu sensitīvus datus tīmeklī, jo tie tiks glabā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 izplatīts gadījums, lietojot LoadData pēc iepriekšējā 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. Pirms zvanīšanas LoadData izmantojiet funkciju Notīrīt, ja vēlaties sākt ar tukšu kolekciju.

Datu drošība

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

Power Apps atskaņotāji tiek izolēti no SaveData citiem Power Apps glabātajiem datiem. Dati tiek glabāti, pamatojoties uz programmas programmas ID, automātiski izolējot SaveData nosaukumu telpu starp 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 lietotnes smilškastes iespējas tiek izmantotas glabāšanai SaveData , kas parasti nav pieejama lietotājam vai paslēpta no tā.

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 Power Apps un pierakstās 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 - Nepieciešams. 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āts. 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( [Vārds] )

• Nosaukums - Pēc izvēles. Krātuves nosaukums, kas iepriekš saglabāts ar SaveData. 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 LocalCache kolekciju lietotāja ierīcē ar nosaukumu "MyCache", kas ir LoadData piemērots vēlākai izgūšanai.	Dati tiek saglabāti lietojumprogrammas viesošanas vietnē ar nosaukumu "MyCache".
LoadData(LocalCache, "MyCache")	Ielādē LocalCache kolekciju no lietotāja ierīces ar nosaukumu "MyCache", kas iepriekš tika saglabāta ar zvanu uz SaveData.	Dati tiek ielādēti no lietojumprogrammas viesošanas vietnē ar nosaukumu "MyCache".
ClearData( "MyCache" )	Notīra krātuvi ar nosaukumu "MyCache". Visi dati, kas tiek glabāti ar šo nosaukumu, 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 tas ir ierobežots līdz 1 MB datu, palaižot Teams vai tīmekļa pārlūkprogrammā, šis piemērs nedarbosies ar vairāk nekā 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ā.

1. 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.

2. Pievienojiet Teksta ievades vadīklu un Kameras vadīklu un sakārtojiet tās aptuveni tā, kā parādīts:

   

3. Pievienojiet vadīklu Button.

4. Veiciet dubultklikšķi uz pogas vadīklas, lai mainītu pogas tekstu uz Pievienot elementu (vai pārveidotu Teksta rekvizītu).

5. Iestatiet pogas vadīklas rekvizītu OnSelect uz šo formulu, kas pievienos elementu mūsu kolekcijai:

   Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
   

   

6. Pievienojiet citu Pogas vadīklu.

7. Veiciet dubultklikšķi uz pogas vadīklas, lai mainītu pogas tekstu uz Saglabāt datus (vai pārveidotu Teksta rekvizītu).

8. 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:

9. Pievienojiet trešo Pogas vadīklu.

10. Veiciet dubultklikšķi uz pogas vadīklas, lai mainītu pogas tekstu uz Ielādēt datus (vai pārveidotu Teksta rekvizītu).

11. 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" )
    

    

12. Pievienojiet Gallery vadīklu, izmantojot vertikālo izkārtojumu, kurā ir attēls un teksta apgabali:

    

13. 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 teksta rekvizīti ir jābūt ThisItem.Item. Pārbaudiet šīs formulas, ja pēc elementu pievienošanas šajās darbībās galerijā neko neredzat.

14. Novietojiet vadīklu pa labi no citām vadīklām:

    

15. 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.

16. Atveriet savu programmu ierīcē, piemēram, tālrunī vai planšetdatorā. SaveData un LoadData to nevar izmantot Studio vai tīmekļa pārlūkprogrammā. 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ē.

17. Ievadiet elementa nosaukumu un uzņemiet tā fotoattēlu.

18. Atlasiet pogu Pievienot elementu. Atkārtoti pievienojiet elementus pāris reizes, lai ielādētu kolekciju.

    

19. Saglabājiet pogu Saglabāt datus. Tādējādi jūsu kolekcijas dati tiks saglabāti lokālajā ierīcē.

20. 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ē.

21. Atkārtoti palaidiet programmu. Atmiņas kolekcija atkal galerijā tiks rādīta kā tukša.

    

22. 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 izsauc LoadData funkciju; pirms datu ielādes no krātuves nebija nepieciešams izsaukt Collect vai ClearCollect .

    

23. 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 Notīrīt , lai notīrītu kolekciju pirms funkcijas izsaukšanas LoadData .

    

Detalizētāks bezsaistes piemērs

Detalizētu piemēru skatiet rakstā par vienkāršām bezsaistes iespējām.