環境変数

完了

Power Automate クラウド フローを構築する際、一般に、フローが実装されている環境に固有のフロー ステップで指定する値が設定されます。 たとえば、フロー アクションは、開発、テスト、運用などの環境によって異なるドキュメント名、外部サービス URL、またはメール アドレスの通知などを参照します。

環境変数を使用すると、これらの値をクラウド フロー定義から個別に定義および設定することができます。 その後、環境変数は、クラウド フローを展開する各環境で異なる値を持つことができます。 Power Apps やカスタム コネクタなど、他の Microsoft Power Platform リソースでも、環境変数を使用できます。 環境変数の値を定義すると、他の動的コンテンツを使用する際と同様に、ハード コードされたコンテンツはクラウド フローで環境変数の値に置き換えられます。

環境変数は、定義と現在の値の 2 つで構成されます。 定義は、変数のデータ型を定義し、既定値を含めることができます。 現在の値は、既定値を上書きするために各環境でオプションで指定できる値です。 環境変数定義を含むソリューションを別の環境にインポートする際に現在の値が設定されていない場合は、値の設定を求めるメッセージが表示されます。

ソリューションで環境変数を作成するには、+ 新規 > さらに表示 > 環境変数を選択します。 次の画像は、Error Notification Email 変数の作成例を示しています。

新しい環境変数の作成のスクリーンショット。

表示名および名前フィールドを入力する際は、目的を示す一意の名前を付けてください。 たとえば、上の例の変数にメールと名前を付けると、目的がわかりにくくなる可能性があります。 作成後は表示名を変更することができます。これは、ユーザーに表示される名前です。 名前は内部で使用され、システムでこの変数が使用される際、変数値の使用に影響を与えないように、名前を変更することはできません。 データ型は格納される値のタイプを定義し、作成後に変更することはできません。 データ ソースシークレットのデータ型は特殊なため、このモジュールの後半で説明します。

データ型を選択したら、既定値を設定できます。 既定値は必須ではありませんが、設定しておくと便利です。 たとえば、Expiration Days 変数を使用する場合、既定値として 28 日を設定して、その後、各環境の現在の値で上書きすることができます。 次のスクリーンショットは、変数に既定値を設定するプロセスを示しています。

新しい環境変数の既定値のスクリーンショット。]

また、環境に対して現在の値を指定することもできます。 たとえば、開発環境では開発チームのエイリアスを使用することができます。

新しい環境変数の現在の値のスクリーンショット。]

現在の値を設定する場合、編集用に再度変数を開き、変数の作成後にソリューションから現在の値を削除してください。 削除しない場合、開発環境の現在の値コンポーネントは、ソリューションのエクスポートに含まれます。 その結果、テストや運用などの他の環境でも、開発環境の現在の値が使用されます。 現在の値をソリューションから削除するには、開発環境のみで現在の値を設定し、このソリューションから削除を選択します。

ソリューションから現在の値を削除しているスクリーンショット。

データ ソース環境変数

データ ソースデータ型には、特定のデータ ソースで使用する接続に関する構成が格納されます。 データ型としてデータ ソースを選択後、このタイプの構成でサポートされるコネクタを選択する必要があります。 現在は、SharePoint のみがポートされています。 たとえば、SharePoint が選択されている場合、サイトまたはリストパラメーター タイプを選択する必要があります。 リスト環境変数を設定する前に、サイト データ ソース環境変数を設定する必要があります。 次のスクリーンショットは、サイト データ ソース変数の作成例を示しています。

データ ソース環境変数の設定のスクリーンショット。

シークレット環境変数

シークレットデータ型は、Microsoft Azure Key Vault に格納されているシークレットを参照します。 このタイプの変数には、他の設定が必要です。 詳細については、Azure Key Vault のシークレットの使用 を参照してください。 シークレット環境変数は、機密情報がユーザーまたはフローの実行履歴に誤って公開されるのを防ぐのに役立ちます。

環境変数の使用

ソリューション のクラウド フローでは、環境変数を参照してハード コードされた値を置き換えることができます。 環境で変数を定義すると、動的コンテンツ ペインから使用可能な環境変数を選択できます。 次のスクリーンショットは、前に定義した Error Notification Email 変数の使用例を示しています。

ハード コードされた値を置き換えるアクション ステップの環境変数のスクリーンショット。

パラメーター式を使用して値を取得することもできます。 たとえば、parameters('contoso_ErrorNotificationEmail') は同じ値を取得します。