Boards サンプル アプリのアーキテクチャを理解する (プレビュー)
[この記事はプレリリース ドキュメントであり、変更されることがあります。]
この記事では、Boards アプリで使用されるコレクションとグローバル変数と、それらを効果的に使用する方法について解説します。 Boards のサンプル アプリをインストールして使用する方法の詳細については、Boards アプリ を参照してください。
前提条件
この記事の情報を理解して使用するには、キャンバス アプリのさまざまなコントロール、機能、およびキャパビリティについて知る必要があります。
また、Boards のサンプル アプリを インストールし、使用 する方法についても知っておく必要があります。
アーキテクチャ モデル
次の図は、ユーザーとシステムが Boards ソリューションでデータとやり取りする方法を示しています
コネクタ
Boards アプリでは、次のコネクタが使用されます:
Microsoft Dataverse - Dataverse のデータの読み取りと書き込みに使用します。
Office 365 Users - Microsoft 365 ユーザー プロファイル データの読み取りに使用します。
データ モデル
次の図は、Boards のサンプル アプリで使用されるデータ モデルについて説明しています。
テーブル
このセクションでは、Boards ソリューションに含まれるテーブルとその目的について説明します。
| テーブル | 内容 |
|---|---|
| ボード | Boards はデジタル掲示板であり、ユーザーはアイテムをピン留めし、これらを他のユーザーにも共有することができます。 これらのアイテムには、Web サイト、チーム、チャネル、会話、アプリ、またはファイルが含まれます。 |
| ボードのカテゴリ | ボードのカテゴリには、ユーザーがボードを作成する際に利用可能なカテゴリーレコードが格納されます。 ボードのカテゴリ テーブルには、名前、関連するボードのカテゴリ、カテゴリの作成日、変更日などの詳細が格納されます。 |
| ボード アイテム | ボードのアイテムは、ユーザーがボードに固定できるアイテムです。 ボードのアイテム テーブルには、名前、ボード項目のカテゴリ、アイテムの作成日、修正日などの詳細が格納されます。 |
| ボード カテゴリの基本設定 | ボードのカテゴリ設定レコードは、ユーザーがボード カテゴリの表示設定を並べ替えまたは設定したタイミングで作成されます。 名前、カテゴリ、そのカテゴリが適用されるユーザーなどの詳細は、ボードのカテゴリー基本設定テーブルに格納されます。 |
| ボードのユーザー設定 | ユーザーがアプリにログインしたかどうか、他のユーザーにリクエストを送信したり、スプラッシュ画面を表示したりするかどうかを保存するテーブルです。 |
Boards アプリ
このセクションでは、コレクション、および Boards アプリで使用されるグローバル変数について説明します。
コレクション
Boards アプリは、次のコレクションを使用します。
| コレクション名 | 内容 | 使用したスクリーン |
|---|---|---|
| colLocalization | ユーザー言語に基づいたローカライズ コレクションを構築するために使用します。 | アプリの OnStart プロパティ |
| colUserSettings | アプリを使用したユーザーの保存に使用するユーザー設定のコレクションです。 | 読み込みスクリーンの OnVisible プロパティ |
| colStockIcons | アプリ内のアイコンを表示するストックアイコンのコレクションです。 | アプリの OnSelect の OnStart プロパティ |
| colStockImages | アプリ内のアイコンを表示に使用するストック イメージのコレクションです。 | アプリの OnSelect の OnStart プロパティ |
| colBoardCoverColors | アプリ内でカバーを表示する際に使用する、ボードのカバー カラーのコレクションです。 | アプリの OnSelect の OnStart プロパティ |
| colBoardCategories | カテゴリを格納して表示するボード カテゴリのコレクションです。 | アプリの Boards スクリーンの OnVisible プロパティ |
| colDeleteBoardCategories | 削除されるボード のカテゴリのコレクションです。 | 設定画面の [保存] ボタンの OnSelect プロパティ |
| colBoards | ユーザーに表示される Boards のコレクションです。 | アプリの Boards スクリーンの OnVisible プロパティ |
| colAppNewUserCategories | 新しいユーザー カテゴリが追加されたことを示すコレクションです。 | アプリの Boards スクリーンの OnVisible プロパティ |
| colBoardCategoryPreferences | ボード カテゴリの設定を示すコレクションです。 | アプリの Boards スクリーンの OnVisible プロパティ |
| colBoardCategoryPreferenceUpdates | ボード カテゴリの更新を示すコレクションです。 | アプリの Boards スクリーンの OnVisible プロパティ |
| colSelectedBoardItems | ボードのすべてのボード項目のコレクションです。 | アプリの Boards 項目の OnVisible プロパティ |
| colAppSettings | アプリを最初にインストールしたチームのチーム ID を確認するアプリの設定です。 | アプリの OnSelect の OnStart プロパティ |
グローバル変数
Boards アプリは、次のグローバル変数を使用します。
| 変数名 | タイプ | 内容 |
|---|---|---|
| gblAppLoaded | Boolean | アプリが読み込まれているかどうかを確認します。 |
| gblUserLanguage | テキスト | ログインしたユーザーの言語の確認に使用します。 |
| gblThemeDark | Boolean | チームのテーマがダークに設定されているかどうかを確認します。 |
| gblThemeHiCo | Boolean | チームのテーマがハイ コントラストに設定されているかどうかを確認します。 |
| gblMobileMode | Boolean | アプリがモバイルで実行されているかどうかを確認する変数。 |
| gblAppSetting_inputMobileOnWeb | Boolean | デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小する変数。 |
| gblAppSetting_inputScaleFontsby | 数 | この変数を使用して、すべてのフォントを一定量でスケーリングします。 |
| gblFirstRun | Boolean | アプリが初めて実行されているかどうかを確認します。 |
| gblAppSetting_inputMobile | Boolean | モバイル向けアプリのフォントを拡大縮小する変数。 |
| gblAppColors | レコード | アプリのカラー値を設定する変数。 |
| gblAppSizes | レコード | アプリのカラー値を設定する変数。 |
| gblAppStyles | レコード | アプリでスタイル値を設定する変数。 |
| gblIsTeamsContext | Boolean | チームのグループのコンテキストの検査に使用する変数です。 |
| gblIsManager | Boolean | 選択したプロジェクトを格納するグローバル変数です。 |
| gblCurrUserEmail | レコード | GblCurrUserEmail |
| gblCurrUser | レコード | 現在のユーザー レコードを保存するグローバル変数。 |
| gblRecordUserSettings | レコード | 現在のユーザーの最新のプロジェクト ユーザー設定レコードを格納するグローバル変数。 |
| gblCurrentTeamId | レコード | 現在のチーム ID の保存に使用されます。 |
| gblIsOriginalTeamInstalTeam | Boolean | 現在のチームが元のインストール チームと同じであるかどうかを確認します。 |
| gblIsAdmin | Boolean | 現在のチームが元のチームと同じかどうかを確認するには 、現在のユーザーがチームオーナーであることを確認します。 |
| gblAppColors | レコード | アプリのカラー値を設定する変数。 |
| gblAppSizes | レコード | モバイルでのアプリ、ウェブでのモバイルのアプリサイズを格納するグローバル変数です。 |
| gblOriginalInstallTeamId | レコード | 元のインストールチーム ID を保存します。 |
| gblAppStyles | レコード | すべてのコントロールのスタイリング プロパティを格納するグローバル変数です。 |
| gblDisplayWarning | Boolean | 警告を表示するかどうかを決定します。 |
| gblWarningType | レコード | 表示する警告の種類を決定します。 |
アプリの OnStart
このセクションでは、アプリの起動時に使用するコレクション、変数、実行内容について説明します。
OnStart コレクション
以下のコレクションは、アプリの起動時に使用されます。
| コレクション名 | 説明 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズされたテキストのコレクション。 |
| colCharsWidth | 自動の幅ラベルに使用される各文字の幅のコレクション。 |
| colStockImages | ストック プロジェクトのカバー画像のコレクション。 |
| colBoardCoverColors | ボードのカバーの色のコレクションです。 |
| colStockIcons | ストックボード カバー アイコンのコレクションです。 |
OnStart 変数
以下の変数は、アプリの起動時に使用されます
| 変数名 | 説明 |
|---|---|
| gblAppLoaded | アプリが完全に読み込まれたかどうかを確認するグローバル変数。 |
| gblUserLanguage | ユーザーの言語を格納するグローバル変数。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| gblMobileWidth | モバイル用アプリの幅を定義するグローバル変数。 |
| gblMobileMode | アプリがモバイル デバイスからアクセスされているかどうかを保存するグローバル変数。 |
| gblAppSetting_inputMobileOnWeb | デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小するグローバル変数。 |
| gblAppSetting_inputMobile | モバイル向けアプリのフォントを拡大縮小するグローバル変数。 |
| gblAppSetting_inputScaleFontsBy | すべてのフォントを一定の大きさで拡大縮小するグローバル変数。 |
| gblCurrUserEmail | 現在のユーザーの電子メールアドレスを格納するグローバル変数です |
| gblIsManager | 選択したプロジェクトを格納するグローバル変数です。 |
| gblTeamsTabContext | Teams のコンテキスト値を格納するグローバル変数です。 |
| gblCurrUser | 現在のユーザー レコードを保存するグローバル変数。 |
OnStart 実行の詳細
ユーザーがアプリにアクセスすると、gblAppLoaded が false に設定されます。 ユーザーの言語コードは gblUserLanguage に保存され、English - US を既定とします。
次に、ユーザーの言語を使用して、アプリ全体で使用されるローカライズ済みテキスト (ラベルやボタンのテキストなど) を colLocalization に収集します。
ラベルの自動幅が計算され、colCharsWidth に格納されます
ユーザーの Teams テーマ/モードをチェックし、テーマが既定、ダーク、ハイ コントラストのいずれであるかを確認します。 gblThemeDark と gblThemeHiCo の変数が設定されます。
読み込み画面
このセクションでは、読み込み画面で使用するコレクション、変数、実行の詳細について説明します
画面コレクションの読み込み
以下のコレクションは、読み込み画面で使用されます。
| コレクション名 | 説明 |
|---|---|
| colUserSettings | ユーザー設定 レコードの収集に使用します。 |
| colAppSettings | アプリを最初にインストールしたチームのチーム ID を確認するアプリの設定です。 |
読み込み画面の変数
| 変数名 | 説明 |
|---|---|
| gblFirstRun | アプリが初めて実行されているかどうかを確認するグローバル変数。 |
| gblRecordUserSettings | 現在のユーザーの最新のプロジェクト ユーザー設定レコードを格納するグローバル変数。 |
| gblOriginalInstallTeamId | 元のインストールチーム ID を保存します。 |
| gblCurrentTeamId | 現在のチーム ID の保存に使用されます。 |
| gblIsOriginalInstallTeam | 現在のチームが元のインストール チームと同じであるかどうかを確認します。 |
| gblIsAdmin | 現在のチームが元のチームと同じであれば、現在のユーザーがチームオーナーとなります。 |
| gblAppSetting_inputMobileOnWeb | デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小するグローバル変数。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| gblAppColors | アプリのデザイン カラーを格納するグローバル変数です。 |
| gblAppSizes | モバイルでのアプリ、ウェブでのモバイルのアプリ サイズを格納するグローバル変数 |
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数 (読み込み画面の OnVisible で設定)。 |
| locNavigationTimer | ナビゲーション タイマーがtrueに設定されている場合、その時間間隔の後にアプリの設定とサイズが更新されます。 |
| gblAppSetting_inputMobile | モバイル向けアプリのフォントを拡大縮小するグローバル変数。 |
| gblAppSetting_inputScaleFontsBy | すべてのフォントを一定の大きさで拡大縮小するグローバル変数。 |
画面実行の詳細を読み込みます
gblAppLoaded が true で (アプリ OnStart が完了していることを指します)、gblAppStyles が空白ではなく (スタイル変数が読み込まれていることを指します)、gblAppContext、gblIsTeamsContext が true (アプリが組織、または Teams 内からアクセスされていることを指します) の場合、ユーザーは次の場所に移動します:
gblFirstRun: 現在の実行が gblFirstRun で示されるようにアプリの最初の実行である場合、この変数は true に設定され、そうでない場合は false に設定されます。
現在のユーザーの最新のボードのユーザー設定レコード (gblRecordUserSettings に格納) で、「スプラッシュの表示 (Power Apps)」列の値が Yes の場合、この変数は true に設定され、そうでない場合は false になります。
gblAppContext が false の場合、ユーザーはウェルカム ダイアログの画面に移動します。
読み込み画面では、gblAppStyles、gblAppSizes、gblAppColors などのすべてのグローバル変数を初期化し、 ダークモードやハイコントラスト モードなど、ユーザーの設定に応じた画面や色の設定を Teams デスクトップやブラウザに表示します
Boards の画面
ウェルカム ダイアログの表示
このセクションでは、ウェルカム ダイアログを表示する際に使用されるコレクション、変数、および実行の詳細について説明します
ウェルカム画面のコレクション
次のコレクションは、ウェルカム ダイアログが表示されるときに使用されます。
| コレクション名 | 説明 |
|---|---|
| colBoards | ユーザーに表示される Boards のコレクションです。 |
| colBoardCategories | ボード カテゴリのコレクションです。 |
| colBoardCategoryPreferences | ボード カテゴリの基本設定のコレクションです。 |
| colBoardCategoryPreferenceUpdates | ボード カテゴリの基本設定の更新に関するコレクションです。 |
| colAppNewUserCategories | 新しいユーザー カテゴリが追加されたことを示すアプリ専用のコレクションです。 |
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
ようこそ画面の変数
以下の変数は、ウェルカムダイアログが表示される際に使用されます。
| 変数名 | 説明 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数 (読み込み画面の OnVisible で設定)。 |
| locBlockUserInput | ユーザー入力を false に設定し、ダイアログのユーザー基本設定を更新するローカル変数です。 |
| locNavFromAbout | Boards 画面からバージョン情報画面に移動する際に、ブール値を true に設定するローカル変数です。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| locSelectedBoard | 選択したアイテムの変数コンテキストを更新するローカル変数です。 |
| locSequenceCurrent | ソートプリファレンスで設定された順序でボードを表示するローカル変数です。 |
| locSequenceNew | ユーザーが作成した新しいボードを表示するローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | ユーザー カーソルが移動する画面のプロパティにフォーカス タイマーを開始するローカル変数です。 |
| locShowFirstRun | アプリの現在の実行がユーザーの最初の実行であるかどうかを示すローカル変数。 |
| locShowPowerAppsPrompt | ユーザーが Power Apps プロンプトを表示する基本設定を [はい] または [いいえ] に設定したかどうかを示すローカル変数。 |
| locVisibleDialogUserPreferences | ユーザーが設定したソートの優先順位に基づいてボードを表示するローカル変数です。 |
ようこそ画面の実行の詳細
最初の画面は、ユーザーが初めてアプリを開いたときに一度だけ表示され、アプリの詳細情報が表示されます。ユーザーが 続ける を選択すると、アプリがどのように作成されたかを示す 2 つ目の画面が表示され、2 つのオプションが利用できます。
再度表示しない - このチェック ボックスにチェックを入れると、ユーザーの設定が更新され、このポップアップが表示されなくなります。チェック ボックスにチェックを入れずに 了解 を選択すると、毎回このポップアップが表示されます
Boards 画面の表示
このセクションでは、Boards 画面の表示時に使用されるコレクション、変数、および実行の詳細について説明します。
Boards にはコレクションが表示されます
次のコレクションは、Boards の画面が表示される際に使用されます。
| コレクション名 | **Description |
|---|---|
| colocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colBoardCategoryPreferences | ボード カテゴリの基本設定のコレクションです。 |
| colBoards | ユーザーに表示される Boards のコレクションです。 |
| colBoardCategoryPreferenceUpdates | ボード カテゴリの基本設定の更新に関するコレクションです。 |
Boards の表示変数
| 変数名 | 説明 |
|---|---|
| gblAppStyles | アプリが完全に読み込まれたかどうかを確認するグローバル変数。 |
| locSelectedBoard | ユーザーの言語を格納するグローバル変数。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locVisibleDialogUserPreferences | 表示されるダイアログの基本設定を格納するローカル変数です。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| locSelectedBoard | 選択したアイテムの変数コンテキストを更新するローカル変数です。 |
| locShowFirstRun | アプリの現在の実行がユーザーの最初の実行であるかどうかを示すローカル変数。 |
| locShowPowerAppsPrompt | ユーザーが Power Apps プロンプトを表示する基本設定を [はい] または [いいえ] に設定したかどうかを示すローカル変数。 |
| locVisibleDialogUserPreferences | ユーザーが設定したソートの優先順位に基づいてボードを表示するローカル変数です。 |
| locBoardMode | ボードの追加画面が有効になっていることを示すローカル変数です。 |
| locBlockUserInput | ユーザー入力を false に設定し、ダイアログのユーザー基本設定を更新するローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | ユーザー カーソルが移動する画面のプロパティにフォーカス タイマーを開始するローカル変数です。 |
| gblCurrUserEmail | 現在のユーザーの電子メールアドレスを格納するグローバル変数です。 |
Boards の表示実行変数
この画面では、Boards のカテゴリ、ボード項目の数、カテゴリごとの Boards などの詳細が表示されます。
ボード、カテゴリ、フィルターされた結果をリストアップするギャラリーは次のとおりです:
Boards 画面の galBoardCategories。
Boards 画面の galBoards。
Boards 画面の galSortPreferences
ソートの基本設定
このセクションでは、ソートの基本設定時に使用されるコレクション、変数、実行内容について説明します。
並び替えの基本設定のコレクション
以下のコレクションは、並び替えの基本設定が設定された際に使用されます。
| コレクション名 | 説明 |
|---|---|
| colocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colBoardCategoryPreferences | ボード カテゴリの基本設定のコレクションです。 |
| colBoardCategoryPreferenceUpdates | ボードのカテゴリの基本設定の更新に関するコレクションです。 |
並び替えの基本設定の変数
以下の変数は、並び替えの基本設定が設定された際に使用されます。
| 変数名 | 説明 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locSelectedBoard | ユーザーの言語を格納するグローバル変数。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locVisibleDialogUserPreferences | 表示されるダイアログの基本設定を格納するローカル変数です。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| locSelectedBoard | 選択したアイテムの変数コンテキストを更新するローカル変数です。 |
| locShowFirstRun | アプリの現在の実行がユーザーの最初の実行であるかどうかを示すローカル変数。 |
| locShowPowerAppsPrompt | ユーザーが Power Apps プロンプトを表示する基本設定を [はい] または [いいえ] に設定したかどうかを示すローカル変数。 |
| locVisibleDialogUserPreferences | ユーザーが設定したソートの優先順位に基づいてボードを表示するローカル変数です。 |
| locBoardMode | ボードの追加画面が有効になっていることを示すローカル変数です。 |
| locBlockUserInput | ユーザー入力を false に設定し、ダイアログのユーザー基本設定を更新するローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | ユーザー カーソルが移動する画面のプロパティにフォーカス タイマーを開始するローカル変数です。 |
| gblCurrUserEmail | 現在のユーザーの電子メールアドレスを格納するグローバル変数です。 |
並び替えの基本設定の実行の詳細
galSortPreferences 変数は、ユーザーが並び替えの設定とボードのカテゴリを選択して、ボードの画面での表示/非表示を決めることができる並び替えの基本設定を表示します。
ボード画面の追加
ボードの追加
ここでは、ボードの追加時に使用するコレクション、変数、実行内容について説明します。
ボードのコレクションを追加する
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colBoardCoverColors | ボード カバーの色のコレクションです。 |
| colStockIcons | ストック ボード カバーのアイコンのコレクションです。 |
| colStockImages | ストック ボード カバーの画像のコレクションです。 |
ボード変数の追加
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| locDefaultBoardCoverColor | 最初のボード カバーの色を設定するローカル変数です。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locCoverChanged | 変更されたカバーを格納するローカル変数です。 |
| locCustomImageSelected | ユーザーが追加したカスタム画像を保存するローカル変数です。 |
| locCoverImageSelected | 選択した画像のカバーを格納するローカル変数です。 |
| locCoverColorSelected | 画像が選択されたときに選択されたカバーのカラーを false にするローカル変数です。 |
| locDefaultBoardCoverIcon | 最初のカバー アイコンを既定として設定するローカル変数です。 |
| locBoardMode | ボードのモードを追加に設定するローカル変数です。 |
ボード画面の編集
削除の警告
ここでは、削除の警告が表示されたときに使用されるコレクション、変数、実行内容について説明します。
削除の警告のコレクション
削除の警告が表示された際に使用されるコレクションは以下のとおりです。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
削除の警告の変数
削除の警告が表示された際に使用される変数は以下のとおりです
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| locDefaultBoardCoverColor | 最初のボード カバーの色を設定するローカル変数です。 |
| gblThemeHiCo | Microsoft Teams がコントラスト モードで実行されている場合に保存するグローバル変数です。 |
| locCoverChanged | 変更されたカバーを格納するローカル変数です。 |
| locCustomImageSelected | ユーザーが追加したカスタム画像を保存するローカル変数です。 |
| locCoverImageSelected | 選択した画像のカバーを格納するローカル変数です。 |
| locCoverColorSelected | 画像が選択されたときに選択されたカバーのカラーを false にするローカル変数です。 |
| locDefaultBoardCoverIcon | 最初のカバー アイコンを既定として設定するローカル変数です。 |
| locBoardMode | ボードのモードを追加に設定するローカル変数です。 |
| locDeleteBoardWarning | ボードの削除項目が選択されている場合は true を、そうでない場合は false を設定するローカル変数です。 |
| locSelectedBoard | ボードの編集あたって選択したボード ID を格納するローカル変数です。 |
| locSelectedBoardColor | 選択されているボードのカラーを格納するローカル変数です。 |
| locSelectedBoardIcon | ユーザーが選択したボード アイコンとしての値を設定するローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | 画面のプロパティに対するフォーカス タイマーを開始するローカル変数です。 |
| gblAppColors | アプリのカラー値を設定する変数。 |
削除警告の実行内容
ボードの編集画面で、ユーザーがボード項目の削除を選択すると、警告の編集画面が表示されます。 ユーザーは、警告をキャンセルしてボード編集画面を表示するか、ボードを削除するかを選択できます
ユーザーが削除を選択すると、ボードが削除され、アプリはボードの画面に戻ります。
ボードの編集
ここでは、ボードの編集時に使用するコレクション、変数、実行内容について説明します。
ボードの編集コレクション
以下のコレクションは、ボードの編集時に使用されます。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colBoardCoverColors | ボード カバーの色のコレクションです。 |
| colStockIcons | ストック ボード カバーのアイコンのコレクションです。 |
| colStockImages | ストック ボード カバーの画像のコレクションです。 |
ボードの編集変数
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| locDefaultBoardCoverColor | 最初のボード カバーの色を設定するローカル変数です。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locCoverChanged | 変更されたカバーを格納するローカル変数です。 |
| locCustomImageSelected | ユーザーが追加したカスタム画像を保存するローカル変数です。 |
| locCoverImageSelected | 選択した画像のカバーを格納するローカル変数です。 |
| locCoverColorSelected | 画像が選択されたときに選択されたカバーのカラーを false にするローカル変数です。 |
| locDefaultBoardCoverIcon | 最初のカバー アイコンを既定として設定するローカル変数です。 |
| locBoardMode | ボードのモードを追加に設定するローカル変数です。 |
| locDeleteBoardWarning | ボードの削除項目が選択されている場合は true を、そうでない場合は false を設定するローカル変数です。 |
| locSelectedBoard | ボードの編集あたって選択したボード ID を格納するローカル変数です。 |
| locSelectedBoardColor | 選択されているボードのカラーを格納するローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | 画面のプロパティに対するフォーカス タイマーを開始するローカル変数です。 |
| gblAppColors | アプリで色の値を設定する変数です。 |
ボードの編集の実行の詳細
ボード項目の画面の「編集」ボタンでボードを選択すると、ボードの編集画面が表示されます。 ユーザーがボードを作成した場合には、ボードを削除する選択肢があり、そうでない場合には、ボードの説明やタイトルなどを更新する選択肢があります。
ドロップダウンに表示されるカテゴリは、管理者が設定したボード カテゴリーに由来するものです。カバー アイコン、カラー、カバー画像は、次のギャラリーから選択できます: galCoverIcons_AddBoard、galCoverColors_AddBoard、galCovers_AddBoard。
ボード項目の画面
ここでは、ボード項目の画面で使用するコレクション、変数、実行内容について説明します。
ボード項目をクリア
以下のコレクションは、ボード項目の画面で使用されます。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colSelectedBoardItems | ボードのすべてのボード項目のコレクションです。 |
ボード項目の変数
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locSelectedBoard | 選択したボードの変数コンテキストを更新するローカル変数です。 |
| locBoardItemCategoryFilter | 選択したボード項目のカテゴリを設定するローカル変数です。 |
| locSelectedBoardItem | 選択したボード項目の変数コンテキストを更新するローカル変数です。 |
ボード項目の実行の詳細
- ボード項目の画面では、新しいボード項目の追加や、ユーザーが追加した既存のボードアイテムを閲覧することができます。 ボード項目を作成した現在のユーザーは、ボード項目を編集するオプションを表示できますが、編集オプションは無効となっています。ボード項目を検索するには、項目検索スペースに galBoardItems_Nested と入力すると、そのテキストに関連するアイテムがアイテム名や説明で表示されます。
ボード項目画面の追加
ボード項目の追加
ここでは、ボード項目の追加時に使用するコレクション、変数、実行内容について説明します
ボードに項目のコレクションを追加する
以下のコレクションは、ボード項目の編集時に追加されます。
| コレクション名 | 内容 |
|---|---|
| colLocalization | - ユーザーの言語に基づいてローカライズされたテキストのコレクションです。 |
ボード項目の変数を追加する
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locSelectedBoard | 選択したボードの変数コンテキストを更新するローカル変数です。 |
| locBoardItemChannel | ボード項目のカテゴリを設定するローカル変数です。 |
| locBoardItemConversation | 選択したボード項目の変数コンテキストを更新するローカル変数です。 |
| locBoardItemTeam | ユーザーが Power Apps でカスタマイズを選択したときに true を設定するローカル変数です。 |
| gblCurrUserEmail | 現在のユーザーの電子メールアドレスを格納するグローバル変数です。 |
ボードのの実行の詳細を追加する
ボード項目を追加する 画面には、Webサイト、Teams チャンネル、ファイル、その他のカテゴリーなどの新しいボード項目を追加するオプションがあり、選択されたボードの配下に新しいボード項目を保存します。
ボード項目画面の編集
警告ボード項目の編集
ここでは、ボード項目の削除の警告が表示されたときに使用されるコレクション、変数、実行内容について説明します。
警告ボード項目の編集のコレクション
ボード項目削除の警告が表示された場合、以下のコレクションが使用されます。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
警告ボード項目の編集の変数
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locDeleteBoardWarning | ボードの削除項目が選択された場合に、値を true にするローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | 画面のプロパティに対するフォーカス タイマーを開始するローカル変数です。 |
| gblAppColors | アプリのカラー値を設定する変数。 |
実行の詳細
ボード項目の編集画面で、ユーザーがボード項目の削除を選択すると、警告の編集画面が表示されます。 ユーザーは、ボード項目の編集画面で表示される警告のキャンセルを選択できます。
ユーザーが削除を選択すると、ボード項目が削除され、アプリはボードの画面に戻ります。
ボード アイテムの編集
このセクションでは、ボード項目の編集時に使用するコレクション、変数、実行内容について説明します。
ボード項目の編集のコレクション
以下のコレクションは、ボード項目の編集時に使用されます。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colBoardCoverColors | ボード カバーの色のコレクションです。 |
| colStockIcons | ストック ボード カバーのアイコンのコレクションです。 |
| colStockImages | ストック ボード カバーの画像のコレクションです。 |
ボード項目の編集の変数
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locScreenReaderAnnouncedText | スクリーン リーダーの告知を開始するローカル変数です。 |
| gblThemeDark | チームがダーク モードで実行されている場合に保存するグローバル変数。 |
| locDefaultBoardCoverColor | 最初のボード カバーの色を設定するローカル変数です。 |
| gblThemeHiCo | チームがコントラスト モードで実行されている場合に保存するグローバル変数。 |
| locNewBoardItemLink | ボードのモードを追加に設定するローカル変数です。 |
| locDeleteBoardWarning | ボードの削除項目が選択されている場合は true を、そうでない場合は false を設定するローカル変数です。 |
| locSetFocusControlTarget | ユーザー カーソルが移動する各項目で、ターゲットにフォーカスを保つローカル変数です。 |
| locSetFocusTimerStart | 画面のプロパティに対するフォーカス タイマーを開始するローカル変数です。 |
| gblAppColors | アプリで色の値を設定する変数です。 |
| locSelectedBoardItem | 選択したボード項目の変数コンテキストを更新するローカル変数です。 |
| gblTeamsTabContext | Teams のコンテキスト値を格納するグローバル変数です。 |
| gblIsAdmin | ユーザーが管理者であるかどうかを確認するグローバル変数です。 |
| gblCurrUserEmail | 現在のユーザーの電子メールアドレスを格納するグローバル変数です。 |
| locBoardItemChannel | ボード項目のカテゴリを設定するローカル変数です。 |
| locBoardItemConversation | 選択したボード項目の変数コンテキストを更新するローカル変数です。 |
| locPreloadBoardItem | 画面の初期化時に値を true に設定するローカル変数です。 |
実行の詳細
ユーザーがボード項目の画面で編集ボタンを選択すると、ボード項目の編集画面が表示されます。 ユーザーがボードを作成した場合には、ボード項目を削除する選択ができ、そうでない場合には、ボードの説明やタイトルなどを更新する選択ができます。
設定画面
このセクションでは、設定画面で使用されるコレクション、変数、実行の詳細について説明します。
設定画面のコレクション
設定画面で使用するコレクションは以下の通りです。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
| colBoardCategories | 管理者が追加するボード カテゴリのコレクションです。 |
| colDeletedBoardCategories | 削除されるボード のカテゴリのコレクションです。 |
設定画面の変数
設定画面で使用する変数は以下の通りです。
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
| locSettingsChanged | ユーザーがカテゴリを追加した際に値を true に設定するローカル変数です。 |
| locGalleryDefaultCategory | galCategories で利用可能なカテゴリのギャラリーを格納するローカル変数です。 |
実行の詳細
設定 コンテナーの戻るボタンを選択すると、ボードの画面に戻ります。
バージョン情報画面
このセクションでは、バージョン情報画面で使用されるコレクション、変数、実行の詳細について説明します。
[バージョン情報] 画面のコレクション
バージョン情報画面で使用するコレクションは以下の通りです。
| コレクション名 | 内容 |
|---|---|
| colLocalization | ユーザーの言語に基づいたローカライズ済みテキストのコレクション。 |
[バージョン情報] 画面の変数
バージョン情報画面で使用する変数は以下の通りです。
| 変数名 | 内容 |
|---|---|
| gblAppStyles | すべてのコントロールのスタイル プロパティを格納するグローバル変数です (読み込み画面の OnVisible で設定します)。 |
[バージョン情報] 画面の実行の詳細
conNavigtion_About コンテナーの戻るボタンを選択すると、ボードの画面に戻ります。
関連項目
Boards のサンプル アプリ (プレビュー)
Microsoft Teams ストアからのサンプル アプリを使用する
Teams ストアからインストールされたサンプル アプリをカスタマイズする
サンプル アプリについてよく寄せられる質問 (FAQ)
フィードバック
フィードバックの送信と表示