既存の作業項目の種類に対するフィールドの追加とレイアウトの変更

作業項目の追加データを追跡するには、作業項目の種類にフィールドを追加したり、作業項目フォームに表示、および報告できるようにします。また、チームのニーズに最も合うように作業項目フォームのレイアウトを変更できます。このトピックでは、ジュリアと Peter Fabrikam のシステムのメンバーは、トラッキングの目標をサポートするために、2 種類の作業項目を参照し、カスタマイズします。

• 新しい機能を要求がどこにあるかを追跡するには、ジュリアは、オプションのドロップダウン メニューを使用するカスタム フィールドを追加し、製品バックログ項目の作業項目フォームのレイアウトが変更されます。ジュリアは、オプションのドロップダウン リストを使用するカスタム フィールドを追加し、製品バックログ項目の作業項目フォームのレイアウトを変更する 5 とおりのタスクを実行します。

• 度を的確にするには、自分の作業に、強化すると、Peter 作業を見積もるチームの機能は、タスクの作業項目の種類にフィールドを追加します。

次の図に示すように、ジュリアと Peter は、特定のシーケンスで、それぞれのタスクを、個別に実行します。

作業項目フォームのレイアウトを変更します。

フィールドを作業項目フォームに追加します。

Team Foundation Serverの既定のプロセス テンプレートのレポート可能として再配置作業項目のフィールドとフィールドを表示するには、Visual Studio ALM の作業項目フィールド参照 および Visual Studio ALM のレポート可能フィールド参照を参照してください。

要件

• この手順を実行するには、Team Foundation 管理者グループのメンバーであるか、またはプロジェクトのプロジェクト管理者グループのメンバーである必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。

[!メモ]

Windows Vista を実行している場合、アクセス許可を持たないフォルダーが存在する可能性があります。アクセス許可のない場所に作業項目の種類をエクスポートしようとすると、レジストリ仮想化テクノロジが、自動的にエクスポートされたファイルをリダイレクトし、仮想ストアに保存します。このリダイレクトが行われないようにするには、アクセス許可のある場所にファイルをエクスポートします。レジストリの仮想化に関する詳細については、Microsoft Web サイトの次のページを参照: レジストリの仮想化 および Windows Vista の共通ファイルとレジストリの仮想化の問題。

1.作業項目の種類の定義のエクスポート

チーム プロジェクトから型定義をダウンロードする場合、最新バージョンを使用していることを確認します。

[!メモ]

軽微な変更があり、XML ファイル形式を使い慣れているときは、メモ帳などのテキスト エディターを使用してファイルを変更できます。または、Visual Studio のアドインとしてインストールされるパワー ツールであるプロセス エディターを使用できます。このツールを使用して、型定義をインポートまたはエクスポートする必要はありません。代わりに、プロセス エディターを使用してファイルを開き、エディターのインターフェイスを通じて変更できます。

Microsoft Web サイトの次のページからのパワー ツールをダウンロードできます: Team Foundation Server のパワー ツール[.]

プロセス テンプレートのスキーマ ファイルのダウンロード方法の詳細については、「プロセス テンプレート プラグインの XML 要素定義に対するインデックス」を参照してください。

既存のチーム プロジェクトから作業項目の種類の定義をエクスポートするには

1. witadmin コマンド ライン ツールを実行するには、Visual Studio か チーム エクスプローラー のいずれかがインストールされているコマンド プロンプト ウィンドウを開き、次のように入力します。

   cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
   

   64 ビット版の Windows で、%programfiles% を %programfiles(x86)% に置き換えます。

2. [コレクションの URL] がチーム プロジェクト コレクションの URL を指定する。ここで、[プロジェクト名] 指定するコレクション内で定義されているチーム プロジェクトの名前をここに表示されている引数で現在のデータを置き換えてするには、次のコマンドを入力します WorkItemTypeName はエクスポートする作業項目の名前を指定してエクスポート ファイルをエクスポートできるように [ファイル名] は、名前と位置を指定します。次 [Enter] のキーを選択します。

   witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
   

   例: 製品バックログ項目の定義のエクスポート

   たとえば、ジュリアは FF_ProductBItem.xml に製品バックログ項目の FabrikamFiber の自分のチーム プロジェクトの種類の定義をエクスポート次のコマンドを使用します。

   witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml
   

   例: タスクの定義のエクスポート

   Peter は、タスクの種類の定義をエクスポートし、FF_Task.xml というファイルに保存する次のコマンドを使用します。

   witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml
   

   正常な完了に、次のメッセージが表示されます:

   操作が完了しました。

2.型定義にフィールドを追加します。

型定義にフィールドを追加するには、FIELDS のセクション内の FIELD の要素と FORM のセクション内の Control の要素を追加する必要があります。また、フィールドに対して確立される名前付け規則に準拠することをお勧めします。

作業項目の種類にフィールドを追加するには

1. 型のフィールドを定義する FIELDSで始まり、XML ファイルのセクションを探します。

2. 追加するカスタム フィールドの名前を指定する FIELD の要素を追加します。次の必須属性を指定する必要があります: 簡易 name、refname (参照名)、および type。詳細については、「FIELD (定義) 要素」を参照してください。

   [!メモ]

   参照名、つまり refname は、そのフィールドのプログラミング用の名前です。他のすべての規則は、この refname を参照します。詳細については、「作業項目トラッキング オブジェクトの名前付け規則」を参照してください。

   例: メニュー リストを使用するカスタム フィールドを追加します。

   たとえば、ジュリアは、製品バックログ項目の種類の定義にカスタム フィールド、FabrikamFiber.MyTeam.Requestor の参照名の要求元を追加するには、次のテキストを入力します。Alice は、このフィールドに対して許可される値の選択リストを指定します。さらに、リストの貴社の既定値です。

   <FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
      <ALLOWEDVALUES>
         <LISTITEM value="Customer" />
         <LISTITEM value="Executive Management" />
         <LISTITEM value="Other" />
         <LISTITEM value="Support" />
         <LISTITEM value="Team" />
         <LISTITEM value="Technicians" />
         <DEFAULTVALUE value="Customer" />
       </ALLOWEDVALUES>
   </FIELD>
   

   選択リストに関する詳細については、選択リストの定義を参照してください。

   例: 定義済みフィールドを追加します。

   タスクの型定義では、Peter は、定義済みフィールド、Microsoft.VSTS.Scheduling.CompletedWork の参照の名前を入力の使用を追加します。

   <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />
   

   定義済みのすべてのフィールドの一覧については、Visual Studio ALM の作業項目フィールド参照を参照してください。

3. カスタム フィールドがそれに表示する要素のグループ内の作業項目フォームに表示されるように FORM のセクション内の CONTROL の要素を追加します。コントロールの type の属性を指定する必要があります。詳細については、「Control XML 要素のリファレンス」を参照してください。

   例: 製品バックログ項目のフォームにカスタム フィールドを追加します。

   例: フィールドのコントロール要素を追加します。

   たとえば、ジュリアは、次のコード例に示すように、作業項目フォームのフィールドの下に表示されるように、要求元のフィールドの Control の要素を追加します。

   <Column PercentWidth="50">
      <Group Label="Status">
         <Column PercentWidth="100">
            <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
            <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
            <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
            <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
         </Column>
      </Group>
   </Column>
   

   ヒント
   作業項目トラッキングのスキーマ定義では大文字になっているすべてと、Camel 形式、およびそのほかすべての要素が FORM 要素のすべての子要素を定義します。種類の定義ファイルの検証中にエラーが発生した場合は、要素の大文字と小文字の構造を確認してください。また、開始タグと終了タグの大文字と小文字の構造は、XML 構文の規則に従って一致する必要があります。

   次の図は、製品バックログ項目の作業項目フォームは、新しいフィールドが含まれていることを示します。

   

   例: タスクのフォームに定義済みのフィールドを追加します。

   タスクの作業項目の場合は、Peter は、次のコード例に示すように、"残存作業"フィールドの上に表示する Control のフィールドを追加します:

   <Column PercentWidth="50">
      <Group Label="Details">
         <Column PercentWidth="100">
            <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed Work:" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Type="FieldControl" Label="Remaining Work:" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.BacklogPriority" Type="FieldControl" Label="Backlog Priority:" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.Activity" Type="FieldControl" Label="Activity:" LabelPosition="Left" />
            <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area:" LabelPosition="Left" />
         </Column>
      </Group>
   </Column>
   

   次の図は、タスクの作業項目フォームは、実績作業]フィールドが含まれていることを示します。

   

4. XML ファイルへの変更を保存します。

型定義に作業項目フィールドの追加に関する詳細を確認できます。

• 作業項目フィールドの追加および修正とレポート作成のサポート

• FIELD Element (Work Item Methodology Schema)

• Control XML 要素のリファレンス

• 作業項目の種類の XML 定義の要素のインデックスへ

3.2 列から単一の列にタブ グループのフォーム レイアウトを変更します。

ジュリア"説明"フィールドがフォームの幅を持つように、製品バックログ項目のフォーム レイアウトを変更する。次の図に示すように、既定のレイアウトは 2 組のタブ グループを表示します。タブのグループのセットにレイアウトを変更するには (Jill は 100 の幅に最初の列の要素を変更する必要がある FORM のセクションから TabGroup のが Column と要素を削除します。

2 列のタブ グループからのタブ グループは一つの列にフォーム レイアウトを変更するには

1. XML ファイルの TabGroup セクションを探します。[説明]、[タスク]、Tab の各要素は、対応するコントロールを表示する Control の要素を含む [受け入れ基準] と [履歴] などの項目の Tab の要素があることを確認します。

   <Group>
      <Column PercentWidth="50">
         <TabGroup>
         . . .
         </TabGroup>
      </Column>
      <Column PercentWidth="50">
         <TabGroup>
         . . .
         </TabGroup>
      </Column>
   </Group>
   

2. 1 TabGroup次 <Tab> . . . </Tab> のすべての要素を統合します。TabGroup の Group、Columnと無関係の要素を削除します。次の例では、新しい XML 構文構造を示しています。

   <Group>
      <Column PercentWidth="100">
         <TabGroup>
         . . .
         </TabGroup>
      </Column>
   </Group>
   

   [!メモ]

   最適な結果を得るには、すべてのコントロールまたはグループを 1 つの列に表示する必要があります。その場合、その列がフォームの幅全体に広がることもあります。また、すべての列を 1 つのグループとして表示する必要があります。その場合、そのグループに表示されるラベルまたは境界がないこともあります。詳細については、「作業項目フォームのデザインとカスタマイズ」を参照してください。

   次の図は、単一列のタブ グループを示します。

   

3. 変更内容を XML ファイルに保存します。

4.作業項目の種類の定義のインポート

型定義をカスタマイズしたら、変更を確認し、それを使用可能にするチーム プロジェクトにインポートする必要があります。インポート XML ファイルは現在の型定義の内容を上書きします。インポート プロセスは、アップロード前に XML 構文を検証します。

作業項目の種類を既存のチーム プロジェクトにインポートするには

• 手順 1 で、このトピックで既に説明した 1. 作業項目の種類の定義のエクスポート は、で指定されたコマンド プロンプト ウィンドウとディレクトリで次のコマンドを入力し、を [Enter] のキーを選択します。

  witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
  

  例: 製品バックログ項目の定義のインポート

  たとえば (Jill は、で FabrikamFiber のチーム プロジェクトに FF_ProductBItem.xml にエクスポート製品バックログ項目の種類の定義をインポート次のコマンドを使用します。

  witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml
  

  例: タスクの定義のインポート

  と Peter は、Bob が FF_Task.xml に保存したタスクの種類の定義をインポート次のコマンドを使用します。

  witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml
  

  正常な完了に、次のメッセージが表示されます:

  作業項目の種類のインポートが完了しました。

5.チーム プロジェクトを更新してから、対する型定義に変更を確認します。

型定義をインポートした後で、使用できるように修正のチーム エクスプローラーにおけるキャッシュを更新する必要があります。型定義をインポートするときに Visual Studio が開きますが見つかり、Team Foundation Server に接続する場合のみキャッシュを更新する必要があります。

チーム エクスプローラーの更新、製品バックログ項目を作成します。

自分のキャッシュを更新するには

1. チーム エクスプローラーでは、[最新の情報に更新] のボタンをクリックします。

   先ほどインポートした変更を含む、最新の更新情報がサーバーからダウンロードされます。

   更新が完了するまで数秒待ちます。

2. [作業項目] を選択します。

3. [新しい作業項目] を選択し、次に、変更した [プロダクト バックログ項目] または [タスク] などの作業項目の種類を選択します。

4. 作業項目フォームに表示するには対して行った変更を確認します。

5. 新しい作業項目を終了するには [閉じる] のボタンをクリックします。作業項目の保存を確認するメッセージが表示されたら [いいえ] のボタンをクリックします。