SaveData、LoadData、ClearData 関数

[アーティクル]
03/22/2024

適用先: キャンバスアプリ

コレクションアプリホストのストレージから保存して再読込みします。

Note

これらの機能は、試験的な機能として、Web ブラウザでアプリを再生する際に使用できるようになりました。この機能は、既定で無効になっています。有効化するには、設定>今後の機能>試験的>web プレイヤーでの SaveData、LoadData、ClearData の有効化にアクセスし、オンにします。この試験的な機能に関するフィードバックを送信するには、Power Appsコミュニティフォーラムにアクセスしてください。

内容

SaveData 関数は、後で名前から使用できるようにコレクションを格納します。

LoadData 関数は、既に SaveData で保存されている名前を使用してコレクションを再読み込みします。別のソースからコレクションを読み込む場合、この関数は使用できません。

ClearData 関数は、名前が指定されていない場合、特定の名前でストレージをクリアするか、またはアプリに関連付けられているすべてのストレージをクリアするかです。

Note

SaveData、LoadData、および ClearData 間で共有される名前はキーであり、ファイル名ではありません。名前は各アプリに一意であり、名前が競合する危険がないため、複雑なものである必要はありません。名前にこれらの文字のいずれかを含めることはできません: *".?:\<>|/。
SaveData は、Teams や Web ブラウザ上で動作する Power Apps では、1MB のデータに制限されます。モバイルプレーヤーで実行されている Power Apps の固定制限はありませんが、以下で説明するような実用制限があります。
ウェブ上の機密データはプレーンテキストで保存されるため、SaveData を使用して保存しないでください。

これらの関数を使用して、アプリ起動時のパフォーマンスを向上させます。

最初の実行時の App.OnStart 式のキャッシングデータ。
次の実行時にローカルキャッシュを再読み込みします。

これらの関数を使用して、簡単な Offline 機能をあなたのアプリに追加することもできます。

次の場合、ブラウザー内でこれらの関数を使用することはできません。

Power Apps Studio でアプリを作成する。

アプリをテストするには、iPhone または Android デバイス上の Power Apps Mobile で実行します。

これらの関数は、メモリ内コレクションで動作するため、アプリの利用可能なメモリ容量によって制限されます。利用可能なメモリは、次のような要因に基づいて異なります。

デバイスおよびオペレーティングシステム。
Power Apps プレーヤーが使用するメモリ。
アプリの複雑性および画面とコントロール。

アプリが大量のデータを格納するときに実行することが予想される種類のデバイスを使用し、予想されるシナリオでアプリをテストします。一般的に、30 MB から 70 MB の利用可能なメモリが必要です。

これらの関数は、Collect または ClearCollect で暗黙的に定義されているコレクションに依存します。データを定義のコレクションに読み込むのに、Collect または ClearCollect を呼び出す必要はありません。前の SaveData の後に LoadData を使用する場合の、一般的なケースです。数式内にこれらの関数が存在し、コレクションの構造が明示的に定義されていれば十分です。詳細については、変数の作成および削除を参照してください。

読み込まれたデータはコレクションに追加されます。空のコレクションから始めたい場合は、LoadData を呼び出す前に Clear 関数を使用します。

データセキュリティ

SaveData で保存されたデータの分離と暗号化を慎重に検討し、特に複数のユーザーがデバイスを共有している場合は、ニーズに適しているかどうかを判断してください。

SaveData で保存されたデータは、Power Apps プレーヤーによって他の Power Apps から切り離されます。データはアプリのアプリ ID に基づいて保存され、SaveData 名前空間が Power Apps 間で自動的に切り離されます。

オペレーティングシステムとブラウザーは、Power Apps とデバイス上の他のアプリや Web サイトとの間でデータを切り分ける役割を果たします。例えば、オペレーティングシステムは、Microsoft Outlook に保存されているデータを Power Apps に保存されているデータから切り分けたり、Bing.com や PowerApps.com などの Web サイトからそのデータを切り分けたりする役割を担います。オペレーティングシステムに組み込まれたアプリサンドボックス機能は、通常、ユーザーがアクセスできないか、ユーザーに対して非表示になっている SaveData ストレージに使用されます。

同じアプリを使用する場合、オペレーティングシステムとブラウザーは、異なるオペレーティングシステムレベルのユーザー間でデータを切り分ける役割も果たします。たとえば、2 人の異なるユーザーがコンピューターを共有し、2 つの異なる Windows ログイン資格情報を使用する場合、オペレーティングシステムは 2 人の Windows ユーザー間でデータを切り分ける役割を果たします。

オペレーティングシステムのユーザーが同じ場合、異なる Power Apps ユーザー間でデータが切り分けられる場合と切り分けられない場合があります。すべての Power Apps プレイヤーがこれを同じように扱うわけではありません。たとえば、Power Apps プレーヤーで同じ Windows ユーザーとしてログインしている間、ユーザーは Power Apps からサインアウトし、別の Power Apps ユーザーとしてサインインします。 Power Apps ユーザーの変更前にアプリに保存されたデータは、同じアプリ内の 2 番目の Power Apps ユーザーがアクセスできる場合があります。データも削除され、最初の Power Apps ユーザーがアクセスできなくなる可能性があります。動作は Power Apps プレイヤーによって異なります。

オペレーティングシステムはデータを暗号化することもできます。また、Microsoft Intune のようなモバイルデバイス管理ツールを使用することもできます。 Web ブラウザでアプリを再生する際に保存されるデータは暗号化されません。

構文

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

Collection - 必須。格納または読み込みの対象となるコレクション。
Name - 必須。ストレージの名前。同じデータセットを保存し、読み込むには、名前が同じである必要があります。名前空間は、その他のアプリとは共有されません。名前にこれらの文字のいずれかを含めることはできません: *".?:\<>|/。
IgnoreNonexistentFile - オプション。ファイルがまだ存在していない場合の処理を示すブール値。 false (既定) を使用するとエラーを返し、true の場合、エラーは非表示になります。

ClearData( [名前] )

Name - オプション。以前に SaveData で保存されたストレージの名前です。名前が提供されていない場合、アプリに関連付けられているすべてのストレージがクリアされます。

例

式	内容	結果
SaveData( LocalCache, "MyCache" )	後で LoadData が取得できるように、「MyCache」の名前の下のユーザーデバイスに LocalCache コレクションを保存します。	データは「MyCache」という名前でアプリホストに保存されます。
LoadData( LocalCache, "MyCache" )	「MyCache」という名前の下のユーザーデバイスから、以前に SaveData の呼び出しによって保存された LocalCache コレクションを読み込みます。	データは「MyCache」という名前でアプリホストから読み込まれます。
ClearData( "MyCache" )	「MyCache」という名前のストレージをクリアします。この名前で保存されたデータは、LoadData からは利用できなくなります。	データは「MyCache」という名前でアプリホストから削除されます。
ClearData()	このアプリに関連付けられているすべてのストレージをクリアします。他のアプリによって格納されたデータは影響を受けません。	すべてのデータがアプリホストから削除されます。

簡単なオフラインの例

次の簡単な例では、オフライン時の日常アイテムの名前と画像を取得し、格納します。後で使用するために、デバイスのローカルストレージに情報を格納します。これにより、データを失うことなくアプリを閉じたり、デバイスを再起動したりできます。

Note

この例では、カメラコントロールを使って画像を撮影しています。 SaveData は、Teams や Web ブラウザで実行する場合、データは 1MB に制限されているため、この例では数枚以上の画像をあつかうことはできません。また、カメラによっては、1 枚の画像でも動作しない場合があります。デバイスを使用してこの完全な例を実行するか、カメラ制御と画像の部分を削除して Teams または Web ブラウザで実行します。

タブレットのレイアウトで空白のキャンバスアプリを作成します。詳細については、テンプレートからアプリを作成するを読み、空のアプリの下のタブレットレイアウトを選択してください。
Text input コントロールおよび Camera コントロールを追加し、表示されているように大まかに配置します。
Button コントロールを追加します。
Button コントロールをダブルクリックして、このボタンのテキストを Add Item に変更 (または Text プロパティを変更) します。
Button コントロールの OnSelect プロパティを次の式に設定し、コレクションにアイテムを追加します。
```
Collect( MyItems, { Item: TextInput1.Text, Picture: Camera1.Photo } )
```
別のButton コントロールを追加します。
Button コントロールをダブルクリックして、このボタンのテキストを Save Data に変更 (または Text プロパティを変更) します。
Button コントロールの OnSelect プロパティを次の式に設定し、コレクションをローカルデバイスに保存します。
```
SaveData( MyItems, "LocalSavedItems" )
```
影響がないため、ボタンをテストしたくなることがあります。ただし、Web ブラウザーで作成しているときはエラーが表示されるだけです。次の手順に従ってこの式をテストする前に、最初にアプリを保存し、デバイスで開きます。
3 番目の Button コントロールを追加します。
Button コントロールをダブルクリックして、このボタンのテキストを Load Data に変更 (または Text プロパティを変更) します。
Button コントロールの OnSelect プロパティを次の式に設定し、コレクションをローカルデバイスから読み込みます。
```
LoadData( MyItems, "LocalSavedItems" )
```
Gallery コントロールを画像とテキストエリアを含む縦方向のレイアウトで追加します。
確認を要求されたら、このギャラリーのデータソースとして MyItems コレクションを選択します。これにより、Gallery コントロールの Items プロパティを設定します。

ギャラリーテンプレートの画像コントロールでは、Image プロパティを既定値の ThisItem.Picture に設定し、ラベルコントロールでは、Text プロパティを既定値の ThisItem.Item に設定する必要があります。次の手順でアイテムを追加した後、ギャラリーに何も表示されない場合は、これらの式を確認してください。
コントロールをその他のコントロールの右側に配置します。
アプリを保存します。保存するのが初めての場合、公開する必要はありません。初めてでない場合は、保存した後にアプリを公開します。
スマートフォンやタブレットなどのデバイスでアプリを開きます。 SaveData および LoadData は、Studio または Web ブラウザーでは使用できません。アプリがすぐに表示されない場合は、アプリリストを更新してください。アプリがデバイスに表示されるまで数秒かかる場合があります。サインアウトしてアカウントに再度サインインすることも役立ちます。

アプリをダウンロードしたら、ネットワークを切断してアプリをオフラインで実行できます。
名前を入力して、アイテムの画像を撮影します。
Add Item ボタンを選択します。アイテムの追加を何回か繰り返し、コレクションを読み込みます。
Save Data ボタンを選択します。これにより、コレクション内のデータがローカルデバイスに保存されます。
アプリを閉じます。すべてのアイテム名と画像を含め、メモリ内のコレクションは失われますが、デバイスのストレージからは削除されません。
アプリを再度起動します。メモリ内のコレクションは、ギャラリーで再び空として表示されます。
Load Data ボタンを選択します。コレクションは、デバイスに保存されているデータから再作成され、アイテムはギャラリーに戻ります。このボタンが LoadData 関数を呼び出す前、コレクションは空でしたが、ストレージからデータを読み込む前に Collect または ClearCollect を呼び出す必要はありません。
Load Data ボタンをもう一度選択します。格納されたデータはコレクションの最後に追加され、ギャラリーにスクロールバーが表示されます。追加ではなく置換したい場合、LoadData 関数を呼び出す前、最初に Clear 関数を呼び出してコレクションをクリアします。