ダッシュボードに Markdown を追加する

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

Markdown ウィジェットを使用して、次のような情報を追加して、チームと利害関係者をサポートします。

  • チームの目標。
  • リンク先:
    • チーム バックログまたはボード。
    • メトリック。
    • OneNote、SharePoint サイト、Wiki ページなど、ネットワーク共有内にあるその他のアイテム。
  • 重要な日付またはターゲットの期限。

次に例を示します。
サンプル マークダウン ウィジェットのスクリーンショット。

前提条件

  • アクセス:
  • アクセス許可:
    • チーム ダッシュボード: チーム ダッシュボードを追加、編集、または管理するには、次の要件を満たします。
      • チームのメンバーになる。
      • プロジェクト管理者グループのメンバーである必要があります。

Note

グラフまたはウィジェット内に表示されるデータには、サインインしているユーザーに付与されたアクセス許可が適用されます。 たとえば、ユーザーが特定のエリア パスの下にある作業項目を表示するアクセス許可を持っていない場合、それらのアイテムはダッシュボードのクエリ結果ウィジェットに表示されません。 詳細については、ダッシュボードの使用に関する FAQ を参照してください

サポートされている Markdown 構文

Markdown ウィジェットは、次のような CommonMark 標準機能をサポートしています。

  • 見出し
  • 段落と改行
  • ブロック引用
  • 水平線
  • 強調 (太字、斜体、取り消し線)
  • Tables
  • 順序付けされたリストと順序なしリストの両方
  • リンク
  • 画像
  • 文字のエスケープ

使用法の詳細については、基本的な Markdown 使用法の構文ガイダンスを参照してください

パフォーマンス上の理由から、Markdown ウィジェットでは多くの拡張機能のサポートが追加されていません。その多くは Wiki でサポートされています。 拡張された機能は、ウィジェットの読み込み時間を妨げる可能性があります。 たとえば、Markdown ウィジェットでは、次の拡張 Markdown 機能はサポートされていません。

  • 埋め込み HTML 構文
  • コードの強調表示 (wiki/その他は言語構文に対応した色分けをサポートし、CommonMark はコードをプレーンな書式設定されたテキストとしてレンダリングするだけです)
  • チェックリスト
  • 絵文字文字
  • Attachments
  • 数式

プロジェクトに接続する

Markdown ウィジェットをダッシュボードに追加するには、サポートされている Web ブラウザーを 使用してプロジェクトに接続します

Web ブラウザーを開き、プロジェクトに接続して、[ 概要>ダッシュボード] を選択します。

Web ポータルのスクリーンショット。ダッシュボードを開きます。

別のプロジェクトに切り替える必要がある場合は、Azure DevOps ロゴを 選択して すべてのプロジェクトを参照します

Markdown ウィジェットを追加する

ダッシュボードを追加する必要がある場合は、「ダッシュボードの追加、名前変更、および削除」を参照してください

マークダウン ウィジェットをダッシュボードに追加するには、[編集] を選択します。 ウィジェット カタログが自動的に開きます。

  1. Markdown ウィジェットを追加するか、配置するダッシュボードにドラッグします。

    Markdown ウィジェットのスクリーンショット。
  2. [編集完了] を選択してダッシュボードの編集を終了します。 これにより、ウィジェット カタログが閉じます。 その後、必要に応じて Markdown ウィジェットを構成できます。

  3. 歯車アイコンを 歯車アイコン 選択して、ウィジェットの構成ダイアログを開きます。

    Markdown ウィジェットを編集するには、チーム管理者、プロジェクト管理者グループのメンバー、またはアクセス許可の付与が必要になる場合があります。 詳細については、「ダッシュボードのアクセス許可を設定する」を参照してください

  4. 必要に応じて、入力する Markdown の内容に合わせてウィジェットのサイズを調整します。 最大サイズは、幅 10 タイル、高さ 10 タイルです。 これは後でいつでも調整できます。

    Markdown ウィジェットの構成ダイアログのスクリーンショット。サイズを変更します。
  5. 構成ダイアログにテキストと Markdown 構文を入力します。 サポートされている構文については、Markdown ファイル、ウィジェット、Wiki、pull request コメントの構文ガイダンスを参照してください

    ここでは、4 つのリンクの箇条書きリストを含む単純なテキストを示します

    マークダウンの構成、テキスト 入力のスクリーンショット。

    ヒント

    Wiki ページにリンクするには、次の構文を使用します。
    /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

    プロジェクト内のリポジトリ ファイル、ページ、またはイメージにリンクするには、ファイルをリッチクリックして完全な URL を使用します。

    これにより、次のウィジェットがレンダリングされます。

    Web ポータルのサンプル マークダウン ウィジェットのスクリーンショット。

    Note

    使用 file:// しているファイル共有上のドキュメントへのリンクはサポートされていません。 この制限は、セキュリティ目的で実装されています。

  6. 必要に応じて、リポジトリ内のファイルを指すように選択できます。

    リポジトリ ファイルを含む Markdown ウィジェットの構成のスクリーンショット。