Funkcijos SaveData, LoadData ir ClearData

Straipsnis
03/22/2024

Taikoma: drobės programoms

Įrašo ir pakartotinai įkelia rinkinį iš programos pagrindinio kompiuterio saugyklos.

Pastaba.

Šias funkcijas dabar galima naudoti žaidžiant programą žiniatinklio naršyklėje kaip eksperimentinę funkciją. Pagal numatytuosius nustatymus ši funkcija išjungta. Norėdami įjungti, pereikite prie parametrų>būsimų funkcijų>Eksperimentinės>Enabled SaveData, LoadData, ClearData tinklo grotuve." ir vėl įjunkite. Norėdami pateikti atsiliepimų apie šią susodinę funkciją, eikite į „Power Apps“ bendruomenės forumą.

Aprašymas

SaveData funkcija saugo pavadintą rinkinį, skirtą vėlesniam naudojimui.

LoadData funkcija iš naujo įkelia rinkinį pagal pavadinimą, kuris anksčiau buvo įrašytas su SaveData. Šios funkcijos negalima naudoti norint įkelti rinkinį iš kito šaltinio.

„ClearData" funkcija išvalo saugyklą tam tikro pavadinimo saugykloje arba, jei nėra pavadinimo, išvalo visą su programa susietą saugyklą.

Pastaba.

Vardas, bendrai naudojamas tarp „SaveData",„LoadData“ ir „ClearData", yra raktas, o ne failo vardas. Tai nebūtinai turi būti sudėtingas, nes kiekvienos programos pavadinimai skirtingi ir nėra pavojaus dėl pavadinimų konflikto. Pavadinime negali būti tokių *".?:\<>|/simbolių:
SaveData ribojama iki 1 MB „Power Apps“ duomenų, kad būtų galima paleisti komandose ir žiniatinklio naršyklėje. Negalima nustatyti fiksuoto mobiliųjų „Power Apps“ žaidėjų veiklos apribojimo, tačiau toliau pateikiami praktiniai apribojimai.
Nenaudokite Įrašyti duomenis slaptiems duomenims žiniatinklyje saugoti, nes jie bus išsaugoti paprastuoju tekstu.

Naudodami šias funkcijas, galite pagerinti programų paleisties našumą:

App.OnStart formulės pirmojo paleidimo talpykloje kaupimas.
Iš naujo įkeliama vietinė talpykla kitų vykdymų metu.

Taip pat galite naudoti šias funkcijas norėdami įtraukti paprastas autonomines galimybes į savo programą.

Naršyklėje negalite naudoti šių funkcijų, kai:

Programos kūrimas „Power Apps Studio”.

Norėdami patikrinti programą, paleiskite ją mobiliojoje "Power Apps" versijoje, „iPhone” arba Android įrenginyje.

Šias funkcijas riboja galimos programos atminties kiekis, nes jos veikia atminties rinkinyje. Galima atmintis gali skirtis atsižvelgiant į tokius veiksnius kaip:

Prietaisas ir operacinė sistema.
"Power Apps" leistuvės naudojama atmintis.
Programos sudėtingumas ekranuose ir valdikliuose.

Patikrinkite programą su tikėtinais scenarijais įrenginiuose, kuriuose leisite programą, ar paleiskite įrenginyje, kuriame saugomas didelis duomenų kiekis. Tikėkitės turėti nuo 30 MB iki 70 MB galimos laisvos atminties.

Šios funkcijos priklauso nuo rinkinio, kuris yra netiesiogiai apibrėžtas kaip CollectarbaClearCollect. Jums nereikia iškviesti Collectarba ClearCollect, kad duomenys būtų įkelti į rinkinį, norint jį apibrėžti. Įprasta naudoti LoadData po ankstesnio SaveData. Viskas, ko reikia, kad šios funkcijos būtų formulėje, siekiant netiesiogiai apibrėžti rinkinio struktūrą. Daugiau informacijos žr. kintamųjų kūrimas ir pašalinimas .

Įkelti duomenys bus pridedami prie rinkinio. ClearPrieš iškviesdami naudokite funkciją, LoadDataJei norite pradėti su tuščiu rinkiniu.

Duomenų sauga

Atidžiai apsvarstykite "SaveData " saugomų duomenų izoliaciją ir šifravimą ir nuspręskite, ar tai tinka jūsų poreikiams, ypač jei įrenginius bendrina keli vartotojai.

Duomenys, saugomi naudojant "SaveData", yra izoliuoti Power Apps nuo kitų Power Apps žaidėjų. Duomenys saugomi pagal programos ID, automatiškai išskiriant "SaveData" pavadinimo tarpą tarp jų Power Apps.

Operacinė sistema ir naršyklė yra atsakingos už duomenų atskyrimą tarp Power Apps kitų įrenginyje esančių programų ir svetainių. Pavyzdžiui, operacinė sistema yra atsakinga už saugomų duomenų atskyrimą nuo saugomų Microsoft Outlook duomenų ir tų duomenų Power Appsatskyrimą nuo tokių svetainių kaip Bing.com arba PowerApps.com. Operacinės sistemos integruotos programos smėlio dėžės patalpos naudojamos "SaveData " saugyklai , kuri paprastai nėra prieinama vartotojui arba paslėpta nuo jo.

Naudojant tą pačią programą, operacinė sistema ir naršyklė taip pat yra atsakingos už duomenų atskyrimą tarp skirtingų operacinės sistemos lygio vartotojų. Pavyzdžiui, jei du skirtingi vartotojai dalijasi kompiuteriu ir naudoja du skirtingus "Windows" prisijungimo duomenis, operacinė sistema yra atsakinga už duomenų atskyrimą tarp dviejų "Windows" vartotojų.

Duomenys gali būti atskirti arba nebūti tarp skirtingų Power Apps vartotojų, jei operacinės sistemos vartotojas yra tas pats. Ne kiekvienas Power Apps žaidėjas su tuo elgiasi vienodai. Pavyzdžiui, būdamas prisijungęs kaip tas pats "Windows" vartotojas, leistuve Power Apps vartotojas atsijungia Power Apps ir prisijungia kaip kitas Power Apps vartotojas. Duomenys, saugomi programoje prieš pasikeičiant Power Apps naudotojui, gali būti pasiekiami antrajam Power Apps naudotojui toje pačioje programoje. Duomenys taip pat gali būti pašalinti ir pirmasis Power Apps vartotojas gali nebegalėti jų pasiekti. Žaidėjų elgesys skiriasi Power Apps .

Operacinė sistema taip pat gali užšifruoti duomenis arba galite naudoti mobiliųjų įrenginių valdymo įrankį, pvz., "Microsoft Intune". Duomenys, saugomi žaidžiant programą žiniatinklio naršyklėje, nėra užšifruojami.

Sintaksė

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

Rinkinys - Būtinas. Rinkinys, kurį reikia saugoti arba įkelti.
Pavadinimas - Būtinas. Talpyklos pavadinimas. Pavadinimas turi būti toks pats, kad būtų įrašyti ir įkelti tas pats duomenų rinkinys. Vardų sritis nebendrinama su kitomis programėlėmis. Pavadinime negali būti tokių simbolių: *".?:\<>|/
IgnoreNonexistentFile - Pasirinktinis. Bulio logikos vertė, nurodanti, ką daryti, jei failas dar neegzistuoja. Naudokite false(numatytoji), kad grąžintų klaidą ir true, kad nerodytų klaidos.

ClearData ( [ Pavadinimas ] )

Vardas - Pasirinktinis. Anksčiau su SaveData įrašytos saugyklos pavadinimas. Jei Pavadinimas nepateikiamas, išvaloma visa su programa susieta saugykla.

Pavyzdžiai

Formulė	Aprašymas	Rezultatas
SaveData( LocalCache, "MyCache" )	Įrašykite LocalCacherinkinį vartotojo įrenginyje pavadinimu „Mano talpykla”, tinkamą LoadData, kad galėtumėte gauti vėliau.	Duomenys įrašomi į programos pagrindinį kompiuterį pavadinimu „MyCache".
LoadData( LocalCache, "MyCache" )	Įkelia LoadData rinkinį iš vartotojo įrenginio pavadinimu „Mano talpykla”, anksčiau išsaugotą skambučiu SaveData.	Duomenys įrašomi iš programos pagrindinio kompiuterio pavadinimu „MyCache".
„ClearData“( „MyDatache")	Išvalo saugyklą po pavadinimu „MyCache". Naudojant „LoadData" nebebus galima naudoti jokių šiuo pavadinimu saugomų duomenų.	Duomenys pašalinami iš programos pagrindinio kompiuterio pavadinimu „MyCache".
„ClearData()“	Išvalykite visą su šia programa susietą saugyklą. Kitų programų saugomi duomenys neturi įtakos.	Visi duomenys pašalinami iš programos pagrindinio kompiuterio.

Paprastas autonominis pavyzdys

Šiame paprastame pavyzdyje užfiksuojami ir įsimenami kasdienių elementų pavadinimai bei nuotraukos neprisijungus. Jame saugoma informacija įrenginio vietinėje saugykloje, kad būtų galima naudoti vėliau. Tai leidžia uždaryti programą arba įrenginyje iš naujo paleisti neprarandant duomenų.

Pastaba.

Šiame pavyzdyje vaizdams įrašyti naudojamas vaizdo kameros valdiklis. Kadangi SaveData ribojasi iki 1 MB duomenų, kai vykdoma „Teams" arba žiniatinklio naršyklėje, šis pavyzdys neveiks su daugiau nei keliais vaizdais. Be to, atsižvelgiant į vaizdo kamerą, jis gali neveikti ir su vienu vaizdu. Naudokitės šiuo visu pavyzdžiu naudodami įrenginį arba pašalinkite vaizdo kameros valdiklį ir šio pavyzdžio paveikslėlio dalį norėdami paleisti „Teams“ arba žiniatinklio naršyklėje.

Sukurkite tuščią drobės programą naudodami planšetinio kompiuterio maketą. Daugiau informacijos rasite straipsnyje Programos kūrimas pagal šablonąir pasirinkite Tablet layoutBlank app.
Įtraukite Text inputvaldiklį ir Cameravaldiklį ir išdėstykite juos maždaug taip, kaip parodyta:
Įtraukite Button valdiklį.
Dukart spustelėkite mygtuko valdiklį, kad pakeistumėte mygtuko tekstą, kad galėtumėte Add Item (arba modifikuoti Text ypatybę).
Nustatykite OnSelectmygtuko valdiklio ypatybę šiai formulei, kuri įtrauks elementą į mūsų rinkinį:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Įtraukite kitą Button valdiklį.
Dukart spustelėkite mygtuko valdiklį, kad pakeistumėte mygtuko tekstą, kad galėtumėte Save Data (arba modifikuoti Textypatybę).
Nustatykite OnSelectmygtuko valdiklio ypatybę šiai formulei, kad galėtumėte įrašyti mūsų rinkinį į vietinį įrenginį:
```
SaveData( MyItems, "LocalSavedItems" )
```
Vilioja išbandyti mygtuką, kadangi jis nieko nekeičia. Bet bus rodoma tik klaida, kai kuriate žiniatinklio naršyklėje. Prieš sekdami instrukciją patikrinti šią formulę, pirma įrašykite programą ir atidarykite ją įrenginyje:
Įtraukite trečią Mygtuko valdiklį.
Dukart spustelėkite mygtuko valdiklį, kad pakeistumėte mygtuko tekstą, kad galėtumėte Load Data (arba modifikuoti Textypatybę).
Nustatykite OnSelectmygtuko valdiklio ypatybę šiai formulei, kad galėtumėte įkelti mūsų rinkinį iš vietinio įrenginio:
```
LoadData( MyItems, "LocalSavedItems" )
```
Įtraukite Galleryvaldiklį su vertikaliu išdėstymu, kuriame yra paveikslėlių ir teksto sričių:
Paraginti, pažymėkite MyItemsrinkinį kaip šios galerijos duomenų šaltinį. Taip nustatysite Items ypatybę Gallery valdiklio:

Galerijos šablono vaizdo valdiklis pagal numatytuosius nustatymus savo ypatybę Vaizdas turėtų būti ThisItem.Picture , o etikečių valdikliai pagal numatytuosius nustatymus turėtų būti teksto ypatybės į ThisItem.Item. Patikrinkite šias formules, jei įtraukę elementus į šiuos žingsnius, nieko nematote galerijoje.
Nustatykite valdiklio padėtį į kitų valdiklių dešinę:
Įrašykite savo programą. Jei tai pirmas kartas, kai ji įrašoma, nereikia jos publikuoti. Jei ne pirmą kartą, publikuokite programą prieš įrašydami.
Atidarykite programą įrenginyje, pvz., telefone arba planšetiniame kompiuteryje. SaveData ir LoadData negalima naudoti „Studio” arba žiniatinklio naršyklėje. Atnaujinkite programų sąrašą, jei iškart nematote savo programos, gali užtrukti iki kelių sekundžių, kol programa pasirodys jūsų įrenginyje. Atsijungus ir vėl prisijungus prie paskyros taip pat gali padėti.

Atsisiuntę programą galite atsijungti nuo tinklo ir paleisti programą neprisijungę.
Įveskite pavadinimą ir nufotografuokite elemento paveikslėlį.
Pasirinkite mygtuką Add Item. Jei norite įkelti savo rinkinį, pakartokite elementų įtraukimo veiksmų seką.
Pažymėkite Save Data mygtuką. Taip duomenis įrašysite į savo rinkinį vietiniame įrenginyje.
Uždarykite programą. Jūsų rinkinys atmintyje bus prarastas, įskaitant visus elementų pavadinimus ir paveikslėlius, tačiau jie ten išliks įrenginio saugykloje.
Vėl paleiskite programą. Iš atminties rinkinys vėl bus rodomas kaip tuščias galerijoje.
Pažymėkite Load Data mygtuką. Rinkinys bus iš naujo užpildomas iš jūsų įrenginyje saugomų duomenų, o jūsų elementai bus grąžinti į galeriją. Šis rinkinys buvo tuščias prieš mygtukui iškvietus LoadData funkciją; nebuvo būtina iškviesti Collect arba ClearCollectprieš įkeliant duomenis iš saugyklos.
Vėl pažymėkite Load Data mygtuką. Saugomi duomenys bus pridėti prie rinkinio galo, o galerijoje bus rodoma slinkties juosta. Jei norite pakeisti, o ne pridėti, pirma naudokite funkciją Clear funkciją, kad išvalytumėte rinkinį prieš iškviečiant LoadData funkciją.