How-to アプリのサンプル アプリのアーキテクチャ (プレビュー) を理解する

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

この記事では、How-to アプリで使用されるコレクションとグローバル変数と、それらを効果的に使用する方法について解説します。

前提条件

この記事の情報を理解して使用するには、キャンバス アプリのさまざまなコントロール、機能、およびキャパビリティについて知る必要があります。

• キャンバス アプリでコレクションを作成および更新する
• Power Apps の Collect、Clear、および ClearCollect 関数
• Power Apps のキャンバス アプリ変数について
• Power Apps のキャンバス アプリ コントロールの追加および構成
• キャンバス アプリにスクリーンを追加し、スクリーン間を移動する

データ モデル

次の図は、How-to アプリ ソリューションのテーブル、列、関連付けを示しています。

テーブル

テーブル	内容
アイテムのデモ	How-to アプリは、新しい開発者が Power Apps の作成方法を学ぶのに役立つように設計されています。 このテーブルは、ユーザーがチェックアウト可能なアイテムを保存するために作成するテーブルの例として提供されています。
アイテム チェックアウト デモ	How-to アプリは、新しい開発者が Power Apps の作成方法を学ぶのに役立つように設計されています。 このテーブルは、ユーザーがチェックアウト レコードを保存するために作成するテーブルの例として提供されています。
アイテム タイプ デモ	How-to アプリは、新しい開発者が Power Apps の作成方法を学ぶのに役立つように設計されています。 このテーブルは、ユーザーがアイテムの分類のためのアイテムの種類を保存するために作成するテーブルの例として提供されています。
アイテム チェックアウト アプリのステージ	ユーザーがアプリでレッスンを進めると、アプリの進行状況を保存して、ユーザーが中断したところから再開するこができます。
アイテム チェックアウト 手順	How-to アプリを進めるための手順は、アイテム チェックアウト手順のテーブルに保存されています。

アーキテクチャ モデル

次の図は、How-to アプリ ソリューションでユーザー、システム、データがどのようにやり取りするかを示しています

コネクタ

How-to アプリでは、次のコネクタが使用されます。

• Microsoft Dataverse - Dataverse のデータの読み取りと書き込みに使用します。
• Office 365 Users - Microsoft 365 ユーザー プロファイル データの読み取りに使用します。

コレクション

次のコレクションは、How-to アプリ ソリューションで使用されます。

コレクション名	内容	使用するスクリーン
colLocalization	ユーザー言語に基づいたローカライズ コレクションを構築するために使用します	アプリの OnStart プロパティ

グローバル変数

次のグローバル変数は、How-to アプリ ソリューションで使用されます。

変数名	タイプ	内容
gblUserLanguage	テキスト	ログインしたユーザーの言語の確認に使用します。
gblThemeDark	Boolean	チームのテーマがダークに設定されているかどうかを確認します。
gblThemeHiCo	Boolean	チームのテーマがハイ コントラストに設定されているかどうかを確認します。
gblAppSetting_inputMobileOnWeb	Boolean	デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小する変数。
gblAppSetting_inputScaleFontsby	数	この変数を使用して、すべてのフォントを一定量でスケーリングします。
gblAppSetting_inputMobile	Boolean	モバイル向けアプリのフォントを拡大縮小する変数。
gblAppColors	レコード	アプリのカラー値を設定する変数。
gblAppSizes	レコード	アプリのカラー値を設定する変数。
gblAppStyles	記録	アプリでスタイル値を設定する変数。
gblCurrUserEmail	記録	現在のユーザーのメール アドレスを格納するグローバル変数です。
gblCurrUser	記録	現在のユーザー レコードを保存するグローバル変数。

アプリの OnStart

このセクションでは、How-to アプリの起動時に使用するコレクション、変数、実行内容について説明します。

OnStart コレクション

以下のコレクションは、アプリケーションの起動時に使用されます。

コレクション名	説明
colLocalization	ユーザーの言語に基づいたローカライズされたテキストのコレクション。

OnStart 変数

以下の変数は、アプリケーションの起動時に使用されます。

変数名	説明
gblAppLoaded	- アプリが完全に読み込まれたかどうかを確認するグローバル変数。
gblUserLanguage	- ユーザーの言語を格納するグローバル変数。
gblCurrUserEmail	- 現在のユーザーのメールアドレスを格納するグローバル変数。
gblCurrUser	- 現在のユーザー レコードを保存するグローバル変数。

OnStart 実行の詳細

1. ユーザーがアプリにアクセスすると、gblAppLoaded が false に設定されます。 ユーザーの言語コードは gblUserLanguage に保存され、English - US を既定とします。

2. ユーザーの言語は、アプリ全体で使用されるローカライズされたテキスト (ラベルやボタンのテキスト) を colLocalization で収集するために使用します。

ようこそ画面

このセクションでは、ようこそ画面で使用されるコレクション、変数、実行の詳細について説明します。

ようこそ画面のコレクション

ようこそ画面で使用するコレクションは以下の通りです。

コレクション名	説明
colLocalization	ユーザーの言語に基づいたローカライズ済みテキストのコレクション。

ようこそ画面の変数

設定画面で使用する変数は以下の通りです。

変数名	説明
gblCurrUserEmail	現在のユーザーの電子メールアドレスを格納するグローバル変数です
gblThemeDark	チームがダーク モードで実行されている場合に保存するグローバル変数。
gblThemeHiCo	チームがコントラスト モードで実行されている場合に保存するグローバル変数。
gblAppColors	アプリのデザイン カラーを保存するグローバル変数です
gblAppSizes	モバイルでのアプリ、ウェブでのモバイルのアプリ サイズを格納するグローバル変数
gblAppStyles	すべてのコントロールのスタイル プロパティを格納するグローバル変数 (読み込み画面の OnVisible で設定)。
gblAppSetting_inputMobileOnWeb	デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小するグローバル変数。
gblAppSetting_inputMobile	モバイル向けアプリのフォントを拡大縮小するグローバル変数。
gblAppSetting_inputScaleFontsBy	すべてのフォントを一定の大きさで拡大縮小するグローバル変数。

ようこそ画面の実行の詳細

1. gblAppStyles の場合、空白ではありません (つまり、スタイリング変数がロードされています)。

2. 読み込み画面では、gblAppStyles、gblAppSizes、gblAppColors などのすべてのグローバル変数を初期化して、 ダーク モードやハイコントラスト モードなど、ユーザーの設定に応じた画面や色の設定を Teams デスクトップやブラウザーに表示します。

3. この画面では、プレビューアプリ が表示されます。 これを選択すると、資産画面にリダイレクトされます。

アイテム画面

ここでは、アイテム画面で使用するコレクション、変数、実行内容について説明します。

アイテム画面コレクション

以下のコレクションは、アイテム画面で使用されます。

変数名	説明
colLocalization	ユーザーの言語に基づいたローカライズ済みテキストのコレクション。

アイテム画面変数

以下の変数は、アイテム画面で使用されます。

変数名	説明
locShowItems	アイテムの種類に基づいてアイテムを表示するローカル変数。
locSelectedItemType	選択されたアイテムの種類を表示するローカル変数。
gblThemeDark	チームがダーク モードで実行されている場合に保存するグローバル変数。
gblThemeHiCo	チームがコントラスト モードで実行されている場合に保存するグローバル変数。
gblAppColors	アプリのデザイン カラーを格納するグローバル変数です。
gblAppStyles	すべてのコントロールのスタイル プロパティを格納するグローバル変数 (読み込み画面の OnVisible で設定)。

アイテム画面実行の詳細

1. アイテム画面には、galItemTypes_Demo に保存されている各アイテムで使用可能なアイテムの数とアイテムの種類が表示されます。

2. ユーザーが galItemTypes_Demo でアイテムの種類のいずれかを選択すると、アイテムは galItems_Demo に表示されます。

チェックアウト画面

このセクションでは、チェックアウト 画面で使用するコレクション、変数、実行の詳細について説明します。

チェックアウト画面コレクション

以下のコレクションは、チェックアウト画面で使用されます。

コレクション	内容
colLocalization	ユーザーの言語に基づいたローカライズ済みテキストのコレクション。

チェックアウト画面コレクション

以下の変数は、チェックアウト画面で使用されます。

変数名	内容
gblAppStyles	すべてのコントロールのスタイリング プロパティを保存するグローバル変数です。
gblThemeDark	Teams がダーク モードで実行されている場合に保存するグローバル変数。
locShowCheckoutConfirmation	ユーザー ID をランダムにシャッフルして接続を表示するローカル変数。
gblAppColors	アプリのデザイン カラーを保存するグローバル変数。
gblThemeHiCo	Teams がコントラスト モードで実行されている場合に保存するグローバル変数。
locSelectedItem	現在のユーザーのメールアドレスを保存するグローバル変数。

チェックアウト画面実行の詳細

1. ユーザーが必要なアイテムのいずれかを選択すると、locSelectedItem アイテムに保存されているアイテムの可用性に基づいてチェックアウトを選択できます。

2. アイテムがチェックアウトされると、locShowCheckoutConfirmation からの確認メッセージが表示されます。

マイ チェックアウト画面

このセクションでは、マイ チェックアウト 画面で使用するコレクション、変数、実行の詳細について説明します。

チェックアウト コレクション

以下のコレクションは、マイ チェックアウト画面で使用されます。

変数名	内容
colLocalization	ユーザーの言語に基づいたローカライズ済みテキストのコレクション。

マイ チェックアウト変数

以下の変数は、マイ チェックアウト画面で使用されます。

変数名	内容
gblAppStyles	すべてのコントロールのスタイル プロパティを格納するグローバル変数 (読み込み画面の OnVisible で設定)。
gblThemeDark	チームがダーク モードで実行されている場合に保存するグローバル変数。
gblThemeHiCo	チームがコントラスト モードで実行されている場合に保存するグローバル変数。
gblAppColors	アプリのデザイン カラーを格納するグローバル変数です。
locShowReturnConfirmation	ユーザーが返品ボタンを選択したときに返品確認メッセージを表示するローカル変数。
locSelectedItemType	選択されたアイテムの種類を表示するローカル変数。
locShowItems	アイテムの種類に基づいてアイテムを表示するローカル変数。
gblCurrUser	現在のユーザー レコードを保存するグローバル変数。
locSelectedItemForReturn	選択したアイテムをアイテムに戻すローカル変数。

マイ チェックアウト実行の詳細

1. ユーザーがチェックアウトしたすべてのアイテムがこの画面に表示されます。 ユーザーには、返品して返品期限を表示するオプションがあります

2. ユーザーが返品を選択すると、アイテムはアイテム画面に戻ります。

関連項目

• How-to サンプル アプリを使用する (プレビュー)
• サンプル アプリをカスタマイズする
• サンプル アプリ FAQ
• Microsoft Teams ストアからのサンプル アプリを使用する

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。