プロジェクトの概要ページの表示と更新

[アーティクル]
11/13/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

各プロジェクトには、情報を共有し、最新のプロジェクトアクティビティを紹介するための概要またはホームページが用意されています。このページは、チームメンバーがプロジェクトの進捗状況に関する最新情報を常に把握するための中心的なハブとして機能します。このページは、次のタスクに使用します。

重要なプロジェクトの更新情報とお知らせを共有する
最近のアクティビティとマイルストーンを強調表示する
主要なプロジェクトリソースとドキュメントへの迅速なアクセスを提供する
チームのコラボレーションとコミュニケーションを促進する

プロジェクトの概要ページを使用して、より具体的なタスクも実行します。

プロジェクト管理者のタスク

プロジェクトメンバータスク

短いプロジェクトの説明を追加する
プロジェクト情報の README ファイルまたは Wiki を選択する
プロジェクトに投稿するユーザーを招待する
プロジェクトタグを設定する

プロジェクト情報の表示
プロジェクトアクティビティの表示
プロジェクトのお気に入り
チームメンバーとメールを送信またはチャットを開始する
プロジェクト全体で検索を開始する
プロジェクト情報の表示
チームメンバーとメールを送信またはチャットを開始する
プロジェクトアクティビティの表示

Note

ホストされているプロジェクトを Private または Public として指定できます。パブリックプロジェクトの場合、匿名ユーザーは Members セクションを除き、プロジェクト Summary を表示できます。また、 Like と Favorite アイコンは匿名ユーザーには表示されません。詳細については、「公開プロジェクトとは」を参照してください。

概要ページのスクリーンショット。

前提条件

アクセス許可: Project Administrators グループのメンバーであるか、 Edit プロジェクトレベルの情報 アクセス許可を Allow に設定して次のタスクを実行します。
- プロジェクトページの情報を編集する
- プロジェクト情報の共有に使用するリポジトリを変更する
- プロジェクトメンバーシップの管理
特定のタスク:
- プロジェクトページを編集するには、リポジトリまたはブランチの共同作成者であるか、 Contribute アクセス許可を Allow に設定します。
- プロジェクトの概要を表示するには、プロジェクトの有効なメンバーになります。詳細については、「セキュリティ、メンバーシップ、およびアクセス許可について」を参照してください。有効なユーザーグループ。
- プロジェクトタグを追加または編集するには、プロジェクトレベルの Manage プロパティ 権限を Allow に設定します。このアクセス許可は、プロジェクトのプロパティ REST API を制御します。

ヒント

ページの編集や機能の使用に必要なアクセス許可がない場合、対応するアイコンとリンクは表示されません。

プロジェクトの概要を開く

Web ブラウザーで Overview>Summary を選択します。まだプロジェクトがない場合は、プロジェクトを作成。

プロジェクトの概要がまだ設定されていない場合は、ウェルカムページが表示されます。

開始するには、次のいずれかのタスクを選択します。

招待他のユーザーをプロジェクトに追加開始します。組織に追加ユーザーのみを招待できます。
ボード 作業項目の追加開始します。
リポジトリリポジトリ複製またはインポートできる Repos>Files ページを開いたり、プロジェクトの概要ページ README ファイルを初期化したりできます。
パイプライン パイプラインの定義開始します。
テスト計画 テスト計画とテストスイート定義を開始します。
サービスを管理 1 つ以上のサービスの可視性を無効にします。

概要ページを更新する

概要ページには、プロジェクトリポジトリで定義されている README ファイルまたはプロジェクト Wiki のホームページが表示されます。プロジェクト Wiki ホームページを使用するには、プロジェクトの wiki を作成しプロジェクトの概要ページを Wiki を指すよう変更できます。

ページを編集します。
- ページを初めて編集する場合は、[プロジェクトの説明の追加選択。
- ページを初めて編集しない場合は、プロジェクト情報の編集を選択します。このアイコンは、プロジェクト Summary ページを編集する権限を持つメンバーにのみ表示されます。
Description ボックスにプロジェクトの目的の簡単な説明を入力します。
(省略可能)プロジェクトに 1 つ以上の Tags を追加します。これらのタグは、作業項目タグに似ています。コンマ区切り記号またはセミコロン区切り記号を使用して、一度に複数のタグを追加できます。タグは、次の規則に準拠している必要があります。
- タグは 40 文字以下にする必要があります
- タグにスラッシュ (/) 文字または末尾にハイフン文字 (-) を含めることはできません。
- プロジェクトに追加できるタグは 15 個以下
- タグでは大文字と小文字が区別されず、重複するタグや空のタグは使用できません。
Note

検索関数とフィルター関数を使用して、プロジェクトタグを検索またはフィルター処理することはできません。
README ファイルを参照するか、プロジェクト Wiki ホームページを参照して、残りのサマリーページの内容を参照するかを選択します。

ヒント

既定の README は、プロジェクトの作成時に追加されたリポジトリ内に作成されます。この README を選択するか、この目的で別のリポジトリと README ファイルを作成できます。

Readme ファイルを選択した場合 README のリポジトリを選択します。 README ファイルの現在のテキストのプレビューが表示されます。

Wikiを選択した場合、Wiki ホームページが参照され、Wiki TOC 内の最初のファイルである必要があります。その参照を変更することはできません。
参照先の README ファイルまたは wiki の内容を更新するには、対応するファイルを編集します。詳細については、「リポジトリの README を作成するまたは wiki ページの追加と編集を参照してください。

Summary ページに次の種類の情報を含めてみてください。
- ユーザーがプロジェクトに貢献できる方法
- アクセス許可を昇格または拡張機能を追加する連絡先
- ロードマップ情報
- 開発環境とテスト環境を設定するための手順へのリンク
- コードでの共同作業、作業の追跡、パイプラインの構築、リリースのデプロイに関する手順へのリンク
- バグ、問題、または要求を提出するためのテンプレートへのリンク
- Slack または Teams チャネルに質問を電子メールで送信したり、質問を投稿したりするための配布リストへのリンク。

プロジェクトに共同作成者を招待する

Invite を選択して、プロジェクトに投稿するようユーザーを招待する電子メールを送信します。詳細については、「ユーザーまたはグループをチームまたはプロジェクトに追加する」の「概要ページからユーザーを招待する」を参照してください。

[概要] ページの [招待] ボタンのスクリーンショット。

Note

Azure DevOps Server の場合、すべての電子メールアクションで、 SMTP サーバーを構成する必要があります。

プロジェクトアクティビティの表示

Project 統計または Activity セクションから、過去 1 日、7 日、または 30 日間にプロジェクトに対して行われた更新を表示できます。次の図に示すように、ビューオプションを選択します。

[概要] ページの [統計] セクションのスクリーンショット。

プロジェクトメンバーとチャットするか、メールを送信する

Members セクションでは、プロジェクトに追加されたメンバーの一部を確認し、メールまたはメンバーとのチャットを介してメンバーに接続できます。

[概要] ページの [メンバー] セクションのスクリーンショット。

Note

100 以上は、100 以上のメンバーがプロジェクトに追加されることを示します。

チャットセッションを電子メールで送信または開始するには、表示されているチームメンバーを選択し、オプションを選択します。

[概要] ページの [メンバー] セクションのスクリーンショット。チームメンバーに接続するために使用できるオプション。

Note

オンプレミスの Azure DevOps の場合、すべての電子メールアクションで SMTP サーバーを構成する必要があります。

プロジェクトを検索する

Summary ページから、コード、作業項目、Wiki の検索を開始できます。詳細については、「 Get started with search」を参照してください。

Git リポジトリの README ファイルを初期化する

プロジェクトと目標、およびチームメンバーがプロジェクト README ファイルを使用してプロジェクトに貢献する方法を共有できます。 Git プロジェクトの場合、README.md ファイルは、既定のブランチ内の各リポジトリのルートにある必要があります。 Git ベースのプロジェクトの場合、左側のウィンドウでは他のリポジトリへのナビゲーションがサポートされています。リポジトリごとに個別のウェルカムページ/README.md ファイルを作成できます。

Repos>Files を開きます。このページでは、リポジトリの複製、プッシュ、インポート、初期化のいずれかのオプションを選択するときに、リポジトリにコードを追加して、すぐに作業を開始する方法について説明します。
[README の追加] チェックボックスをオンにして、[初期化を選択します。

既定の README ファイルがプロジェクトリポジトリ (この場合は Fabrikam Test リポジトリ) に追加されます。
Overview>Summary に戻り、プロジェクトページの README ファイルを選択します。編集を選択します。
README ファイルを初期化したプロジェクトリポジトリを選択します。
README ファイルを編集するには、README ファイルのリンクを選択します。

README ファイルの Repos>Files ページに移動します。 README Markdown ファイルは、Git リポジトリ内の他のファイルと同様に編集および変更できます。 Markdown 言語を使用して README ファイルの書式を設定し、画像を追加できます。詳細については、「リポジトリの README を作成する」とMarkdown ガイダンスを参照してください。