設定を使用してカスタマイズされたアプリ エクスペリエンスを提供します。

設定は、開発者と管理者アプリをすばやく構成して、カスタマイズされたエクスペリエンスを提供できるようにするソリューション コンポーネントです。 設定を使用して、機能を有効または無効にしたり、環境内の 1 つのアプリまたはすべてのアプリの機能の動作を構成したりできます。

設定は、定義の設定、環境値の設定、アプリ値の設定の 3 つのサブコンポーネントで構成されています。

設定の定義

設定の定義は、設定の基本的なプロパティを指定するものです。 設定の定義で構成可能なプロパティの一覧を以下に示します。 これらのプロパティの中には、設定を作成した後では変更できないものもあります。

新しい設定の定義を追加する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションのリストから、設定を追加したいソリューションを開きます。
4. コマンドバーで、新規 > その他 > 設定 > 設定の定義を選択します。
5. 新規設定ダイアログで、要件に基づいて各プロパティの値を指定します。 定義プロパティの設定については、設定の定義を参照してください
6. プロパティの値の入力が完了したら、保存を選択します。

既存の設定定義を追加する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションのリストから、設定を追加したいソリューションを開きます。
4. コマンドバーで、既存の追加 > その他 > 設定 > 設定の定義を選択します。
5. 既存の設定定義を追加するダイアログで、追加する 1 つ以上の設定を選択します。
6. 設定の選択が完了したら、次を選択します
7. 選択した設定定義ダイアログで、選択した各設定に、 設定の定義を含めるというオプションが表示されます。 また、各設定項目に環境設定値がある場合は、それも含めることができます。
8. 追加を選択して、設定の定義や設定の環境値を追加します。

設定の定義を追加する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションの一覧から、設定を作成したソリューションを開きます。
4. ツリービューで、設定 > 設定の定義を選択します。
5. 更新する設定定義を選択します。
6. 設定の編集ダイアログで、変更するプロパティの値を更新します。
   設定を作成した後では、更新できないプロパティもあります。 また、ほとんどの場合、自分が所有していない設定定義を更新することはできません。
7. プロパティの値の更新が完了したら、保存を選択します。

設定の定義を削除する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションのリストから、作成または設定を追加したソリューションを開きます。
4. ツリービューで、設定 > 設定の定義を選択します。
5. 取り除く設定の定義を選択します。
6. コマンドバーで、取り除く > このソリューションから取り除くを選択します。
   このソリューションから取り除く: 現在のソリューションから設定の定義を取り除きますが、既定のソリューションや追加された他のソリューションの一部として引き続き使用されます。

設定の定義を削除する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションのリストから、作成または設定を追加したソリューションを開きます。
4. ツリービューで、設定 > 設定の定義を選択します。
5. 削除する設定の定義を選択します。
6. コマンドバーで、取り除く > このソリューションから取り除くを選択します。
   この環境から削除する: 現在の環境から設定定義を削除し、その環境のどのソリューションにも含まれなくなります。 所有している設定の定義のみを削除することができます。

設定の環境の値

設定環境値は、環境内のすべてのアプリに対して設定の既定の値を上書きするために使用されます。 設定の既定の値が、自分の環境のアプリに使用したいものではない場合に、設定環境の値を使用します。

新しい設定環境値の追加

1. Power Apps にサインインします。

2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。

3. ソリューションの一覧から、設定環境値を追加したいソリューションを開きます。

4. ソリューションに設定の定義が存在する場合:

   1. 設定の定義を選択します。
   2. 設定値編集ダイアログの環境設定値セクションで、新しい値を選択します。
   3. 値を入力し、保存をクリックします。

   ソリューションに設定の定義が存在しない場合:

   1. コマンドバーで、新規 > その他 > 設定 > 設定の環境値を選択します。
   2. 設定環境の値を追加する設定を選択し、追加を選択します。
   3. 設定環境値の新規作成ダイアログの、設定環境値の項目で新しい値を選択します。
   4. 値を入力し、保存をクリックします。

既存の設定環境値の追加

1. Power Apps にサインインします。

2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。

3. ソリューションの一覧から、設定環境値を追加したいソリューションを開きます。

4. ソリューションに設定の定義が存在する場合:

   1. 設定の定義を選択します。
   2. 設定値編集ダイアログの環境設定値セクションで、既存の値を追加を選択します。
   3. 必要に応じて値を更新し、保存を選択します。

   ソリューションに設定の定義が存在しない場合:

   1. コマンドバーで、既存の追加 > その他 > 設定 > 設定の定義を選択します。
   2. 既存の設定定義を追加するダイアログで、設定環境の値を追加する複数の設定を選択します。
   3. 設定の選択が完了したら、次を選択します
   4. 選択した設定定義ダイアログで、選択した各設定に、 設定環境の値を含めるというオプションが表示されます (存在する場合)。 また、必要に応じて各設定に設定の定義を含めることもできます。
   5. 追加を選択して、設定環境の値や設定定義を追加します。

設定環境値の更新

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションの一覧から、設定環境値を追加したソリューションを開きます。
4. ツリービューで、設定 > 環境値の設定を選択します。
5. 更新する設定環境の値を選択します。
6. 設定値編集ダイアログの環境設定値セクションで値を更新し、保存を選択します。

設定環境値の削除

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションのリストから、作成または設定を追加したソリューションを開きます。
4. ツリービューで、設定 > 環境値の設定を選択します。
5. 取り除く設定環境の値を選択します。
6. コマンドバーで、取り除く > このソリューションから取り除くを選択します。
   このソリューションから取り除く: 現在のソリューションから設定の環境の値を取り除きますが、既定のソリューションや追加された他のソリューションの一部として引き続き使用されます。

設定環境値の削除

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションのリストから、作成または設定を追加したソリューションを開きます。
4. ツリービューで、設定 > 環境値の設定を選択します。
5. 削除する設定環境の値を選択します。
6. コマンドバーで、取り除く > このソリューションから削除するを選択します。
   この環境から削除する: 現在の環境から環境設定値を削除し、その環境でのソリューションには含まれなくなります。

アプリの値の設定

アプリの設定値は、1 つのアプリに対して、設定の既定値や設定環境の値を上書きするために使用されます。 設定環境の値が、アプリで使用したいものではない場合に、設定アプリの値を使用します。 設定環境の値が存在しない場合、設定の既定値がアプリで使用したいものではないときに、設定アプリの値を使用します。

アプリ デザイナーを使用して設定アプリの値を追加または更新する

1. 設定アプリの値を追加したいアプリをアプリ デザイナーで開きます。
2. コマンド バーで、設定 を選択します。
3. 設定 ダイアログで、機能または 今後の機能タブを選択します。
   機能タブには、リリースレベルが一般提供に設定されているすべての設定が表示されます。 今後の機能タブには、リリースレベルがプレビューに設定されているすべての設定が表示されます。
4. 必要な設定のアプリの値を追加、または更新します。
5. アプリを保存し、公開します。

アプリ デザイナーを使用した設定アプリの値の削除

1. 設定アプリの値を取り除くアプリをアプリ デザイナーで開きます。
2. コマンド バーで、設定 を選択します。
3. 設定 ダイアログで、機能または 今後の機能タブを選択します。
4. 削除する設定アプリの値の横にある 環境の値にリセットする を選択します。 これにより、設定値は、設定環境の値がある場合は、その値にフォールバックします。 設定環境の値が存在しない場合は、設定の既定値にフォールバックします。
   なお、環境値にリセット のオプションは、設定アプリの値が以前に追加されている場合にのみ表示されます。
5. アプリを保存し、公開します。

ソリューション エクスプローラーを使用して設定アプリの値の追加、または更新する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションの一覧から、設定アプリの値を追加するソリューションを開きます。
4. 設定定義または設定環境値がソリューションにない場合は、いずれかを追加します。 既存の設定定義を追加する、または 既存の設定環境値を追加するに移動します。
5. 設定定義や設定環境の値を選択します。
6. 設定値の編集ダイアログで、アプリの値を設定するセクションで、設定アプリの値を追加するアプリを見つけます。 ソリューション エクスプローラーでは、現在のソリューションに含まれるアプリの設定値しか追加できません。
7. 値を入力し、保存を選択します。
8. 設定したアプリの値を有効にするには、アプリ デザイナーまたはソリューション エクスプローラーを使用してアプリを再公開する必要があります。

ソリューション エクスプローラーを使用して設定アプリの値を削除する

1. Power Apps にサインインします。
2. ナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
3. ソリューションの一覧から、設定アプリの値を削除するソリューションを開きます。
4. 設定定義または設定環境値がソリューションにない場合は、いずれかを追加します。 詳細情報については、既存の設定定義を追加する または 既存の設定環境値を追加するにアクセスしてください。
5. 設定定義や設定環境の値を選択します。
6. 設定値の編集ダイアログで、アプリの値を設定するセクションで、設定アプリの値を削除するアプリを見つけます。 ソリューション エクスプローラーでは、現在のソリューションに含まれるアプリの設定値しか削除できません。
7. 設定アプリの値の横にある ... を選択して、環境の値にリセットする を選択します。
8. 保存 を選択します。
9. 設定したアプリの値を削除にするには、アプリ デザイナーまたはソリューション エクスプローラーを使用してアプリを再公開する必要があります。

コードによる設定値の取得、または更新

利用可能な方法については、クライアント API を使用して設定値を取得または更新する にアクセスしてください。

参照

開発者向け:

• RetrieveSetting 関数
• SaveSettingValue アクション