次の方法で共有


プロジェクトの要約ページを表示および更新する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

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

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

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

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

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

  • 簡略なプロジェクトの説明を追加する
  • プロジェクト情報の README ファイルまたは Wiki を選択する
  • プロジェクトを共同作成するユーザーを招待する
  • プロジェクト タグを設定する
  • プロジェクト情報を表示する
  • プロジェクト アクティビティを表示する
  • プロジェクトをお気に入りに追加する
  • チーム メンバーにメールを送信またはチャットを開始する
  • プロジェクト全体で検索を開始する
  • プロジェクト情報を表示する
  • チーム メンバーにメールを送信またはチャットを開始する
  • プロジェクト アクティビティを表示する

Note

ホストされているプロジェクトを [非公開] または [公開] と指定できます。 パブリック プロジェクトの場合、匿名ユーザーは メンバー セクションを除き、プロジェクト 要約 を表示できます。 また、[いいね!][お気に入り] アイコンは匿名ユーザーには表示されません。 詳細については、「公開プロジェクトとは」を参照してください。

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

前提条件

カテゴリ 必要条件
アクセス許可 プロジェクト管理者グループのメンバーであるか、以下のタスクを実行できるようにプロジェクト レベルの情報を編集するアクセス許可が [許可] に設定されていること。
- プロジェクト ページの情報を編集します。
- プロジェクト情報の共有に使用するリポジトリを変更します。
- プロジェクト メンバーシップを管理します。
特定のタスク:
- プロジェクト ページを編集するには: リポジトリまたはブランチの共同作成者であるか、Contribute アクセス許可が [許可] に設定されている必要があります。
- プロジェクトの概要を表示するには: プロジェクトの有効なメンバーである必要があります。
- プロジェクト タグを追加または編集するには: プロジェクト レベルでプロパティの管理アクセス許可が [許可] に設定されている必要があります。 このアクセス許可により、プロジェクトのプロパティ REST API を制御します。

ヒント

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

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

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

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

スクリーンショットは、プロジェクトのウェルカム ページを示しています。

作業を開始するには、次のいずれかを選択してください。

要約ページを更新する

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

  1. ページを編集します。

    • ページを初めて編集する場合は、[プロジェクトの説明の追加] を選択します。
      初回編集時の要約ページのスクリーンショット。

    • 初めてのページ編集ではない場合は、[プロジェクト情報の編集] を選択します。 このアイコンは、プロジェクトの [要約] ページを編集する権限を持つメンバーにのみ表示されます。

  2. プロジェクトの目的の簡単な説明を [説明] ボックスに入力します。

    [このプロジェクトについて] ダイアログ。

  3. (省略可能) プロジェクトに 1 つ以上の [タグ] を追加します。 これらのタグは、作業項目タグに似ています。 コンマ区切り記号またはセミコロン区切り記号を使用して、一度に複数のタグを追加できます。 タグは、次の規則に準拠している必要があります。

    • タグは 40 文字以下にする必要があります
    • タグにスラッシュ (/) 文字または末尾にハイフン文字 (-) を含めることはできません。
    • プロジェクトに追加できるタグは 15 個以下です
    • タグでは大文字と小文字が区別されず、重複するタグや空のタグは使用できません。

    Note

    検索関数とフィルター関数を使用して、プロジェクト タグの検索やフィルター処理をすることはできません。

  4. README ファイルを参照するか、プロジェクト Wiki ホーム ページを参照して、残りの要約ページの内容を参照するかどうかを選択します。

    ヒント

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

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

    このプロジェクト ダイアログについて、README リポジトリを選択します。

    [Wiki] を選択した場合、Wiki ホームページが参照されます。これは、Wiki TOC 内の最初のファイルにする必要があります。 その参照を変更することはできません。

  5. 参照先の README ファイルまたは wiki の内容を更新するには、対応するファイルを編集します。 詳細については、「リポジトリの README を作成する」または「wiki ページを追加および編集する」を参照してください。

    [要約] ページに次の種類の情報を含めることを検討してください。

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

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

[招待] を選択して、プロジェクトを共同作成するようユーザーを招待するメールを送信します。 詳細については、「ユーザーまたはグループをチームまたはプロジェクトに追加する、要約ページからユーザーを招待する」を参照してください。

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

Note

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

プロジェクト アクティビティを表示する

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

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

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

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

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

Note

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

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

[要約] ページ、[メンバー] セクション、チーム メンバーとつながるために使用できるオプションのスクリーンショット。

Note

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

プロジェクトを検索する

[要約] ページから、コード、作業項目、Wiki の検索を開始できます。 詳細については、「AzCopy の概要」を参照してください。

[要約] ページの検索ボックスのスクリーンショット。

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

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

  1. [リポジトリ]>[ファイル] を開きます。 このページでは、リポジトリのクローン、プッシュ、インポート、初期化のいずれかのオプションを選択するときに、リポジトリにコードを追加して、すぐに作業を開始する方法について説明します。

  2. [README を追加する] のチェック ボックスをオンにして、[初期化] を選択します。

    最新バージョンの README ファイルの [初期化] のスクリーンショット

    既定の README ファイルがプロジェクト リポジトリ (この場合は Fabrikam Test リポジトリ) に追加されます。

  3. [概要]>[要約] に戻り、プロジェクト ページの README ファイルを選択します。 [編集] を選択します。

    README ファイルを選択したときのスクリーンショット。

  4. README ファイルを初期化したプロジェクト リポジトリを選択します。

    README ファイルが存在する [リポジトリを選択する] のスクリーンショット。

  5. README ファイルを編集するには、README ファイルのリンクを選択します。

    [README ファイルを編集する] のスクリーンショット。

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

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

バージョン管理用に TFVC を選択したプロジェクトの場合、README.md ファイルはチーム プロジェクト フォルダーのルート ($/TeamProject/README.md など) にある必要があります。

  1. [リポジトリ]>[ファイル] を開きます。

  2. [プロジェクトの説明を追加する] を選択します。

    ウェルカム ページ、TFVC の新しいプロジェクト、readme の作成のスクリーンショット。

  3. TFVC リポジトリを選択し、[保存] を選択します。 リポジトリに README ファイルがない場合は、次のメッセージが表示されます。

    [このプロジェクトについて] のダイアログのスクリーンショット。

  4. README ファイルを作成するには、[リポジトリ]>[ファイル] を選択し、プロジェクト リポジトリにファイルを追加する新しいファイルを選択します。

  5. ファイルに「README.md」と名前を付けます。

    [新しいファイルを追加する] のダイアログのスクリーンショット。

  6. README ファイルの内容を Markdown 形式で追加し、[チェックイン] を選択します。

    [README ファイルの内容を入力する] のスクリーンショット。

  7. [チェックイン] を選択して、README ファイルのチェックイン プロセスを完了します。

    [README ファイルをチェックインする] のダイアログのスクリーンショット。

  8. [概要]>[要約] を選択して、README ファイルが表示されたプロジェクトの概要ページを確認します。

    README ファイルが表示されたプロジェクトの要約ページのスクリーンショット。

REST API