キャンバスアプリの変数を理解する

[アーティクル]
09/29/2023

Visual Basic や JavaScript などの他のプログラミングツールを使用したことがある場合、変数はどこにあるのか? という疑問を抱くことでしょう。 Power Apps は少し異なるので、別のアプローチが必要です。キャンバスアプリをビルドする際に、変数の説明に進む代わりに、Excel で何をしようとしているか? を考えます。

他のツールでは、明示的に計算を実行し、その結果を変数に格納していたことでしょう。しかし、Power Apps と Excel のどちらも、入力データが変更されると自動的に計算式が再計算されるので、通常は変数を作成したり更新したりする必要はありません。可能な限りこの方法に従うことで、アプリをより簡単に作成、理解、維持することができます。

場合によっては Power Apps で変数を使用する必要があります。これにより動作の数式を追加して Excel のモデルを拡張します。これらの計算式が実行されるのは、ユーザーがボタンを選択したときなどです。動作の数式の中では、他の計算式で使用する変数を設定すると便利なことがよくあります。

一般的には、変数の使用を避けてください。ただし、変数を使わないと目的の動作が得られないこともあります。変数は、値を設定する関数に表示されるとき、暗黙的に作成および型指定されます。

Excel を Power Apps に変換する

Excel

それでは、Excel のしくみを確認しましょう。セルには、数値や文字列などの値、または他のセルの値に基づく計算式を含めることができます。ユーザーがセルに別の値を入力すると、新しい値に応じてすべての計算式が自動的に再計算されます。この動作を実現するためにプログラミングは必要ありません。

次の例では、セル A3 が計算式 A1+A2 に設定されています。もし A1 または A2 を変更するなら、A3 は変更を反映するために自動的に再計算されます。この動作では、計算式自体の外部でコーディングする必要はありません。

2 つの数値の合計を再計算する Excel のアニメーション。

Excel には変数がありません。計算式が含まれるセルの値は入力内容に基づいて変化しますが、計算式の結果を記憶してそれをセルや他の場所に格納する方法はありません。セルの値を変更すると、スプレッドシート全体が変更される可能性があり、それ以前に計算された値はすべて失われます。 Excel のユーザーは、セルをコピーして貼り付けることができますが、それはユーザーが手動で制御するものであり、計算式では不可能です。

Power Apps

Power Apps で作成したアプリは、Excel とほぼ同じように動作します。セルを更新する代わりに、画面上の任意の場所にコントロールを追加し、計算式で使用するために名前を付けることができます。

たとえば、ラベル1 という名前の**ラベル** コントロールに加えて、TextInput1 と TextInput2 という名前の 2 つの**テキスト入力** コントロールを追加することで、アプリで Excel の動作を複製できます。その後 ラベル1 の Text プロパティを TextInput1 + TextInput2 に設定すると、TextInput1 と TextInput2 に含まれているすべての数値の合計が自動的に表示されます。

Power Apps で 2 つの数値の合計を計算します。

ラベル1 コントロールが選択されていて、テキスト 式が画面上部の数式バーに表示されていることに注意してください。ここで、計算式が TextInput1 + TextInput2 となっていることがわかります。 Excel ワークブック内のセル間に依存関係が作成されるのと同様に、この計算式によってこれらのコントロール間に依存関係が作成されます。 TextInput1 の値を変更してみましょう。

Power Apps で 2 つの数値の合計を再計算するアニメーション。

Label1 の計算式が自動的に再計算され、新しい値が表示されます。

Power Apps では、計算式を使用して、コントロールのプライマリ値だけでなく、書式設定などのプロパティも決定できます。次の例では、ラベルの Color プロパティに設定された計算式により、負の値は自動的に赤で表示されます。 If 関数は Excel とよく似ています。

If( Value(Label1.Text) < 0, Red, Black )

条件付き書式のアニメーション。

計算式は、さまざまなシナリオで利用できます。

デバイスの GPS を使用した場合、Location.Latitude と Location.Longitude を使用する計算式によって、マップコントロールに現在の位置を表示できます。移動すると、マップによって位置が自動的に追跡されます。
他のユーザーがデータソースを更新できます。たとえば、チームの他のメンバーがリスト内の項目を更新する場合があります。データソースを更新すると、依存するすべての計算式が自動的に再計算され、更新されたデータが反映されます。この例をさらに進めて、ギャラリーの Items プロパティを計算式 Filter( SharePointList ) に設定すると、新しくフィルター処理されたレコードセットが自動的に表示されます。

給付金

計算式を使用するアプリの作成には多くの利点があります。

Excel を知っていれば Power Apps もわかります。モデルと計算式の言語は同じです。
別のプログラミングツールを使用したことがある場合、これらの例を実現するためにどれだけの量のコードが必要になるかを考えてみてください。 Visual Basic では、各テキスト入力コントロールの変更イベント用にイベントハンドラーを記述する必要があります。このそれぞれで計算を実行するコードは冗長であり、不一致が生じる可能性がありますし、また、共通のサブルーチンを記述することが必要になる場合もあります。 Power Apps では、1 行の計算式 1 つでこのすべての処理を実行しました。
ラベル1 のテキストがどこから取得されるかを理解するために、Text プロパティの計算式を正確に調べます。ほかに、このコントロールのテキストを変更する方法はありません。従来のプログラミングツールでは、プログラムのどこからでも、任意のイベントハンドラーまたはサブルーチンでラベルの値を変更できました。これにより、変数がいつどこで変更されたかを追跡するのが難しくなります。
ユーザーは、スライダーコントロールを変更した後に考えを変えた場合、スライダーを元の値に戻すことができます。アプリでは以前と変わらず同じコントロールが表示されるため、まるで何も変わっていないかのように見えます。「what if」を試したり要求したりした場合でも、Excel の場合と同様、派生的な問題は発生しません。

一般的に、計算式を使用して効果を得ることができれば楽になります。 Power Apps の計算式エンジンをうまく利用しましょう。

変数を使用するタイミングを把握する

単純な加算器に変更を加えて、累計機能を備えた昔ながらの計算機のように動作するようにしましょう。追加ボタンを選択すると、数値が累計に加算されます。 クリア ボタンを選択すると、累計が 0 にリセットされます。

表示	説明
	アプリが起動すると、累計は 0 になります。赤い点は、ユーザーが 77 を入力したテキスト入力ボックス内のユーザーの指を表します。
	ユーザーは追加ボタンを選択します。
	累計に 77 が追加されます。ユーザーは追加ボタンを選択します。
	77 が累計に再び追加され、結果は154 になります。ユーザーはクリアボタンを選択します。
	累計は 0 にリセットされます。

ここで作成する計算機では、Excel に存在しない機能であるボタンを使用しています。このアプリでは、値はユーザーが行う一連の操作によって異なるので、計算式だけを使用して累計を計算することはできません。代わりに、累計を手動で記録して更新する必要があります。ほとんどのプログラミングツールでは、この情報を変数に格納します。

場合によっては、アプリが目的の動作を行うために変数が必要になります。ただし、このアプローチには注意が必要です。

累計を手動で更新する必要があります。この処理は自動再計算では実行されません。
累計は、他のコントロールの値に基づいて計算できません。累計は、ユーザーが追加ボタンを選択した回数と、選択したときにテキスト入力コントロールに格納されていた値に依存します。ユーザーが 77 を入力した後で追加を 2 回選択したのか、それとも加算する値に 24 と 130 を指定したのでしょうか? 合計が 154 になった後でその違いを見分けることはできません。
合計に対する変更は、異なる経路から生じている可能性があります。この例では、追加ボタンでもクリア ボタンでも合計を更新できます。アプリが期待どおりに動作しない場合、どちらかのボタンに問題の原因があるのでしょうか?

グローバル変数を使用する

計算機を作成するには、累計を保持する変数が必要です。 Power Apps で使用できる最も単純な変数は、グローバル変数です。

グローバル変数は次のように機能します。

Set 関数を使用して、グローバル変数の値を設定します。 Set( MyVar, 1 ) では、グローバル変数 MyVar の値を 1 に設定します。
Set 関数とともに使用した名前を参照すると、グローバル変数を使用できます。この場合、MyVar は 1 を返します。
グローバル変数は、文字列、数値、レコード、テーブルなど、すべての値を保持できます。

それでは、グローバル変数を使用して計算機を作り直してみましょう。

TextInput1 という名前のテキスト入力コントロールと、ボタン1 および ボタン2 という名前の 2 つのボタンを追加します。
ボタン1 の Text プロパティを "Add" に設定し、ボタン2 の Text プロパティを "Clear" に設定します。
ユーザーが追加ボタンを選択して累計を更新するために、OnSelect プロパティを次の計算式に設定します。

Set( RunningTotal, RunningTotal + TextInput1 )

この計算式が単に存在する場合、+ 演算子により、RunningTotal の数値を保持するグローバル変数として設定します。 RunningTotal をアプリの任意の場所で参照できます。ユーザーがこのアプリを開くたびに、RunningTotal の初期値は空白となります。

ユーザーが最初に追加ボタンを選択し、Set を実行すると、RunningTotal は RunningTotal + TextInput1 の値に設定されます。
ユーザーがクリア ボタンを選択して累計を 0 に設定するために、OnSelect プロパティを次の計算式に設定します。

Set( RunningTotal, 0 )
ラベル コントロールを追加し、Text プロパティを RunningTotal に設定します。

この計算式は自動的に再計算され、ユーザーが選択したボタンに基づいて変更される RunningTotal の値が表示されます。
アプリをプレビューし、上記のように計算機が完成しました。テキストボックスに数値を入力して追加ボタンを数回クリックします。準備ができたら、Esc キーを押して作成環境に戻ります。
グローバル変数の値を表示するには、次のいずれかの操作を実行します。
- プレビューバージョンの Power Apps Studio を使用している場合、アプリの作成メニューで変数を選択します。
- クラシックバージョンの Power Apps Studio を使用している場合、ファイル メニューを選択し、左側のウィンドウにある変数を選択します。
変数がどこで定義され使用されているかを表示するには、グローバル変数の下で、その変数を選択します。

変数の種類

Power Apps には 3 種類の変数があります。

変数の種類	Scope	内容	確立する関数
グローバル変数	アプリ	使い方が最も単純です。数値、テキスト文字列、ブール値、レコード、テーブルなどを保持し、アプリ内のどこからでも参照できます。	設定
コンテキスト変数	画面	他の言語のプロシージャにパラメーターを渡す場合など、画面に値を渡すのに最適です。 1 つの画面からのみ参照できます。	UpdateContext Navigate
コレクション	App	アプリ内のどこからでも参照できるテーブルを保持します。全体として設定するのではなく、テーブルのコンテンツごとに変更できます。後で使用するためにローカルデバイスに保存できます。	Collect ClearCollect

変数の作成と削除

Set、UpdateContext、Navigate、Collect、または ClearCollect 関数で表示される場合、すべての変数は暗黙的に作成されます。変数とその型を宣言するには、アプリ内の任意の場所でこれらの関数のいずれかにそれを含める必要があります。これらの関数はいずれも変数を作成しません。変数に値を入力するだけです。別のプログラミングツールの場合のように変数を明示的に宣言することはなく、すべての型指定は使用方法から暗黙的に行われます。

たとえば OnSelect 式が Set( X, 1 ) と等しいボタンコントロールがあるとします。この計算式は、数値型の変数として X を確立します。計算式で X を数値として使用し、ボタンを選択する前、アプリを開いた後にその変数の値は空白値となります。ボタンを選択すると、X の値は 1 になります。

別のボタンを追加して、OnSelect プロパティを Set (X、"Hello") に設定すると、型 (テキスト文字列) が以前の Set (数値) の型と一致しないためにエラーが発生します。変数のすべての暗黙的な定義は、型に同意する必要があります。この場合も、計算式内で X に言及したからであり、これらの計算式のいずれかが実際に実行されたためではありません。

変数を削除するには、暗黙的に変数を確立する Set、UpdateContext、Navigate、Collect、ClearCollect をすべて削除します。これらの関数がない場合、変数は存在しません。変数への参照も、エラーが発生するため削除する必要があります。

変数の有効期間と初期値

アプリの実行中、すべての変数がメモリに保持されています。アプリを閉じると、変数に保持されていた値は失われます。

Patch 関数または Collect 関数を使用して、データソースに変数の内容を格納できます。 SaveData 関数を使用して、ローカルデバイスのコレクションに値を格納することもできます。

ユーザーがアプリを開くと、すべての変数の初期値は空白になります。

変数の読み取り

変数の名前を使用してその値を読み取ります。たとえば、次の計算式で変数を定義できます。

Set( Radius, 12 )

次に、数値を使用できる場所ならどこでも Radius を使用でき、12 に置き換えることができます。

Pi() * Power( Radius, 2 )

コンテキスト変数にグローバル変数またはコレクションと同じ名前を付けると、コンテキスト変数が優先されます。ただし、曖昧性除去演算子 [@Radius] を使用すると、グローバル変数またはコレクションを引き続き参照できます。

コンテキスト変数を使用する

グローバル変数の代わりにコンテキスト変数を使用した計算機の作成方法を説明します。

コンテキスト変数のしくみは次のとおりです。

コンテキスト変数を暗黙的に確立および設定するには、UpdateContext 関数または Navigate 関数を使用します。アプリが起動すると、すべてのコンテキスト変数の初期値は空白になります。
コンテキスト変数は、レコードを使用して更新します。他のプログラミングツールでは、一般的に、「x = 1」のように、代入には「=」を使用します。コンテキスト変数の場合は、代わりに { x: 1 } を使用します。コンテキスト変数を使用する場合は、レコード構文なしで直接その名前を使用します。
Navigate 関数を使用して画面を表示する場合は、コンテキスト変数を設定することもできます。画面が一種のプロシージャまたはサブルーチンと考えられる場合、この方法は他のプログラミングツールでのパラメーターの引き渡しに似ています。
Navigate を除き、コンテキスト変数は、名前を取得する場所である単一の画面のコンテキストに制限されます。このコンテキスト以外でコンテキスト変数を使用または設定することはできません。
コンテキスト変数では、文字列、数値、レコード、テーブルなど、任意の値を保持できます。

それでは、コンテキスト変数を使用して計算機を作り直してみましょう。

TextInput1 という名前のテキスト入力コントロールと、ボタン1 および ボタン2 という名前の 2 つのボタンを追加します。
ボタン1 の Text プロパティを "Add" に設定し、ボタン2 の Text プロパティを "Clear" に設定します。
ユーザーが追加ボタンを選択して累計を更新するために、OnSelect プロパティを次の計算式に設定します。

UpdateContext( { RunningTotal: RunningTotal + TextInput1 } )

この計算式が単に存在する場合、+ 演算子により、数値を保持するコンテクスト変数として RunningTotal を設定します。 RunningTotal をこの画面の任意の場所で参照できます。ユーザーがこのアプリを開くたびに、RunningTotal の初期値は空白となります。

ユーザーが追加ボタンと UpdateContext を初めて選択するときに、RunningTotal は RunningTotal + TextInput1 の値に設定されます。
ユーザーがクリア ボタンを選択して累計を 0 に設定するために、OnSelect プロパティを次の計算式に設定します。

UpdateContext( { RunningTotal: 0 } )

ここでも、UpdateContext を計算式 UpdateContext( { RunningTotal: 0 } ) で使用します。
ラベル コントロールを追加し、Text プロパティを RunningTotal に設定します。

この計算式は自動的に再計算され、ユーザーが選択したボタンに基づいて変更される RunningTotal の値が表示されます。
アプリをプレビューすると、上記のように計算機が完成しました。テキストボックスに数値を入力して追加ボタンを数回クリックします。準備ができたら、Esc キーを押して作成環境に戻ります。
画面に移動する際にコンテキスト変数の値を設定できます。これはある画面から別の画面に「コンテキスト」または「パラメーター」を渡すのに役立ちます。このテクニックを説明するには、画面を挿入し、ボタンを挿入して、OnSelect プロパティをこの計算式に設定します。

Navigate( Screen1, None, { RunningTotal: -1000 } )

Alt キーを押したままこのボタンを選択してScreen1 を表示し、コンテキスト変数 RunningTotal を -1000 に設定します。
コンテキスト変数の値を表示するには、次のいずれかの操作を実行します。
- プレビューバージョンの Power Apps Studio を使用している場合、アプリの作成メニューの変数を選択します。
- クラシックバージョンの Power Apps Studio を使用している場合、ファイル メニューを選択してから、左側のウィンドウにある変数を選択します。
コンテキスト変数が定義され使用される場所を表示するには、コンテキスト変数の下で、その変数を選択します。

コレクションの使用

最後に、コレクションを使用した計算機の作成方法を説明します。コレクションは、変更が容易なテーブルを保持しているため、この計算機に値が入力されたときに、それぞれの値を「紙テープ」に記録するようにします。

コレクションのしくみは次のとおりです。

コレクションを作成および設定するには、ClearCollect 関数を使用します。代わりに Collect 関数を使用できますが、実質的には、古い変数を置き換えるのではなく別の変数が必要になります。
コレクションは一種のデータソース、すなわちテーブルです。コレクションの単一の値にアクセスするには、First 関数を使用し、結果のレコードから 1 つのフィールドを抽出します。 ClearCollect で単一の値を使用した場合、これは次の例のように Value フィールドになります。
First( VariableName ).Value

コレクションを使用して計算機を作り直してみましょう。

TextInput1 という名前の**テキスト入力** コントロールと、ボタン1 および ボタン2 という名前の 2 つのボタンを追加します。
ボタン1 の Text プロパティを 「Add」 に設定し、ボタン2 の Text プロパティをClearに設定します。
ユーザーが追加ボタンを選択して累計を更新するために、OnSelect プロパティを次の計算式に設定します。

Collect( PaperTape, TextInput1.Text )

この計算式が単に存在する場合、 PaperTape をテキスト文字列の単一列テーブルを保持するコレクションとして確立します。 PaperTape をこのアプリの任意の場所で参照できます。ユーザーがこのアプリを開くたびに、PaperTape は空のテーブルになります。

この計算式を実行すると、コレクションの末尾に新しい値が追加されます。 1 つの値を追加しているため、Collect によってその値は単一列テーブルに自動的に配置され、列の名前は Value になります。この値は後で使用します。
ユーザーが クリア ボタンを選択したときに紙テープを消去するには、OnSelect プロパティを次の計算式に設定します。

Clear( PaperTape )
累計を表示するために、ラベルを追加し、Text プロパティを次の計算式に設定します。

Sum( PaperTape, Value )
計算機を実行するために、F5 キーを押してプレビューを開き、テキスト入力コントロールに数値を入力して、ボタンを選択します。
既定のワークスペースに戻るには、Esc キーを押します。
紙テープを表示するには、データテーブル コントロールを挿入し、その Items プロパティを次の計算式に設定します。

PaperTape

右側のペインで、フィールドの編集 を選択して フィールドを追加 を選択し、値列を選択した後、追加を選択して表示します。
コレクションの値を確認するには、次のいずれかの操作を実行します。
- プレビューバージョンの Power Apps Studio を使用している場合、アプリの作成メニューの変数を選択し、コレクションを選択します。
- クラシックバージョンの Power Apps Studio を使用している場合、ファイル メニューのコレクションを選択します。
コレクションを保存したり取得したりするには、さらに 2 つのボタンコントロールを追加し、その Text プロパティを読み込みと保存にします。 読み込みボタンの OnSelect プロパティを次の計算式に設定します。

Clear( PaperTape ); LoadData( PaperTape, "StoredPaperTape", true )

LoadData によって格納された値はコレクションの末尾に追加されるため、最初にコレクションをクリアする必要があります。
保存ボタンの OnSelect プロパティを次の計算式に設定します。

SaveData( PaperTape, "StoredPaperTape" )
F5 キーを押してもう一度プレビューを表示し、テキスト入力コントロールに数値を入力してボタンを選択します。保存ボタンを選択します。アプリを閉じて再読み込みし、読み込みボタンを選択してコレクションを再読み込みします。