マイルストーンサンプルアプリのアーキテクチャについて

[アーティクル]
03/09/2022

この記事では、マイルストーンアプリで使用されるコレクションとグローバル変数について学び、それらを効果的に使用する方法を習得します。マイルストーンサンプルアプリをインストールして使用する方法の詳細については、マイルストーンサンプルアプリを参照してください。

前提条件

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

また、マイルストーンサンプルアプリをインストール、および使用する方法も知っておく必要があります。

データモデル

マイルストーンサンプルアプリのデータモデル

アーキテクチャモデル

次の図は、ユーザーとシステムがこのソリューションでデータとやり取りする方法を示しています。

マイルストーンアーキテクチャモデル

コネクタ

マイルストーンアプリは、次のコネクタを使用します:

Dataverse テーブルにデータを読み書きするための Microsoft Dataverse。
ユーザープロファイルデータを読み取る Office 365 ユーザー。

テーブル

マイルストーンアプリには、次のテーブルが含まれています:

テーブル名	内容
Project	プロジェクトとは、特定の目的を達成するために慎重に計画された個人または共同事業を意味します。名前、いつ、誰が作成または変更したかなどの詳細は、Projects エンティティの下に保存されます。 1 つのプロジェクトに、複数のマイルストーン、作業項目、チームメンバー、および活動を関連付けることができます。
プロジェクトマイルストーン	プロジェクトマイルストーンは、の重要な成果を表すタスクですプロジェクト。マイルストーンは、段階的に一連のイベントを表す必要がありますプロジェクトが完了するまで積み上げます。名前、関連付けられているプロジェクト、日付などの詳細マイルストーンを完了する必要がある場合は、プロジェクトマイルストーンの下に保存されますエンティティ。マイルストーンは 1 つのプロジェクトの一部としてのみ使用できますが複数の作業項目を関連付けることができます。
プロジェクト作業項目	作業項目は、作業の種類、必要な作業、完了すべき日付を示します。名前、説明、割り当て先、状態、優先度、目標日などの詳細が、作業項目を定義します。作業項目は 1 つのマイルストーンの一部にすることができ、それに関連付けることができる状態、優先度、カテゴリ、およびチームメンバーは 1 つだけです。ただし、複数の関連付けられた活動を持つことはできます。
プロジェクトの状態	状態には、作業項目の全体的な状態がまとめられます。既定の状態の値には、「新規」、「進行中」、「ブロック済み」、および「完了」があります。アプリの設定セクションから、さらに状態を追加することができます。各状態には、名前と関連付けられた色があります。
作業項目の優先度	優先度は、残りの作業項目と比較した場合に、作業項目が完了しなければならない重要度の順序を表します。既定の優先順位には、P0、P1、P2、および P3 が含まれます。アプリの設定セクションから、さらに優先度を追加することができます。各優先度には、名前と関連付けられた色があります。
作業項目のカテゴリ	カテゴリは、作業項目の分類に役立ちます。既定の優先順位には、高、中、低があります。アプリの設定セクションから、さらにカテゴリを追加することができます。各カテゴリには、名前と関連付けられた色があります。
プロジェクトチームメンバー	チームメンバーは、プロジェクトの 1 つ以上の作業項目に取り組む個人です。複数のプロジェクトに参加している個人には、プロジェクトごとに 1 つのチームメンバーレコードがあります。
プロジェクト活動	活動は、プロジェクトの作業項目に対して行われた更新を示すために使用されます。 A 1 つの作業項目に複数の活動を含めることができます。活動は次の理由で作成されます作業項目が更新されます。活動は、手動でも作成できます。
プロジェクトユーザー設定	ユーザー設定は、アプリにログインするたびに Power Apps スプラッシュスクリーンを表示することに関連するユーザー設定を保存するために使用されます。各ユーザーに対して 1 つのレコードがあります。

コレクション

コレクション名	内容	使用した画面
colLocalization	ユーザー言語に基づいたローカライズコレクションを構築するために使用します。	アプリの OnStart プロパティ
colWorkItems	作業項目の収集に使用します。
colUserSettings	ユーザー設定 Dataverse レコードが存在する場合の収集に使用します。	アプリの OnStart プロパティ
colWorkItemHeaderIcons	作業項目のヘッダーアイコンの収集に使用します。	アプリの OnStart プロパティ
colProjectCoverColors	プロジェクトカバーの色の収集に使用します。	アプリの OnStart プロパティ
colStockImages	アプリで使用されているストック画像を収集するためのコレクション。	アプリの OnStart プロパティ
colNewProjectMilestones	新しく追加されたマイルストーンの既定情報の収集に使用します。	プロジェクト画面のマイルストーン追加画像の OnSelect プロパティ
colProjectTeamMembers	プロジェクトに参加しているチームメンバーの収集に使用します。	設定画面の OnVisible プロパティ
colRemovedProjectTeamMembers	プロジェクトから削除されたチームメンバーの収集に使用します。	チームメンバー設定の下にある [削除] ボタンの OnSelect プロパティ
colRemovedProjectMilestones	プロジェクトから削除されたマイルストーンの収集に使用します。	なし
colCategories	カテゴリ情報の収集に使用します。	設定画面の [保存] ボタンの OnSelect プロパティ
colNewProjectTeamMembers	プロジェクトに新しく追加されたチームメンバーの収集に使用します。	プロジェクト画面の [作成] ボタンの OnSelect プロパティ
colProjectMilestones	プロジェクトのマイルストーン情報の収集に使用します。	[削除の確認] ボタンの OnSelect プロパティ
colRemovedCategories	削除されるカテゴリの収集に使用します。	設定画面の [保存] ボタンの OnSelect プロパティ
colPriorities	優先順位情報の収集に使用します。	設定画面の [保存] ボタンの OnSelect プロパティ
colRemovedPriorities	削除される優先度の収集に使用します。	設定画面の [保存] ボタンの OnSelect プロパティ
colStatuses	状態に関する情報の収集に使用します。	設定画面の [保存] ボタンの OnSelect プロパティ
colRemovedStatuses	削除される優先度の収集に使用します。	設定画面の [保存] ボタンの OnSelect プロパティ
colRemoveWorkItems	削除が確認された作業項目の収集に使用します。	プロジェクト画面の確認ポップアップにある [削除] ボタンの OnSelect プロパティ。
colRemovedMilestones	プロジェクトから削除されたチームメンバーの収集に使用します。	設定ページのプロジェクトの詳細セクションにある [削除] ボタンの OnSelect プロパティ。
colWorkItemStatuses	作業項目の使用可能な状態の収集に使用します。	プロジェクト画面の状態コンボボックスの Items プロパティ

グローバル変数

変数名	タイプ	内容
gblAppLoaded	Boolean	アプリが読み込まれているかどうかを確認します。
gblUserLanguage	テキスト	ログインしたユーザーの言語を確認します。
colCharsWidth	テーブル	差分フォント、太さ、サイズなどの文字幅を格納するために使用します。
gblThemeDark	Boolean	チームのテーマがダークに設定されているかどうかを確認します。
gblThemeHiCo	Boolean	チームのテーマがハイコントラストに設定されているかどうかを確認します。
gblMobileWidth	数	モバイルで幅を設定するための変数。
gblMobileMode	Boolean	アプリがモバイルで実行されているかどうかを確認する変数。
gblAppSetting_inputMobileOnWeb	Boolean	デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小する変数。
gblAppSetting_inputScaleFontsby	数	この変数を使用して、すべてのフォントを一定量でスケーリングします。
gblAppContext	Boolean	アプリが実行されている場所のコンテキストを確認する。
gblFirstRun	Boolean	アプリが初めて実行されているかどうかを確認します。
gblRecordUserSettings	レコード	複数のレコードが存在する場合に最も古いレコードを使用する変数。
gblAppSetting_inputMobile	Boolean	モバイル向けアプリのフォントを拡大縮小する変数。
gblAppColors	レコード	アプリのカラー値を設定する変数。
gblAppSizes	レコード	アプリのカラー値を設定する変数。
gblAppStyles	レコード	アプリでスタイル値を設定する変数。
gblProject	レコード	コンテキスト内のプロジェクトレコードを格納する変数。

アプリの OnStart

このセクションでは、アプリ OnStart コレクション、変数、および実行の詳細について説明します。

OnStart コレクション

アプリ OnStart 中に使用されるコレクション:

コレクション名	内容
colLocalization	ユーザーの言語に基づいたローカライズされたテキストのコレクション。
colCharsWidth	自動の幅ラベルに使用される各文字の幅のコレクション。
colStockImages	ストックプロジェクトのカバー画像のコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。
colWorkItemHeaderIcons	作業項目のヘッダーアイコンのコレクション。
colUserSettings	プロジェクトユーザー設定テーブルからのユーザー設定のコレクション。

OnStart 変数

アプリ OnStart 中に使用される変数:

変数名	内容
gblAppLoaded	アプリが完全に読み込まれたかどうかを確認するグローバル変数。
gblUserLanguage	ユーザーの言語を格納するグローバル変数。
gblThemeDark	チームがダークモードで実行されている場合に保存するグローバル変数。
gblThemeHiCo	チームがコントラストモードで実行されている場合に保存するグローバル変数。
gblMobileWidth	モバイル用アプリの幅を定義するグローバル変数。
gblMobileMode	アプリがモバイルデバイスからアクセスされているかどうかを保存するグローバル変数。
gblAppSetting_inputMobileOnWeb	デスクトップで実行されるモバイル向けアプリのフォントを拡大縮小するグローバル変数。
gblAppSetting_inputMobile	モバイル向けアプリのフォントを拡大縮小するグローバル変数。
gblAppSetting_inputScaleFontsBy	すべてのフォントを一定の大きさで拡大縮小するグローバル変数。
gblAppContext	アプリが実行されている場所のコンテキストを確認するグローバル変数。
gblFirstRun	アプリが初めて実行されているかどうかを確認するグローバル変数。
gblRecordUserSettings	現在のユーザーの最新のプロジェクトユーザー設定レコードを格納するグローバル変数。

OnStart 実行の詳細

ユーザーがアプリにアクセスすると、gblAppLoaded が false に設定されます。ユーザーの言語コードは gblUserLanguage に保存され、既定では英語 - 米国となります。
ユーザーの言語は、アプリ全体で使用されるローカライズされたテキスト (例えば、ラベルやボタンのテキスト) を colLocalization で収集するために使用します。
ユーザーの Microsoft Teams テーマ/モードをチェックし、テーマが既定、ダーク、ハイコントラストのいずれであるかを確認します。 gblThemeDark および gblThemeHiCo 変数がそれに応じて設定されます。
ストック画像とカバーの色は、それぞれ colStockImages と colProjectCoverColors に集められます。 olProjectCoverColors には、14 色のセットが 2 つあります。各ベースに対して、2 色あります。 1 つは既定のテーマ用で、もう 1 つはダークテーマ用です。たとえば、#F4B9B9 は、#791818 と同等の既定のモードです。
プロジェクトユーザー設定テーブルからのユーザー詳細は、colUserSettings に集められます。レコードが存在しない場合は、新しいプロジェクトユーザー設定レコードが作成され、変数 gblFirstRun が true に設定されます。これにより、スプラッシュダイアログの表示方法を制御します。複数のプロジェクトユーザー設定レコードが存在する場合、最も古いレコードが選択され、gblRecordUserSettings 変数に保存されます。

読み込み画面

このセクションでは、アプリの読み込み画面のコレクション、変数、実行の詳細について説明します。

プロジェクト画面への移動

初回実行のエクスペリエンス

このセクションでは、アプリの初回の実行のエクスペリエンス、関連するコレクション、変数、および実行の詳細ついて説明します。

最初の実行エクスペリエンス変数

次の変数は、初回実行エクスペリエンスを制御するために使用されます

変数名	説明
locShowFirstRun	アプリの現在の実行がユーザーの最初の実行であるかどうかを示すローカル変数。
locShowPowerAppsPrompt	スプラッシュスクリーンを表示するかまたは非表示にするかを示すローカル変数。

初回実行エクスペリエンスの実行の詳細

locShowFirstRun または locShowPowerAppsPrompt のいずれかが true の場合、コンテナー conDialogWelcome が表示されます。
locShowFirstRun が true の場合、コンテナー conDialogFirstRun が表示され、アプリの概要が示されます。
続行を選択すると、locShowFirstRun を false に設定し、conDialogFirstRun コンテナーを非表示にします。 locShowPowerAppsPrompt が true の場合、コンテナー conDialogSplash_PowerApps が表示され、スプラッシュスクリーンが表示されます。
次回から表示しない をチェックして OK を選択すると、現在のユーザの プロジェクトユーザー設定 レコードにある スプラッシュの表示 (PowerApps) 列を いいえ に更新し、その後の実行で locShowPowerAppsPrompt を false に設定して、スプラッシュ画面を非表示にします。また、locShowPowerAppsPrompt と locShowFirstRun の両方が false に設定されているため、ユーザーはアプリを続行できます。
次回から表示しない チェックボックスをチェックせずに OK を選択すると、locShowPowerAppsPrompt と locShowFirstRun の両方を false に設定するため、ユーザーはアプリを続行できます。以降の実行では、ユーザーが [次回から表示しない] チェックボックスをチェックするまで、スプラッシュ画面が表示されます。
ユーザーが続行を選択すると、すべてのプロジェクト ギャラリーと作業項目が表示されます。

プロジェクト画面

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

プロジェクト変数の表示

次の変数は、ユーザーがマイルストーンでプロジェクトを表示するときに使用されます。

変数名	説明
locAddProject	conAddProject コンテナーの表示/非表示をコントロールするローカル変数。
gblProject	選択したプロジェクトを格納するグローバル変数。
locProjectSortOrder	プロジェクトの一覧の並べ替え順序をコントロールするローカル変数。
locExpandProjectList	プロジェクトリストの表示/非表示 (展開と折りたたみ) をコントロールするために使用されるローカル変数。

プロジェクト実行の詳細の表示

プロジェクトは、以下で説明するように、さまざまなコンテナーにあるアプリのさまざまな画面に表示されます:
プロジェクト画面の conProjectList
バージョン情報画面の conProjectList_About
設定画面の conProjectList_Settings
プロジェクトテーブルからプロジェクトを一覧表示するギャラリーは次のとおりです:
- プロジェクト画面の galProjects
- バージョン情報画面の galProjects_About
- 設定画面の galProjects_Settings
プロジェクトを選択すると、変数 gblProject を選択したプロジェクトに設定し、選択したプロジェクトの作業項目を colWorkItems コレクションに集めます。
上記の画面のいずれかで [+ 新規プロジェクト] ボタンを選択すると、locAddProject 変数を true に、locShowProjectTeamAssignment 変数 (この変数の使用方法については、「新しいプロジェクトの作成」セクションを参照してください) を false に更新して、新しいプロジェクト作成画面を表示します。
[プロジェクトの検索] テキストボックスは、名前に入力したテキストを含むプロジェクトを検索するために使用します。
並べ替えアイコンを選択すると、プロジェクト名に基づいてプロジェクトの一覧を並べ替えるために使用される locProjectSortOrder を更新します。アイコンを選択すると、並べ替え順序を昇順から降順に、またはその逆に切り替えます。
メニューアイコンを選択すると、locExpandProjectList 変数を値 true から false に、またはその逆に切り替えて更新します。これにより、プロジェクトリストセクションが展開および折りたたまれます。

プロジェクトカバーの表示と更新

このセクションでは、プロジェクトのカバー画像を表示または更新するときに使用される変数と実行の詳細について説明します。

プロジェクトカバーの更新変数

次の変数は、ユーザーがプロジェクトのカバー画像を表示または更新するときに使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locVisibleCoverSelection	プロジェクトカバーコンテナーの表示/非表示をコントロールするために使用されるローカル変数。
locCoverImageSelected	カバー画像が選択されているかどうかを確認するローカル変数。
locCoverColorSelected	カバーの色が選択されているかどうかを確認するローカル変数。
locCoverChanged	プロジェクトカバーが変更されたかどうかを確認するローカル変数。
locCustomImageSelected	ユーザー定義の画像がプロジェクトカバーに対して変更されたかどうかを確認するローカル変数。

プロジェクトカバー更新の実行の詳細

プロジェクトカバーは、選択したプロジェクト名、カバー画像 (ある場合)、カバーの色 (カバー画像がない場合) を表示する conProjectHeader コンテナーの一部で、gblProject 変数を使用して取得します。
ギャラリー galProjectColors を選択すると、Microsoft Teams テーマに基づいた色の一覧をユーザーに提示します。これは、Teams のテーマに基づいた colProjectCoverColors コレクションをフィルターすることで実現します。
選択したプロジェクトに色が定義されている場合、その色はチェックマーク (imgColorSelected) で示されます。このアイコンの表示/非表示は ThisItem.IsSelected に設定されています。 galProjectColors (以下で説明) の Default プロパティのため、選択したプロジェクトのカバーの色が既定で選択されています。
ギャラリー galProjectColors の Default プロパティを使用して、gblProject のカバーの色を選択します。次のように設定されます:
1. Teams のテーマがダークの場合、gblProject の Cover Color Dark が検索されます。これが空白の場合、プロジェクトのカバーの色がないことを意味します。
2. Teams のテーマがダークでない場合、gblProject の Cover Color が検索されます。これが空白の場合、プロジェクトのカバーの色がないことを意味します。
カラーを選択すると、ocCoverImageSelected を false、locCoverColorSelected を true、locCoverChanged を true に設定します。
ギャラリー galProjectCovers は、ストックプロジェクトのカバー画像の一覧を表示します。また、ユーザーは画像の追加コントロール (ddProjectCoverImage) を使用して、ユーザー定義の画像をアップロードすることもできます。
ユーザー定義の画像を選択すると、locCoverChanged を true に、locCustomImageSelected を true に設定します。
ストック画像を選択すると、locCoverImageSelected を true、locCoverColorSelected を false、locCoverChanged を true、locCustomImageSelected を true に設定します。
選択したプロジェクトのカバーとしてストック画像の 1 つがある場合、そのストック画像は btnProjectCoverBackground の塗りつぶしの色を設定することで強調表示されます。
[完了] を選択すると、プロジェクトのカバーを次のように更新します:
- locCoverImageSelected が true で、locCustomImageSelected も true の場合、ユーザーがユーザー定義の画像を選択したことになります。そのため、Cover Photo はアップロードされた画像で更新され、Cover Icon、 Cover Color、Cover Color Dark はすべて空白に設定されます。
- locCoverImageSelected が true で、locCustomImageSelected が false の場合、ユーザーがストック画像を選択したことになります。そのため、Cover Icon はストック画像で更新され、Cover Photo、 Cover Color、Cover Color Dark はすべて空白に設定されます。
- locCoverColorSelected が trueの場合、ユーザーがカバーの色を選択したことになります。そのため、 Cover Photo と Cover Icon はどちらも空白に設定されます。 Cover Color と Cover Color Dark は、次のロジックに従って更新されます:
  1. 現在の Teams テーマがダークの場合、galProjectColors から選択した色は Cover Color Dark に設定されます。現在の Teams テーマがダークでない場合は、galProjectColors から選択した色を使用して、対応するダークモードの色を colProjectCoverColors で検索し、この色を Cover Color Dark として設定します。これは、Teams のテーマがダークでない場合、galProjectColors が既定のテーマ色で設定されるためです。
  2. 現在の Teams テーマがダークでない場合、galProjectColors から選択した色は Cover Color に設定されます。現在の Teams テーマがダークの場合、galProjectColors から選択した色を使用して、対応する既定のモード色を colProjectCoverColors で検索し、この色を Cover Color として設定します。これは、Teams のテーマがダークの場合、galProjectColors がダークテーマ色で設定されるためです。

マイルストーン/チーム状態の表示

このセクションでは、マイルストーンと状態データを表示するときに使用されるコレクション、変数、および実行の詳細について説明します

マイルストーンの表示コレクション

次のコレクションは、マイルストーンを表示するときに使用されます。

コレクション名	説明
colWorkItemStatuses	- 作業項目の状態のコレクション。

マイルストーン表示変数

次の変数は、マイルストーンを表示するときに使用されます。

変数名	説明
locShowProjectStatusOptions	プロジェクトの状態オプションギャラリーの表示/非表示をコントロールするために使用します。
locProjectStatusSelection	ユーザーが何を選択したかを確認するローカル変数。
locCompletionStatus	作業項目の完了に関連する状態を格納するローカル変数。

マイルストーン表示の実行の詳細

次の 4 つのプロジェクトの状態オプションを使用できます:
チームメンバーの一覧と、その状態に基づいて割り当てられた作業項目の数を示すチームの状態。
マイルストーンの一覧と、その状態に基づいて関連付けられた作業項目の数を示すマイルストーンの状態。
galMilestones ギャラリーの items プロパティが、選択したプロジェクト gblProject のマイルストーンに設定されます。
アプリには、さまざまなマイルストーンの完了率を示すために使用される 13 種類の画像があります (0、10、20、30、40、50、60、70、80、90、95、99、100)。完了状態 (colWorkItemStatuses の最初の状態で、プロジェクト画面の OnVisible にある locCompletionStatus に格納) のマイルストーンの作業項目数を、そのマイルストーンの作業項目総数で割って算出される完了率に基づいて、適切な画像が表示されます。
マイルストーン名の下の 4 つのラベルには、colWorkItemStatuses から最初の 4 つの状態の作業項目数が表示されます。
galTeamMembers ギャラリーの items プロパティが、選択したプロジェクト gblProject のプロジェクトチームメンバーに設定されます。
各チームメンバーのユーザー写真は、Office365Users.UserPhotoV2 関数を使用して表示されます。写真がない場合は、既定で人物アイコンが表示されます。
オプションラベルの横にある下矢印ボタンを使用して、チームの状態オプションとマイルストーンの状態オプションを切り替えます。矢印を選択すると、locShowProjectStatusOptions 変数の値を更新して、値を true から false に、またはその逆に切り替え、galProjectStatusOptions ギャラリーの表示/非表示をコントロールします。

作業項目の一覧の表示

このセクションでは、作業項目の表示に使用されるコレクション、変数、実行の詳細について説明します。

作業項目の表示コレクション

これらの以下のコレクションは、作業項目を表示するときに使用されます。

コレクション名	説明
colWorkItems	選択したプロジェクトに対するすべての作業項目のコレクション。
colCharsWidth	自動の幅ラベルに使用される各文字の幅のコレクション。

作業項目の表示変数

次の変数は、作業項目を表示するときに使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locSortWorkItemBy	列による並べ替えを定義するローカル変数。
locWorkItemSortOrder	並べ替え順を定義するローカル変数。
locShowSearchWorkItem	作業項目検索ボックスの表示/非表示をコントロールするローカル変数。
locFilterWorkItems	作業項目フィルターダイアログの表示/非表示をコントロールするローカル変数。
locApplyFilter	選択したフィルターを作業項目に適用するかどうかを制御するローカル変数。
locBackNavigation	バージョン情報画面または設定画面から戻って、プロジェクト画面に移動した場合にキャプチャするローカル変数。

作業項目表示の実行の詳細

プロジェクトギャラリーでプロジェクトを選択すると、2 つの処理が行われます (これらは、galProjects の OnSelect で定義されています):
- まず、選択したプロジェクトが gblProject に格納されます。
- 次に、このプロジェクトを参照するすべてのプロジェクト作業項目がコレクション colWorkItems に追加されます。
上記の手順は、プロジェクト画面の OnVisible でも実行されるため、ユーザーが初めてプロジェクト画面に移動したときに、galProjects の最初のプロジェクトの作業項目の一覧が、プロジェクトで選択する必要なく表示されます。バージョン情報画面または設定画面から戻ってプロジェクト画面に移動しても、作業項目の読み込みは行われません。これは、locBackNavigation によって制御されます。
列による既定の並べ替え (locSortWorkItemBy) は eta (ターゲット) に設定され、既定の並べ替え順序 (locWorkItemSortOrder) は true (つまり、昇順) に設定されます。これらは、プロジェクト画面 の OnVisible プロパティで設定されます。
作業項目ギャラリー (galWorkItems) のヘッダーには、7 つのボタン – 作業項目、マイルストーン、カテゴリ、優先度、割り当て先、ターゲット、状態 - があります。これらのいずれかを選択すると、locSortWorkItemBy 変数を更新して、列による適切な並べ替えを定義し、また locWorkItemSortOrder を更新することで、並べ替え順を昇順から降順、またはその逆に切り替えます。
並べ替え順は下向き矢印の画像 (imgSortWorkItem) で示されます。列による並べ替えに基づいて、その X 位置が変化します。これにより、ヘッダーごとに 1 つの画像を使用できなくなります。並べ替え順に基づいて、ImageRotation プロパティが変更されます。これにより、1 つの画像を昇順に、1 つを降順に使用できなくなります。
作業項目ギャラリー内のヘッダーとそれに関連するラベルは、コンテナー幅の幅に基づいて表示されます。たとえば、状態ヘッダーの表示/非表示 (btnStatusSort) は (Projects Screen.Size = ScreenSize.ExtraLarge || Projects Screen.Size = ScreenSize.Large) && Self.Width > 75 です
作業項目ギャラリー内のマイルストーン、カテゴリ、優先度、状態のラベルの幅は、それぞれのテキストに基づいてこれらのラベルの幅を変更できる式に設定されています。
imgWorkItemAssignedTo には、作業項目が割り当てられているチームメンバーの画像を示し、imgWorkItemAssignedToDefault には、作業項目が割り当てられているチームメンバーに画像がない場合の既定の画像を表示します
検索アイコンを選択すると、locShowSearchWorkItem を true に設定します。これにより、検索ボックスと X アイコンが表示されます。検索ボックスに入力すると、名前フィールドを使用して colWorkItems を検索します。 X アイコンを選択すると、locShowSearchWorkItem を falseに設定し、検索ボックスを非表示にします。
フィルターアイコンを選択すると、locFilterWorkItems を true に設定してフィルターダイアログを表示し、locApplyFilter を設定して、ユーザーが確認するまでフィルターを適用しないようにフィルターします。
conFilterWorkItems は、作業項目のギャラリーをフィルター処理するために使用されるすべてのコントロールを持つコンテナーです。マイルストーン、カテゴリ、優先度、チームメンバー、状態にそれぞれ 1 つずつ、合計 5 つのコンボボックスがあります。それらはすべて複数選択です。値を選択した後、適用を選択すると、locApplyFilter を true に設定し、作業項目ギャラリーをフィルターします。

作業項目の削除

このセクションでは、作業指示書の削除に使用されるコレクション、変数、実行の詳細について説明します。

作業項目の削除コレクション

以下のコレクションは、作業項目の削除時に使用されます。

コレクション名	説明
colWorkItems	選択したプロジェクトに対するすべての作業項目のコレクション。
colRemoveWorkItems	削除する作業項目のコレクション。

作業項目の削除変数

次の変数は、変数を削除するときに使用されます。

変数名	説明
locDeleteWorkItems	作業項目削除ダイアログの表示/非表示をコントロールするローカル変数。
locResetWorkItemCheckbox	削除対象の作業項目を選択するためのチェックボックスをリセットするローカル変数。

作業項目の実行の詳細の削除

作業項目ギャラリーヘッダーのチェックボックスを選択すると、ギャラリー内のすべての作業項目のチェックボックスが選択されます。これを制御するには、ギャラリー内のチェックボックスの既定値を chkSelectAllWorkItems.Value に設定します。
ギャラリー内のチェックボックスの Reset プロパティを locResetWorkItemCheckbox に設定します。この変数は、ユーザーが削除のキャンセルを決定したとき、またはユーザーがプロジェクトギャラリーからプロジェクトを選択したときに、チェックボックスをオフにするために使用されます。
削除アイコンは、少なくとも 1 つの作業項目が選択されるまで無効のままです。有効にして、削除アイコンを選択すると、locDeleteWorkItems を true に設定して、作業項目の削除ダイアログを表示します。
削除ダイアログで 分かりました チェックボックスを選択すると、削除ボタンが有効になります。削除ボタンは、最初に、チェックボックスがチェックされているギャラリーからすべてのアイテムを、コレクション colRemoveWorkItems に集めます。次に、colRemoveWorkItems を使用して、選択したすべての作業項目を削除します。そして最後に、colWorkItems には、選択したプロジェクト (gblProject) に関連する作業項目の一覧が再度入力されます。

作業項目の編集

このセクションでは、作業項目の編集時に使用されるコレクション、変数、実行の詳細について説明します。

作業項目の編集コレクション

以下のコレクションは、作業項目の編集時に使用されます。

コレクション名	説明
colWorkItems	選択したプロジェクトに対するすべての作業項目のコレクション。
colWorkItemStatuses	作業項目の状態のコレクション。

作業項目の編集変数

次の変数は、作業項目の編集時に使用されます。

変数名	説明
locEditWorkItem	conEditWorkItem コンテナーの表示/非表示をコントロールするために使用されるローカル変数。
locSelectedWorkItem	選択された作業項目を格納するローカル変数。
locNewWorkItem	更新された作業項目を示すローカル変数。

作業項目編集実行の詳細

作業項目のギャラリー (galWorkItems) で作業項目を選択すると、conEditWorkItem コンテナーが表示され、Visible プロパティは locEditWorkItem 変数によって制御されます。
[完了] ボタンを選択すると、選択した作業項目 locSelectedWorkItem の詳細を更新します。更新された作業項目は locNewWorkItem に格納されます。 gblProject の作業項目は、colWorkItems で再び収集されます。
1 つ以上の作業項目フィールドが更新されると、レコードがその更新内容を記録するためにプロジェクト活動テーブルに作成されます。

新規プロジェクトの作成

このセクションでは、新規プロジェクトの作成時に使用されるコレクション、変数、実行の詳細について説明します。

プロジェクト作成コレクション

以下のコレクションは、プロジェクトの作成時に使用されます。

コレクション名	説明
colNewProjectMilestones	新規プロジェクトに対するマイルストーンのコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。
colNewProjectTeamMembers	作成するプロジェクトのチームメンバーのコレクション

プロジェクト作成変数

以下の変数は、プロジェクトの作成時に使用されます。

変数名	説明
locAddProject	- conAddProject コンテナーの表示/非表示をコントロールするローカル変数。
locMilestoneColorPicker	- galMilestoneColorPicker の表示/非表示をコントロールするローカル変数。
locShowProjectTeamAssignment	- プロジェクトチーム割り当てコントローラーの表示/非表示をコントロールするローカル変数 ([次へを選択] した後に表示)。
locShowUsersGallery	- ユーザーギャラリー galAddTeamMembers の表示/非表示をコントロールするローカル変数。
galAddTeamMembers	- 選択したユーザーの名前を格納するローカル変数。
locNewProject	- 新しく作成されたプロジェクトを格納するローカル変数。

プロジェクト作成の実行の詳細

新規プロジェクトを作成するには、conProjectList コンテナーで [+ 新規プロジェクト] ボタンを選択します。
+ 新規プロジェクト ボタンを選択すると、locAddProject を true に設定し、conAddProject コンテナーを表示します。また、既定で 3 つのマイルストーンを colNewProjectMilestones に追加し、現在のユーザーをチームメンバーとして colNewProjectTeamMembers に追加します。
ギャラリー galAddMilestones には、colNewProjectMilestones を使用してマイルストーンの一覧を表示します。
色のボタン (btnMilestoneColor) を選択すると、locMilestoneColorPicker を true に設定し、カバーの色 (colProjectCoverColors) の一覧を含む galMilestoneColorPicker ギャラリーを表示します。
目的の色を選択すると、マイルストーンの色を更新し、locMilestoneColorPicker 値を false に設定します。
閉じるボタンを選択すると、locMilestoneColorPicker を false に設定し、galMilestoneColorPicker ギャラリーを非表示にします。
次にごみ箱のアイコンを選択すると、マイルストーンを colNewProjectMilestones から削除します。
[+ マイルストーンの追加] を選択すると、新しいマイルストーンを作成して colNewProjectMilestones に追加し、galAddMilestones ギャラリーをリセットします。コントロールがリセットされ、ギャラリーが新しく追加されたマイルストーンまでスクロールダウンします (galAddMilestones の Default プロパティは、この動作を実現するのに役立ちます)。
閉じるボタンセットを選択すると、locShowProjectTeamAssignment と locAddProject を false に設定して、conAddProject コンテナーを非表示にします。
必要な詳細を入力したら、[次へ] ボタンを選択して、locShowProjectTeamAssignment を true に、locAddProject を false に設定し、チームメンバーの割り当てセクションを表示します。
検索ボックスを使用して、チームメンバーを検索できます。入力が行われるとすぐに、locShowUsersGallery の値が false に設定され、ユーザーギャラリーが非表示になり、入力に基づいて結果が表示されます。
新規ユーザーを選択すると、locUserPrincipalName を更新し、選択したユーザーを colNewProjectTeamMembers に追加します。
削除アイコンを選択すると、ユーザーを colNewProjectTeamMembers から削除します。
戻るボタンを選択すると、locShowProjectTeamAssignment を false に設定し、ユーザー割り当てフィールドを非表示にします。
作成ボタンを選択すると、locShowProjectTeamAssignment を true に、locAddProject を false に設定します。また、新規プロジェクトレコードと、関連するプロジェクトマイルストーンおよびプロジェクトチームメンバーレコードも作成します。

新規作業項目の作成

このセクションでは、新規作業項目の作成時に使用されるコレクション、変数、実行の詳細について説明します。

作業項目作成コレクション

以下のコレクションは、作業項目の作成時に使用されます。

コレクション名	説明
colWorkItems	選択したプロジェクトに対するすべての作業項目のコレクション。

作業項目の作成変数

次の変数は、作業項目の作成時に使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locAddWorkItem	conAddProject コンテナーの表示/非表示をコントロールするローカル変数。
locNewWorkItem	新しく作成された作業項目を格納するローカル変数。

作業項目作成の実行の詳細

+ 新規作業 項目ボタンを選択すると、locAddWorkItem を true に設定し、conAddWorkItem コンテナーを表示します。
すべての詳細を入力したら、作成ボタンを選択して、新規作業項目を作成し、locAddWorkItem を false に設定して、conAddWorkItem コンテナーを非表示にします。
新しく作成された作業項目は、locNewWorkItem に格納され、colWorkItems に追加されます。
作業項目の作成をログに記録するために、新しい更新も自動的に作成されます。

バージョン情報画面

このセクションでは、バージョン情報画面でプロセスが使用するコレクションと実行の詳細について説明します

詳しいステップ

conNavigtion_About コンテナーの戻るボタンを選択すると、プロジェクト画面に戻ります。
conHeader_About コンテナーの Power Apps ボタンを使用してカスタマイズを選択すると、Microsoft Teams の Power Apps ツールリンクが開きます。
galAbout_HelpLinks ギャラリーで利用可能なヘルプリンクがあります。
[このアプリをカスタマイズする方法] ボタンを選択すると、アプリ上でカスタマイズを行う方法を説明する外部リンクに移動します。
[アイデアを送信] ボタンを選択すると、マイルストーンアプリのアイデアを投稿できる外部リンクに移動します。
[コミュニティとの連携] ボタンを選択すると Power Apps コミュニティに移動します。
conAbout_AppVideo コンテナーには、マイルストーンアプリの概要を提供するビデオのリンクが含まれています。
ギャラリー galAbout_OtherApps には、他の Microsoft アプリへのリンクが含まれています。
[アプリの表示] ボタンを選択すると、Microsoft Teams アプリストアのアプリページに移動します。
[アプリの概要] ボタンを選択すると、YouTube 上のアプリの概要ビデオに移動します。
conAbout_Version は、アプリバージョンに関する情報を提供します。

プロジェクト設定画面

このセクションでは設定画面でプロセスが使用するコレクション、変数、実行の詳細について説明します。

プロジェクトに対するマイルストーンの一覧を表示

このセクションでは、マイルストーンの表示時に使用されるコレクション、変数、および実行の詳細について説明します。

マイルストーンの表示コレクション

以下のコレクションは、設定画面にマイルストーンを表示するときに使用されます。

コレクション名	説明
colProjectMilestones	選択したプロジェクトに対するすべてのマイルストーンのコレクション。

マイルストーン表示変数

以下の変数は、設定画面にマイルストーンを表示するときに使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locDefaultProjectMilestone	マイルストーンギャラリーのリセットに使用される既定のマイルストーンを格納するローカル変数。

マイルストーン表示の実行の詳細

プロジェクト画面で選択したプロジェクト (gblProject) のマイルストーンは、設定画面の OnVisible にある colProjectMilestones に追加されます。
colProjectMilestones からの最初のマイルストーンは、locDefaultProjectMilestone に格納されるため、既定で選択されるマイルストーンです。
galProjects_Settings で他のプロジェクトを選択すると、選択したプロジェクトを gblProject に格納します。次に、このプロジェクトを参照するすべてのマイルストーンが colProjectMilestones に追加されます。

マイルストーンの編集

このセクションでは、マイルストーンの編集時に使用されるコレクション、変数、および実行の詳細について説明します。

マイルストーン編集コレクション

以下のコレクションは、設定画面からマイルストーンを編集するときに使用されます。

コレクション名	説明
colProjectMilestones	選択したプロジェクトに対するすべてのマイルストーンのコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。

マイルストーン編集変数

以下の変数は、設定画面からマイルストーンを編集するときに使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locEditMilestoneColorPicker	カラーピッカーの表示/非表示をコントロールするローカル変数。
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。

マイルストーン編集の実行の詳細

色を選択すると、locEditMilestoneColorPicker を true し、カラーピッカーギャラリー galEditProjectMilestoneColorPicker を表示します。
galEditProjectMilestoneColorPicker のDefault プロパティは、現在の Teams のテーマに基づいてマイルストーンの色に設定されます。これにより、表示/非表示が ThisItem.IsSelected に設定されているため、チェックマークアイコンが現在のマイルストーンの色で表示されます。
galEditProjectMilestoneColorPicker を選択すると、locEditMilestoneColorPicker を false に、locSettingsChanged を true に設定します。
保存ボタンを選択すると、設定画面のすべての変更を保存します。具体的には、マイルストーンの場合、既存のマイルストーンは、ID フィールドが空白でない (つまり、プロジェクトマイルストーン テーブルに既存のレコードがある) という条件に基づいてフィルター処理され、Patch ステートメントを使用して更新されます。
マイルストーンの色の更新は、次の方法で行われます:
1. 現在の Teams テーマがダークの場合、ダークモードの色がユーザーに表示されます。そのため、Color 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当する既定モードを見つけることで更新されます。 Color Dark 列は、ユーザーが選択した色で更新されます。
2. 現在の Teams テーマが既定の場合、既定モードの色がユーザーに表示されます。そのため、Color 列は、ユーザーが選択した色で更新されます。 Color Dark 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当するダークモードを見つけることで更新されます。

マイルストーンの追加

このセクションでは、マイルストーンの追加時に使用されるコレクション、変数、および実行の詳細について説明します。

マイルストーン作成コレクション

以下のコレクションは、設定画面からマイルストーンを追加するときに使用されます。

コレクション名	説明
colProjectMilestones	選択したプロジェクトに対するすべてのマイルストーンのコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。

マイルストーン作成変数

以下の変数は、設定画面からマイルストーンを追加するときに使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locDefaultProjectMilestone	マイルストーンギャラリーのリセットに使用される既定のマイルストーンを格納するローカル変数。

マイルストーン作成の実行の詳細

+ 新規マイルストーン ボタンを選択すると、新規マイルストーンを colProjectMilestones に追加します。また、この新規マイルストーンで locDefaultProjectMilestone を更新します。 Reset 関数が galEditMilestones に呼び出され、最も最近追加されたマイルストーンまでスクロールします。
保存ボタンを選択すると、設定画面のすべての変更を保存します。具体的には、マイルストーンの場合、新規のマイルストーンは、ID フィールドが空白である (つまり、プロジェクトマイルストーンテーブルに存在しない) という条件に基づいてフィルター処理され、Patch ステートメントを使用して作成されます。
新しいマイルストーンの色は、次の方法で設定されます:
- 現在の Microsoft Teams テーマがダークの場合、ダークモードの色がユーザーに表示されます。そのため、Color 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当する既定モードを見つけることで更新されます。 Color Dark 列は、ユーザーが選択した色で更新されます。
- 現在の Microsoft Teams テーマが既定の場合、既定モードの色がユーザーに表示されます。そのため、Color 列は、ユーザーが選択した色で更新されます。 Color Dark 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当するダークモードを見つけることで更新されます。

マイルストーンの削除

このセクションでは、マイルストーンの削除時に使用されるコレクション、変数、および実行の詳細について説明します。

マイルストーンコレクションの削除

以下のコレクションは、マイルストーンの削除時に使用されます。

コレクション名	説明
colProjectMilestones	選択したプロジェクトに対するすべてのマイルストーンのコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。
colRemovedMiletones	マイルストーンに関する削除アイコンを選択したときのマイルストーンのコレクション。

マイルストーン変数の削除

以下の変数は、マイルストーンの削除時に使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locDeleteSettings	マイルストーン削除ダイアログの表示/非表示をコントロールするローカル変数。
locSettingType	設定の種類を定義するローカル変数。

マイルストーン実行詳細の削除

削除アイコンを選択すると、locDeleteSettings を true に設定し、削除マイルストーンダイアログを表示して、削除する必要のあるマイルストーンを colRemovedMiletones に追加します。
削除ダイアログで 分かりました チェックボックスをチェックすると、削除ボタンが有効になります。削除ボタンは、選択したマイルストーンを colProjectMilestones から削除し、選択したマイルストーンに ID がある (つまり、プロジェクトマイルストーンテーブルに既存のレコードがある) 場合、選択したマイルストーンを プロジェクト マイルストーン テーブルから削除します。

チームメンバーの管理

このセクションでは、チームメンバーが追加、編集、または削除されたときのコレクション、変数、および実行の詳細について説明します。

チームメンバーコレクションの管理

次のコレクションは、チームメンバーが追加、編集、または削除されるときに使用されます。

コレクション名	説明
colWorkItems	選択したプロジェクトに対するすべての作業項目のコレクション。

チームメンバー変数の管理

次の変数は、チームメンバーが追加、編集、または削除されるときに使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locDeleteProject	削除警告画面の表示/非表示をコントロールするローカル変数。
locProjectToDelete	削除するプロジェクトを格納するローカル変数。
locTempNewSelectedProject	現在のプロジェクトが削除された後に選択される新しいプロジェクトを一時的に格納するローカル変数。

チームメンバーの実行詳細の管理

[プロジェクトの削除] ボタンを選択すると、locDeleteProject を true に設定し、conWarning_Project コンテナーを表示します。
分かりました チェックボックスをチェックすると、削除ボタンが有効になります。
キャンセル を選択すると、locDeleteProject を false に設定して、警告ダイアログを閉じます。
削除を選択すると、次のアクションが発生します:
- 削除するプロジェクトは、最初に locProjectToDelete に格納されます。
- 削除するプロジェクトを除くプロジェクトの一覧の最初のプロジェクトは、locTempNewSelectedProject に格納され、gblProject の更新に使用されます。
- gblProject が更新されると、作業項目は colWorkItems に収集されます。
- locProjectToDelete に格納されているプロジェクトは、次に、マイルストーン、作業項目、活動、チームメンバーなど、関連するすべてのレコードを削除するために使用されます。
- 関連するすべてのレコードが削除されると、プロジェクト自体が削除されます。

プロジェクトの削除

このセクションでは、プロジェクトの削除時に使用されるコレクション、変数、実行の詳細について説明します。

プロジェクトの削除コレクション

以下のコレクションは、プロジェクトの削除時に使用されます。

コレクション名	説明
colProjectTeamMembers	すべてのプロジェクトチームメンバーのコレクション。
colRemovedProjectTeamMembers	削除するチームメンバーのコレクション。

プロジェクトの削除変数

以下の変数は、プロジェクトの削除時に使用されます。

変数名	説明
gblProject	選択したプロジェクトを格納するグローバル変数。
locShowProjectTeamAssignment	プロジェクトチーム割り当てコントローラーの表示/非表示をコントロールするローカル変数 ([次へ] を選択すると表示)。
locShowUsersGallery	ユーザーギャラリー galAddTeamMembers の表示/非表示をコントロールするローカル変数。
galAddTeamMembers	選択したユーザーの名前を格納するローカル変数。

プロジェクト削除の実行の詳細

プロジェクト画面 で選択したプロジェクト (gblProject) のチームメンバーは、設定画面の OnVisible にある colProjectTeamMembers に追加されます。
galProjects_Settings で他のプロジェクトを選択すると、選択したプロジェクトを gblProject に格納します。次に、このプロジェクトを参照するすべてのマイルストーンが colProjectTeamMembers に追加されます。
検索テキストを入力すると、locShowUsersGallery を false に設定し、ユーザーギャラリーが非表示になり、指定された入力に基づいて結果を表示します。
ユーザーを選択すると、locUserPrincipalName を更新し、選択したユーザーを colProjectTeamMembers に追加します。
削除アイコンを選択すると、チームメンバーに ID がある (つまり、既存のレコードである) 場合、チームメンバーを colRemovedProjectTeamMembers に追加し、colProjectTeamMembers から削除します。
保存を選択すると、colRemovedProjectTeamMembers にあるすべてのレコードを プロジェクトチームメンバー テーブルから削除します。 colProjectTeamMembers の ID が空白のすべてのレコードは、プロジェクトチームメンバーテーブルに新しいレコードとして作成され、選択したプロジェクト gblProject に関連付けられます。

設定画面

このセクションでは、設定画面でプロセスが使用するコレクション、変数、実行の詳細について説明します

カテゴリの表示と編集

このセクションでは、カテゴリを表示または編集するときに使用されるコレクション、変数、および実行の詳細について説明します。

カテゴリ編集コレクション

次のコレクションは、カテゴリを表示または編集するときに使用されます。

コレクション名	説明
colCategories	カテゴリのコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。

カテゴリ編集変数

次の変数は、カテゴリを表示または編集するときに使用されます。

変数名	説明
locCategoryColorPicker	色を編集するときにカラーピッカーを表示および非表示にするために使用されるローカル変数。
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。

カテゴリ編集の実行の詳細

色を選択すると、locCategoryColorPicker を true に設定し、カラーピッカーギャラリー galCategoryColorPicker を表示します。
galCategoryColorPicker の Default プロパティは、現在の Teams のテーマに基づいてカテゴリの色に設定されます。これにより、表示/非表示が ThisItem.IsSelected に設定されているため、チェックマークアイコンが現在のカテゴリの色で表示されます。
galCategoryColorPicker を選択すると、locCategoryColorPicker を false に、locSettingsChanged を true に設定します。
[保存] ボタンを選択すると、設定画面のすべての変更を保存します。具体的には、カテゴリの場合、既存のカテゴリは、ID フィールドが空白でない (つまり、既存のカテゴリがある) という条件に基づいてフィルター処理され、Patch ステートメントを使用して更新されます。
カテゴリの色の更新は、次の方法で行われます:
1. 現在の Teams テーマがダークの場合、ダークモードの色がユーザーに表示されます。そのため、Color 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当する既定モードを見つけることで更新されます。 Color Dark 列は、ユーザーが選択した色で更新されます。
2. 現在の Teams テーマが既定の場合、既定モードの色がユーザーに表示されます。そのため、Color 列は、ユーザーが選択した色で更新されます。 Color Dark 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当するダークモードを見つけることで更新されます。

カテゴリの追加

このセクションでは、設定画面からカテゴリを追加するときに使用されるコレクション、変数、および実行の詳細について説明します。

カテゴリ作成コレクション

以下のコレクションは、カテゴリの作成時に使用されます。

コレクション名	説明
colCategories	カテゴリのコレクション。

カテゴリ作成の実行の詳細

[追加] を選択すると、新しいカテゴリを colCategories に追加し、locSettingsChanged を true に設定して、設定画面で更新が行われたことを示し、保存ボタンを有効にします。
ギャラリー galCategories は、Reset 関数を使用してリセットされ、ギャラリーを新しく追加されたカテゴリまでスクロールします。
[保存] ボタンを選択すると、colCategories 内の ID が空白のすべてのレコードに対して、プロジェクト作業項目カテゴリテーブルに新しいレコードを作成します。

カテゴリの削除

このセクションでは、設定画面からカテゴリを削除するときに使用されるコレクション、変数、および実行の詳細について説明します。

カテゴリの削除コレクション

以下のコレクションは、カテゴリの削除時に使用されます。

コレクション名	説明
colCategories	カテゴリのコレクション。
colRemovedCategories	削除するカテゴリのコレクション。

カテゴリの削除変数

次の変数は、カテゴリを削除するときに使用されます。

変数名	説明
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。
locDeleteSettings	削除警告画面の表示/非表示をコントロールするローカル変数。
locSettingType	削除するレコードを決定するローカル変数。

カテゴリ削除の実行の詳細

削除アイコンを選択すると、選択した優先度レコードを colRemovedCategories に追加し、locDeleteSettings を true に更新して、conWarning_Settings コンテナーを表示します。
[分かりました] チェックボックスをチェックすると、[削除] ボタンが有効になります。
[キャンセル] を選択すると、locDeleteSettings を false に設定して、警告ダイアログを閉じます。
[削除] を選択すると、選択したカテゴリを colCategories から、また、ID がある (つまり、既存のカテゴリである) 場合は、プロジェクト作業項目カテゴリテーブルから削除します。

優先度の表示と編集

このセクションでは、優先度を表示または編集するときに使用されるコレクション、変数、および実行の詳細について説明します。

優先度のコレクション

次のコレクションは、優先度を表示または編集するときに使用されます。

コレクション名	説明
colPriorities	優先度のコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。

優先度変数

次の変数は、優先度を表示または編集するときに使用されます。

変数名	説明
locPriorityColorPicker	色を編集するときにカラーピッカーを表示および非表示にするために使用されるローカル変数。
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。

優先実行の詳細

色を選択すると、locPriorityColorPicker を true に設定し、カラーピッカーギャラリー galPriorityColorPicker を表示します。
galPriorityColorPicker の Default プロパティは、現在の Teams のテーマに基づいて優先度の色に設定されます。これにより、表示/非表示が ThisItem.IsSelected に設定されているため、チェックマークアイコンが現在の優先度の色で表示されます。
galPriorityColorPicker を選択すると、locPriorityColorPicker を false に、locSettingsChanged を true に設定します。
保存ボタンを選択すると、設定画面のすべての変更を保存します。具体的には、優先度の場合、既存の優先度は、ID フィールドが空白でない (つまり、既存の優先度がある) という条件に基づいてフィルター処理され、Patch ステートメントを使用して更新されます。
優先度の色の更新は、次の方法で行われます:
1. 現在の Teams テーマがダークの場合、ダークモードの色がユーザーに表示されます。そのため、Color 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当する既定モードを見つけることで更新されます。 Color Dark 列は、ユーザーが選択した色で更新されます。
2. 現在の Teams テーマが既定の場合、既定モードの色がユーザーに表示されます。そのため、Color 列は、ユーザーが選択した色で更新されます。 Color Dark 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当するダークモードを見つけることで更新されます。

優先度の追加

このセクションでは、優先度の追加時に使用されるコレクション、変数、実行の詳細について説明します。

優先度コレクションの追加

以下のコレクションは、優先度の追加時に使用されます。

コレクション名	説明
colPriorities	優先度のコレクション。

優先度変数の追加

以下の変数は、優先度の追加時に使用されます。

変数名	説明
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。
locGlobalSetting	更新されたグローバル設定を格納するローカル変数。
locGalleryDefaultPriority	galPriorities ギャラリーで既定の優先度の値を設定するために使用されるローカル変数。

優先度の実行の詳細の追加

追加を選択すると、新しい優先度を colPriorities に追加し、locSettingsChanged を true に設定して、設定画面で更新が行われたことを示し、保存ボタンを有効にします。
ギャラリー galPriorities は、Reset 関数を使用してリセットされ、ギャラリーを新しく追加された優先度までスクロールします。
保存ボタンを選択すると、colPriorities 内の ID が空白のすべてのレコードに対して、プロジェクト作業項目の優先度テーブルに新しいレコードを作成します。

優先度の削除

このセクションでは、優先度の削除時に使用されるコレクション、変数、実行の詳細について説明します。

優先度の削除コレクション

以下のコレクションは、優先度の削除時に使用されます。

コレクション名	説明
colPriorities	- 優先度のコレクション。
colRemovedPriorities	- 削除する優先度のコレクション。

優先度の削除変数

以下の変数は、優先度の削除時に使用されます。

変数名	説明
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。
locDeleteSettings	削除警告画面の表示/非表示をコントロールするローカル変数。
locSettingType	削除するレコードを決定するローカル変数。

優先度削除の実行の詳細

削除アイコンを選択すると、選択した優先度レコードを colRemovedPriorities に追加し、locDeleteSettings を true に更新して、conWarning_Settings コンテナーを表示します。
分かりました チェックボックスをチェックすると、[削除] ボタンが有効になります。
[キャンセル] を選択すると、locDeleteSettings を false に設定して、警告ダイアログを閉じます。
削除を選択すると、選択した優先度を colPriorities から、また、ID がある (つまり、既存の優先度である) 場合は、プロジェクト作業項目の優先度テーブルから削除します。

状態の表示と編集

このセクションでは、状態の表示あるいは編集時に使用されるコレクション、変数、および実行の詳細について説明します。

状態の表示とコレクションの編集

次のコレクションは、状態の表示あるいは編集時に使用されます。

コレクション名	説明
colStatuses	状態のコレクション。
colProjectCoverColors	プロジェクトカバーの色のコレクション。

状態の表示と変数の編集

次の変数は、状態の表示あるいは編集時に使用されます。

変数名	説明
locStatusColorPicker	色を編集するときにカラーピッカーを表示および非表示にするために使用されるローカル変数。
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。

状態の表示と実行の詳細の編集

色を選択すると、ocStatusColorPicker を true に設定し、カラーピッカーギャラリー galStatusColorPicker を表示します。
galStatusColorPicker の Default プロパティは、現在の Teams のテーマに基づいて状態の色に設定されます。これにより、表示/非表示が ThisItem.IsSelected に設定されているため、チェックマークアイコンが現在の状態の色で表示されます。
galStatusColorPicker を選択すると、locStatusColorPicker を false に、locSettingsChanged を true に設定します。
[保存] ボタンを選択すると、設定画面のすべての変更を保存します。具体的には、状態の場合、既存の状態は、ID フィールドが空白でない (つまり、既存の状態がある) という条件に基づいてフィルター処理され、Patch ステートメントを使用して更新されます。
優先度の色の更新は、次の方法で行われます:
- 現在の Teams テーマがダークの場合、ダークモードの色がユーザーに表示されます。そのため、Color 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当する既定モードを見つけることで更新されます。 Color Dark 列は、ユーザーが選択した色で更新されます。
- 現在の Teams テーマが既定の場合、既定モードの色がユーザーに表示されます。そのため、Color 列は、ユーザーが選択した色で更新されます。 Color Dark 列は、colProjectCoverColors への検索を行い、ユーザーが選択した色に相当するダークモードを見つけることで更新されます。

状態の追加

このセクションでは、状態値の追加時に使用されるコレクション、変数、および実行の詳細について説明します。

状態コレクションの追加

以下のコレクションは、状態の追加時に使用されます。

コレクション名	説明
colStatuses	状態のコレクション。

状態変数の追加

以下の変数は、状態の追加時に使用されます。

変数名	説明
locSettingsChanged	プロジェクト設定が変更されたかどうかを格納するローカル変数。
locGlobalSetting	更新されたグローバル設定を格納するローカル変数。
locGalleryDefaultStatus	galStatuses ギャラリーで既定の優先度の値を設定するために使用されるローカル変数。

状態の実行の詳細の追加

追加を選択すると、新しい状態を colStatuses に追加し、locSettingsChanged を true に設定して、設定画面で更新が行われたことを示し、保存ボタンを有効にします。
ギャラリー galStatuses は、Reset 関数を使用してリセットされ、ギャラリーを新しく追加された状態までスクロールします。
[保存] ボタンを選択すると、colStatuses 内の ID が空白のすべてのレコードに対して、プロジェクト作業項目の状態 テーブルに新しいレコードを作成します。

状態の削除

このセクションでは、状態の削除時に使用されるコレクション、変数、および実行の詳細について説明します。

状態の実行の詳細の削除

削除アイコンを選択すると、選択した優先度レコードを colRemovedStatuses に追加し、locDeleteSettings を true に更新して、conWarning_Settings コンテナーを表示します。
[分かりました] チェックボックスをチェックすると、[削除] ボタンが有効になります。
[キャンセル] を選択すると、locDeleteSettings を false に設定して、警告ダイアログを閉じます。
[削除] を選択すると、選択した状態を colStatuses から、また、ID がある (つまり、既存の状態である) 場合は、プロジェクト作業項目の状態テーブルから削除します。

マイルストーン サンプル アプリのアーキテクチャについて

前提条件

データ モデル

アーキテクチャ モデル

コネクタ

テーブル

コレクション

グローバル変数

アプリの OnStart

OnStart コレクション

OnStart 変数

OnStart 実行の詳細

読み込み画面

プロジェクト画面への移動

関連する変数

プロジェクト画面のナビゲーション実行の詳細

初回実行のエクスペリエンス

最初の実行エクスペリエンス変数

初回実行エクスペリエンスの実行の詳細

プロジェクト画面

プロジェクト変数の表示

プロジェクト実行の詳細の表示

プロジェクト カバーの表示と更新

プロジェクト カバーの更新変数

プロジェクト カバー更新の実行の詳細

マイルストーン/チーム状態の表示

マイルストーンの表示コレクション

マイルストーン表示変数

マイルストーン表示の実行の詳細

作業項目の一覧の表示

作業項目の表示コレクション

作業項目の表示変数

作業項目表示の実行の詳細

作業項目の削除

作業項目の削除コレクション

作業項目の削除変数

作業項目の実行の詳細の削除

作業項目の編集

作業項目の編集コレクション

作業項目の編集変数

作業項目編集実行の詳細

新規プロジェクトの作成

プロジェクト作成コレクション

プロジェクト作成変数

プロジェクト作成の実行の詳細

新規作業項目の作成

作業項目作成コレクション

作業項目の作成変数

作業項目作成の実行の詳細

バージョン情報画面

詳しいステップ

プロジェクト設定画面

プロジェクトに対するマイルストーンの一覧を表示

マイルストーンの表示コレクション

マイルストーン表示変数

マイルストーン表示の実行の詳細

マイルストーンの編集

マイルストーン編集コレクション

マイルストーン編集変数

マイルストーン編集の実行の詳細

マイルストーンの追加

マイルストーン作成コレクション

マイルストーン作成変数

マイルストーン作成の実行の詳細

マイルストーンの削除

マイルストーン コレクションの削除

マイルストーン変数の削除

マイルストーン実行詳細の削除

チーム メンバーの管理

チーム メンバー コレクションの管理

チーム メンバー変数の管理

チーム メンバーの実行詳細の管理

プロジェクトの削除

プロジェクトの削除コレクション

プロジェクトの削除変数

プロジェクト削除の実行の詳細

設定画面

カテゴリの表示と編集

カテゴリ編集コレクション

カテゴリ編集変数

マイルストーンサンプルアプリのアーキテクチャについて

データモデル

アーキテクチャモデル

プロジェクトカバーの表示と更新

プロジェクトカバーの更新変数

プロジェクトカバー更新の実行の詳細

マイルストーンコレクションの削除

チームメンバーの管理

チームメンバーコレクションの管理

チームメンバー変数の管理

チームメンバーの実行詳細の管理