カードに変数を追加する

変数は再利用のためのデータを保存します。 データは、コレクション、テキスト、または数値などのさまざまなタイプにすることができます。 変数には一意の名前があり、これが Power Fx式 で参照する方法です。 カード デザイナー でそれらを挿入、変更、削除します。

変数の値は、カード セッションごとにリセットされる一時的なものと、特定のカード インスタンスのすべてのセッションで共有される永続的なものがあります。 一時的な変数は、単一ユーザーであってもカード セッションごとに異なります。つまり、チャットとチャネルで同じカード インスタンスが送信された場合、一時的な変数は 2 つのセッション間で異なる場合があります。

例として、セッション中にユーザーが何回ボタンを押したかをカウントするカードを作成したとします。 現在のカードのインスタンスでボタンを押した回数を格納するために、一時的な数値変数を作成することになります。 もし、あるカード インスタンスで最後にボタンを押したユーザーの名前も取得したい場合は、永久テキスト変数に格納することになります。 さらにカード インスタンス間でデータを保存したい場合は、データ接続を使用することになります。

変数はカスタマイズも可能です。つまり、リンクとして送信する前の再生ページ内にある場合でも、カード インスタンスの作成 アクションの一部として Power Automate にある場合でも、送信者が値を設定します。

前提条件

• Power Apps アカウント
• カード

変数を作成する

1. Power Apps にサインインします。 カードを選択してから、カードを選択します。 もしカード タブが表示されない場合は、その他を選択してカード タブをピン留めします。

2. カード デザイナーの左ペインで、変数 を選択します

3. + 新規変数 を選択します。

4. 新しい変数ウィンドウで、以下の値を指定します。

   • 名前: 変数の名前 (必須)
   • タイプ: 変数のタイプ (必須)
   • 規定値: 変数の規定値
   • 持続性: 変数が一時的 (カードが開かれるたびにリセットされる) か永続的であるか
   • カスタマイズ: 送信者が変数をカスタマイズして入力変数として機能できるかどうか

   変数の名前や型を変更することはできません。 これらの値を変更する必要がある場合は、新しい変数を作成します。

   また、送信者オプションや、追加変数情報の変数のタイトルと説明をカスタマイズすることもできます。 この情報は、Power Automate フローで変数をテストおよびデバッグし、使用する際に役立つ場合があります。

   

5. 保存 を選択します。

テーブルとレコードの既定値の使用

既定値は、コレクション変数とレコード変数の構造を設定するために使用されます。 レコードまたはテーブル変数の既定値を設定するには、次の 2 つの方法があります:

• 列エディターを使用する
• Power Fx / JSON の使用

右側のトグルを使用して、列エディターと Power Fx / JSON のどちらを使用するかを切り替えることができます。

Power Fx 式を使用すると、 Dataverse のように データ ソース からのデータを変数に格納する場合に役立ちます。 たとえば、 Account テーブルの特定の行を保持するレコードが必要な場合は、既定の値を First(Account) に設定できます。

変数は厳密に型指定されているため、既定の値を設定すると、変数がそれらの型にロックされます。

変数の編集や削除

変数を編集または削除するには、変数の右側にある省略記号 (...) を選択し、編集または 削除 を選択します。

カードでの変数の使用

カードで変数を使用するには、さまざまな方法があります。 Power Apps で環境を操作する方法を説明します。

変数の一般的な用途は、Power Fx 式です。 数式で変数を名前で参照します。 例については、簡単なカードのチュートリアル をご覧ください。 以下に示すように、変数は数式バーでも認識されます。

変数の値を更新する

変数は Set 関数で更新できます。ただし、Collect 関数で追加されるテーブル変数は除きます。