SaveData, LoadData және ClearData функциялары

Мақала
03/22/2024

Мыналарға қолданылады: Canvas қолданбалары

Бағдарламаның хост сақтау орнынан жинақты сақтайды және қайта жүктейді.

Ескертпе

Бұл функцияларды енді бағдарламаны тәжірибелік мүмкіндік ретінде веб-браузерде ойнату кезінде пайдалануға болады. Бұл мүмкіндік әдепкі бойынша өшірілген. Қосу үшін Параметрлер>Алдағы мүмкіндіктер>Тәжірибелік>Веб ойнатқышында SaveData, LoadData, ClearData қосылған" тармағына өтіп, қосқышты қосыңыз. Осы тәжірибелік мүмкіндікке қатысты пікір жіберу үшін Power Apps қауымдастық форумына өтіңіз.

Сипаттамасы

SaveData функциясы жинақты атаумен кейінірек пайдалану үшін сақтайды.

LoadData функциясы жинақты бұрын SaveData арқылы сақталған атаумен қайта жүктейді. Бұл функцияны басқа көзден жинақты жүктеу үшін пайдалану мүмкін емес.

ClearData функциясы белгілі бір атпен жадты тазартады немесе егер аты болмаса, бағдарламамен байланысты барлық жадты жояды.

Ескертпе

SaveData, LoadData және ClearData арасындағы ортақ атау файл атауы емес, кілт болып табылады. Ол күрделі болуы қажет емес, өйткені атаулар әр бағдарлама үшін бірегей және атаулар қайшылығының қаупі жоқ. Атау мына таңбалардың ешбір қамтымауы керек: *".?:\<>|/.
SaveData мүмкіндігі Teams және веб-браузерде іске қосылатын Power Apps үшін деректердің 1 МБ шамасына шектелген. Мобильді ойнатқышта іске қосылатын Power Apps бағдарламасы үшін бекітілген шектеу жоқ, бірақ төменде қарастырылатын практикалық шектеулер бар.
Интернетте құпия деректерді сақтау үшін SaveData опциясын пайдаланбаңыз, себебі олар қарапайым мәтінде сақталады.

Бұл функцияларды мыналар арқылы бағдарламаның іске қосылу өнімділігін жақсарту үшін пайдаланыңыз:

Бірінші іске қосқанда App.OnStart формуласындағы деректерді кэштеу.
Келесі іске қосуларда жергілікті кэшті қайта жүктеу.

Сондай-ақ бұл функцияларды бағдарламаңызға қарапайым офлайн мүмкіндіктерді қосу үшін пайдалана аласыз.

Бұл функцияларды мына жағд-айларда шолғыш ішінде пайдалану мүмкін емес:

Power Apps Studio ішінде бағдарлама жасау.

Бағдарламаны сынау үшін iPhone немесе Android құрылғысында Power Apps Mobile бағдарламасында іске қосыңыз.

Бұл функциялар қолжетімді бағдарлама жадының мөлшерімен шектеледі, өйткені олар жадтағы жинақта жұмыс істейді. Келесі сияқты факторларға байланысты қолжетімді жад өзгеріп отыруы мүмкін:

Құрылғы және операциялық жүйе.
Power Apps ойнатқышы пайдаланатын жад.
Экрандары және басқару элементтері бар бағдарламаның күрделілігі.

Үлкен деректерді сақтағанда, бағдарлама жұмыс істейтіні күтілетін құрылғылар түрінде бағдарламаны күтілетін сценарийлерде сынаңыз. Әдетте, 30 МБ және 70 МБ арасындағы қолжетімді жад болуын күтіңіз.

Бұл функциялар Collect немесе ClearCollect арқылы жинақтың жанама түрде анықталуына байланысты. Анықтау үшін деректерді жинаққа жүктеу үшін Collect немесе ClearCollect функциясын шақыру керек емес. Бұл алдыңғы SaveData функциясынан кейін LoadData функциясын пайдаланғанда жиі кездесетін жағдай. Бар керегі — жинақтың құрылымын жанама түрде анықтау үшін формулада осы функциялардың болуы. Қосымша ақпаратты айнымалыларды жасау және жою бөлімінен қараңыз.

Жүктелген деректер жинаққа үстеледі. Бос жинақпен бастағыңыз келсе, LoadData функциясын шақыру алдында Clear функциясын пайдаланыңыз.

Деректер қауіпсіздігі

SaveData мен сақталған деректерді оқшаулауды және шифрлауды мұқият қарастырыңыз және оның қажеттіліктеріңізге сәйкес келетінін шешіңіз, әсіресе құрылғыларды бірнеше пайдаланушы бөлісетін болса.

SaveData мен сақталған деректер Power Apps ойыншылармен басқа Power Apps ден оқшауланады. Деректер қолданбаның қолданба идентификаторы негізінде сақталады, олардың арасындағы SaveData атының кеңістігін автоматты түрде оқшаулайды Power Apps.

Амалдық жүйе мен браузер құрылғыдағы және веб-сайттардағы Power Apps және басқа қолданбалар арасындағы деректерді оқшаулауға жауапты. Мысалы, операциялық жүйе Microsoft Outlook ішінде сақталған деректерді Power Apps ішінде сақталған деректерден оқшаулауға, сондай-ақ бұл деректерді Bing.com немесе PowerApps.com. Операциялық жүйенің қолданбалы құм жәшігінің қондырғылары әдетте пайдаланушыға қол жетімді емес немесе жасырын SaveData сақтау үшін пайдаланылады.

Бір қолданбаны пайдаланған кезде операциялық жүйе мен шолғыш әртүрлі операциялық жүйе деңгейіндегі пайдаланушылар арасындағы деректерді оқшаулауға да жауапты. Мысалы, екі түрлі пайдаланушы компьютерді ортақ пайдаланса және екі түрлі Windows кіру тіркелгі деректерін пайдаланса, амалдық жүйе екі Windows пайдаланушысы арасындағы деректерді оқшаулауға жауапты.

Операциялық жүйе пайдаланушысы бірдей болса, деректер әртүрлі Power Apps пайдаланушылар арасында оқшаулануы немесе оқшауланбауы мүмкін. Әрбір Power Apps ойыншы бұған бірдей қарай бермейді. Мысалы, бір Windows пайдаланушысы ретінде жүйеге кірген кезде, Power Apps ойнатқышында пайдаланушы жүйеден Power Apps шығып, басқа Power Apps пайдаланушы ретінде кіреді. Қолданбада Power Apps пайдаланушы өзгергенге дейін сақталған деректер сол қолданбадағы екінші Power Apps пайдаланушыға қолжетімді болуы мүмкін. Деректер де жойылуы мүмкін және бірінші Power Apps пайдаланушы енді оған қол жеткізе алмауы мүмкін. Мінез Power Apps ойыншылар арасында өзгереді.

Амалдық жүйе деректерді шифрлауы мүмкін немесе Microsoft Intune сияқты мобильді құрылғыны басқару құралын пайдалануға болады. Бағдарламаны веб-браузерде ойнатқанда сақталған деректер шифрланбайды.

Синтаксис

SaveData( Жинақ, Аты )
LoadData( Жинақ, Аты [, IgnoreNonexistentFile ])

Жинақ - Міндетті. Сақталатын немесе жүктелетін жинақ.
Аты - Міндетті. Қойманың атауы. Бірдей деректер жиынын сақтау және жүктеу үшін атау бірдей болуы керек. Атау кеңістігі басқа қолданбалармен ортақ пайдаланылмайды. Атаулар мына таңбалардың ешбірін қамтымауы керек: *".?:\<>|/.
IgnoreNonexistentFile - Қосымша. Файл бұрыннан бар болса не істеу керектігін көрсететін логикалық мән. Қатені қайтар үшін false мәнін (әдепкі) және қатені басу үшін true мәнін пайдаланыңыз.

ClearData( [Аты] )

Аты - Қосымша. SaveData функциясымен бұрын сақталған жад атауы. Егер атауы берілмеген болса, бағдарламамен байланысты барлық жад тазартылады.

Мысалдар

Формула	Сипаттамасы	Нәтиже
SaveData( LocalCache, "MyCache")	LocalCache жинағын пайдаланушының құрылғысына "MyCache" атауымен сақтаңыз, ол кейінірек LoadData функциясының шығарып алуы үшін қолайлы.	Деректер "MyCache" атты бағдарлама хостына сақталады.
LoadData( LocalCache, "MyCache")	Пайдаланушы құрылғысынан бұрын SaveData функциясын шақыру арқылы сақталған "MyCache" атты LocalCache жинағын жүктейді.	Деректер "MyCache" атты бағдарлама хостынан жүктеледі.
ClearData («MyCache»)	"MyCache" атаулы жадты тазартады. Осы атпен сақталған кез келген деректер енді LoadData функциясы арқылы қолжетімді болмайды.	Деректер "MyCache" атты бағдарлама хостынан жойылады.
ClearData()	Осы бағдарламамен байланысты барлық жадты тазалаңыз. Басқа бағдарламаларда сақталған деректерге әсер етпейді.	Барлық деректер бағдарлама хостынан жойылады.

Қарапайым оффлайн мысал

Келесі қарапайым мысал оффлайн кезде күнделікті элементтердің атауларын және суреттерін жазады және сақтайды. Ол ақпаратты құрылғының жергілікті қоймасында кейінірек пайдалану үшін сақтайды. Бұл деректерді жоғалтусыз бағдарламаны жабуға немесе құрылғыны қайта іске қосуға мүмкіндік береді.

Ескертпе

Бұл мысал кескіндерді түсіру үшін камераны басқаруды пайдаланады. SaveData Teams немесе веб-браузерде іске қосылғанда 1 МБ деректермен шектелген, бұл мысал бірнеше кескіннен артық жұмыс істемейді. Сондай-ақ камераға байланысты ол бір кескінмен де жұмыс істемеуі мүмкін. Осы толық мысалмен жұмыс істеу үшін құрылғыны пайдаланыңыз немесе Teams немесе веб-браузерде іске қосу үшін осы мысалдың камера басқаруын және сурет бөлігін алып тастаңыз.

Планшет орналасуы бар бос кенеп бағдарламасын жасаңыз. Мәліметтерді бағдарламаны үлгіден жасау бөлімінен оқыңыз және Бос бағдарлама астында Планшет орналасуы параметрін таңдаңыз.
Мәтінді енгізу басқару элементін Камера басқару элементін қосыңыз және оларды шамамен көрсетілгендей орналастырыңыз:
Түймешік басқару элементін қосыңыз.
Түймешік мәтінін Элемент қосу деп өзгерту үшін түймешік басқару элементін екі рет басыңыз (немесе Мәтін сипатын өзгертіңіз).
Түймешік басқару элементінің OnSelect сипатын осы формулаға орнатыңыз, бұл элементті жинағымызға қосады:
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
Тағы бір Түймешік басқару элементін қосыңыз.
Түймешік мәтінін Деректерді сақтау деп өзгерту үшін түймешік басқару элементін екі рет басыңыз (немесе Мәтін сипатын өзгертіңіз).
Жинағымызды жергілікті құрылғыға сақтау үшін түймешік басқару элементінің OnSelect сипатын осы формулаға орнатыңыз:
```
SaveData( MyItems, "LocalSavedItems" )
```
Түймешікті сынағыңыз келуі мүмкін, өйткені бұл ештеңеге әсер етпейді. Бірақ сіз бар болғаны қатені көресіз, өйткені веб-шолғышта жасап жатырсыз. Осы формуланы сынау үшін келесі қадамдарды орындау алдында алдымен бағдарламаны сақтаңыз және құрылғыда ашыңыз:
Үшінші Түймешік басқару элементін қосыңыз.
Түймешік мәтінін Деректерді жүктеу деп өзгерту үшін түймешік басқару элементін екі рет басыңыз (немесе Мәтін сипатын өзгертіңіз).
Жинағымызды жергілікті құрылғыдан жүктеу үшін түймешік басқару элементінің OnSelect сипатын осы формулаға орнатыңыз:
```
LoadData( MyItems, "LocalSavedItems" )
```
Сурет және мәтін аумақтарын қамтитын тік орналасуы бар Галерея басқару элементін қосыңыз:
Сұралғанда, осы галерея үшін деректер көзі ретінде MyItems жинағын таңдаңыз. Бұл Галерея басқару элементінің Элементтер сипатын орнатады:

Галерея үлгісіндегі кескінді басқару элементі оның Сурет қасиетін ThisItem.Picture деп әдепкі етіп қоюы керек, ал жапсырманың басқару элементтері екеуі де болуы керек. әдепкі бойынша олардың Мәтін қасиеттері ThisItem.Item. Келесі қадамдарда элементтерді қосудан кейін галереяда ештеңе көрмесеңіз, бұл формулаларды тексеріңіз.
Басқару элементін басқа басқару элементтерінің оң жағында орналастырыңыз:
Бағдарламаны сақтаңыз. Бұл оның бірінші рет сақталуы болса, оны жариялаудың қажеті жоқ. Бұл бірінші рет болмаса, бағдарламаны сақтаудан кейін жариялаңыз.
Бағдарламаны телефон немесе планшет сияқты құрылғыда ашыңыз. SaveData және LoadData Студияда немесе веб-шолғышта пайдалану мүмкін емес. Бағдарламаңызды дереу көрмесеңіз, бағдарламалар тізімін жаңартыңыз, бағдарламаның құрылғыңызда көрінуіне бірнеше секунд кетуі мүмкін. Тіркелгіңізден шығып, қайта кіру де көмектесуі мүмкін.

Қолданбаны жүктеп алғаннан кейін желіден ажыратып, қолданбаны офлайн режимде іске қосуға болады.
Атауды енгізіңіз және элементтің суретін түсіріңіз.
Элемент қосу түймешігін таңдаңыз. Жинағыңызды жүктеу үшін элементтер қосуды бірнеше рет қайталаңыз.
Деректерді сақтау түймешігін таңдаңыз. Бұл жинағыңыздағы деректерді жергілікті құрылғыңызға сақтайды.
Бағдарламаны жабыңыз. Жадтағы жинағыңыз, соның ішінде барлық элемент атаулары және суреттер жоғалады, бірақ олар әлі де құрылғы қоймасында болады.
Бағдарламаны қайтадан іске қосыңыз. Жадтағы жинақ галереяда қайтадан бос түрінде көрсетіледі.
Деректерді жүктеу түймешігін таңдаңыз. Жинақ құрылғыңызда сақталған деректерден қайта толтырылады және элементтеріңіз қайтадан галереяда болады. Осы түймешік LoadData функциясын шақырмай тұрып жинақ бос болған; қоймадан деректерді жүктеу алдында Collect немесе ClearCollect функциясын шақыру қажет болмаған.
Деректерді жүктеу түймешігін қайтадан таңдаңыз. Сақталған деректер жинақтың соңына үстеледі және галереяда айналдыру жолағы пайда болады. Үстеу емес, ауыстырғыңыз келсе, LoadData функциясын шақыру алдында жинақты тазалау үшін Clear функциясын пайдаланыңыз.