次の方法で共有


グローバル リストの定義

Team Foundation Server (TFS) でグローバル リストを使用すると、作業項目の共有の複数の型リストを更新するために必要な作業を最小限に抑えることができます。グローバル リストは、1 つ以上のフィールドおよび作業項目の種類に含めることができる選択リストです。チーム プロジェクト、チーム プロジェクト コレクションのグローバル リストとして、またはグローバル ワークフロー内で追加する作業項目の種類でグローバル リストを定義できます。リスト項目は、1 つまたは複数の GLOBALLIST 要素に含めることによって、コレクションの複数の作業項目の種類間で共有できます。

作業項目の種類を定義する際に、いくつかのフィールドが同じ値を共有することに気付くことがあります。多くの場合、複数の作業項目の種類間、および複数のチーム プロジェクト間でも共有はできます。この値の一部は、たとえば夜間ビルドのビルド番号のように頻繁に変化するため、管理者はこれらのリストを多くの場所で頻繁に更新することが必要になります。リストが外部システムから派生する必要がある場合、グローバル リストは非常に便利です。たとえば、会社が個別の顧客データベースを保持しているものとします。顧客によって検出されたバグをファイルする場合、顧客の名前はカスタムの Found By Customer フィールドに入力されます。

コレクションのグローバル リストは、表示、インポート、エクスポート、および削除できる XML ファイルとして管理できます。各グローバル リストの名前は最大 254 文字の Unicode 文字で、コレクション内において一意である必要があります。

[!メモ]

システム定義のグローバル リストはなく、既定値の定義済みのグローバル リストは、TFS が提供するテンプレートを処理します。

このトピックの内容

  • グローバル リストの追加と管理

  • グローバル リストを定義する場合の構文構造

  • 作業項目の種類の定義またはグローバル ワークフローに追加するグローバル リストの構文構造

  • コレクションで維持されるグローバル リストの構文構造

[!メモ]

追加したり、グローバル リストを変更し、インポートするには witadmin のコマンド ライン ツールを使用して、グローバル リストの定義をエクスポートする。「作業項目の種類のグローバル リストの管理 [witadmin]」を参照してください。グローバル リストを使用するには、作業項目の種類で定義 FIELD に追加します。「すべての FIELD XML 要素のリファレンス」を参照してください。

グローバル リストの追加と管理

グローバル リストは、コレクションのすべてのチーム プロジェクトによってグローバルに格納および使用される LISTITEM 要素のセットです。グローバル リストは、複数の作業項目の種類内で定義されるフィールド ([オペレーティング システム]、[発見されたビルド]、[修正されたビルド] のフィールド) で役立ちます。

グローバル リストおよび各グローバル リストの項目は、次の 4 つの方法のいずれかを使用して定義できます。

  • テンプレートを処理します。: プロセス テンプレートの作業項目の種類の定義でグローバル リストを定義できます。このテンプレートから作成された各チーム プロジェクトは、グローバル リストにアクセスできます。

  • チーム プロジェクト コレクション: チーム プロジェクト コレクションに定義されたグローバル リストをエクスポート、変更、削除、およびインポートできます。これらのグローバル リストは、コレクションに定義されているすべてのチーム プロジェクトで使用できます。

  • 作業項目の種類の定義: チーム プロジェクトを作成したら、定義に作業項目の種類で使用できるようにする場合は、グローバル リストを追加できます。

  • グローバル ワークフロー定義: チーム プロジェクトを作成したら、チーム プロジェクトまたはコレクションのグローバル ワークフロー定義が作業項目のすべての種類で使用できるようにする場合は、グローバル リストを追加できます。詳細については、「グローバル ワークフローのカスタマイズ」を参照してください。

ページのトップへ

グローバル リストを定義する場合の構文構造

次の表に、GLOBALLIST 要素と LISTITEM 要素を示します。これらの要素を使用して、項目の選択リストまたはドロップダウン メニューとしてユーザーに表示される値のリストを列挙できます。

要素

構文

説明

GLOBALIST

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>
 

コレクション用に保存され、コレクション内のすべてのチーム プロジェクトで使用できる一連の LISTITEM 要素を定義します。

globalListName: 1 ~ 255 文字で構成されたテキスト文字列です。

GLOBALLIST は、GLOBALLISTS 要素の必須の子要素であり、ALLOWEDVALUES 要素、SUGGESTEDVALUES 要素、および PROHIBITEDVALUES 要素の省略可能な子要素です。詳細については、「選択リストの定義」を参照してください。

LISTITEM

<LISTITEM value="Name" />

有効なリスト値を定義します。

メモメモ
グローバル リストのスコープはプロジェクトではないため、グローバル リストにはプロジェクトをスコープとするグループは指定しないでください。

LISTITEM は、GLOBALLIST 要素の必須の子要素であり、ALLOWEDVALUES 要素、SUGGESTEDVALUES 要素、および PROHIBITEDVALUES 要素の省略可能な子要素です。

ページのトップへ

作業項目の種類の定義またはグローバル ワークフローに追加するグローバル リストの構文構造

次の構文を追加すると、作業項目の種類またはグローバル ワークフローの XML 定義ファイルでグローバル リストを定義できます。

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

次の構文を使用すると、作業項目の種類の XML 定義ファイル内でグローバル リストを参照できます。

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

作業項目の種類の定義ファイルまたはグローバル ワークフローの構造と場所については、「すべての WITD XML 要素のリファレンス」または「グローバル ワークフローに関する XML 要素のリファレンス」をそれぞれ参照してください。

ページのトップへ

プロジェクト コレクションで維持されるグローバル リストの構文構造

グローバル リストをプロジェクト コレクションに追加するには、witadmin importgloballist コマンドを使用して、次の構文をインポートします。

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

空のグローバル リストは使用できません。各 GLOBALLIST 要素には、少なくとも 1 つの LISTITEM 要素が定義されている必要があります。

ページのトップへ

参照

関連項目

作業項目の種類のグローバル リストの管理 [witadmin]

概念

プロジェクトの追跡データ、フォーム、ワークフロー、その他のオブジェクトのカスタマイズ

ユーザー リスト、選択リスト、およびグローバル リストの定義

その他の技術情報

グローバル ワークフローのカスタマイズ