次の方法で共有

プロセス テンプレートへの作業項目クエリの追加

  • [アーティクル]

プロセス テンプレートに作業項目クエリを追加することで、チーム プロジェクトの初期のチーム クエリおよびクエリ フォルダー構造のセットを定義できます。 すべてのチーム メンバーは、クエリを使用して、バグ、タスク、および実行する必要のある他の作業項目を検索します。

作業項目クエリでは、アクティブなバグや終了したタスクのリストなど、作業項目のリストを生成するための基準を指定します。 作業項目クエリ ファイルの拡張子は .wiq で、Microsoft Solutions Framework (MSF) プロセス テンプレートの WorkItem Tracking フォルダーの Queries サブフォルダーに格納されます。

重要

MSF のプロセス テンプレートでは、複数のクエリを定義します。 詳細については、「チーム クエリ (アジャイル)」および「チーム クエリ (CMMI)」を参照してください。 クエリの定義は、プロセス テンプレートのフィールドと作業項目の種類によって異なります。 ポータル プラグイン内にアップロードされるブックの中にも、クエリの定義に依存するものがあります。

クエリの定義を指定して、作業項目トラッキング プラグイン内のタスクとしてアップロードします。 このタスクは、プロセス テンプレート内の複数の成果物がクエリに依存する場合に必要です。 また、クエリをアップロードするタスクは、作業項目の種類をアップロードするタスクの正常な完了に依存します。 taskXml 要素内にアップロードする各クエリ ファイルを指定します。

このトピックの内容

  • 作業項目クエリのファイルの作成

  • アップロードするクエリの指定

  • QUERIES 要素リファレンス

プロセス テンプレートからチーム プロジェクトを作成したら、クエリ エディターを使用してチーム クエリを追加、削除および変更できます。 詳細については、「バグ、タスク、およびその他の作業項目の検索」を参照してください。

クエリのアクセス許可をグループに割り当てる方法については、「機能領域へのアクセスの制御」を参照してください。 クエリ フォルダーを作成する方法の詳細については、「作業項目を追跡するためのオブジェクトの作業項目トラッキング プラグインによる定義およびカスタマイズ」を参照してください。

作業項目クエリのファイルの作成

各クエリの定義は、WorkItemQuery 親要素を使用して、独自のファイル (拡張子は .wiq) で指定します。また、wiq.xsd ファイルで指定されたスキーマに従っている必要があります。 作業項目のトラッキングに使用するスキーマ ファイルは、Microsoft Web サイトの「Process Template and Work Item Schemas for Visual Studio Team Foundation (Visual Studio Team Foundation のプロセス テンプレート スキーマと作業項目スキーマ)」でダウンロードできます。

次の例は、作業項目クエリを定義する高レベルな構文構造を示しています。

<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL</TeamFoundationServer>
<TeamProject>TeamProjectName</TeamProject>
  <Wiql>
      WorkItemQueryLanguage
  </Wiql>
</WorkItemQuery>

プロセス テンプレートに追加する作業項目クエリを作成する方法の詳細については、「プロセス テンプレートに追加する作業項目クエリの定義」を参照してください。

ページのトップへ

アップロードするクエリの指定

作業項目クエリをプロセス テンプレートに組み込むには、1 つ以上のタスクを workitems.xml ファイルに作成します。このファイルは、プロセス テンプレートをダウンロードしたフォルダーの中の \WorkItem Tracking フォルダーにあります。 Query 要素を使用して、作業項目クエリのファイルを指定します。 たとえば、次の XML では、ActiveBugs.wiq ファイルで定義されるクエリを指定し、Active Bugs という名前でアップロードします。

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

作業項目トラッキング プラグインにタスクとしてアップロードするクエリのセットを追加します。

次の例では、Product Management という名前のクエリ フォルダーを作成し、そのフォルダーに All User Stories という名前のクエリをアップロードするタスクの指定方法を示しています。

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" />
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
      <QUERIES>
         <QueryFolder name="Product Management" >
            <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" />
         </QueryFolder>
         . . .
      </QUERIES>
   </taskXml>
</task>

詳細については、「作業項目を追跡するためのオブジェクトの作業項目トラッキング プラグインによる定義およびカスタマイズ」を参照してください。

ページのトップへ

QUERY 要素

次の構文は、QUERIES 要素およびその子要素の構造を示しています。

<QUERIES>
   <Permission />
   <QueryFolder >
      <Query />
   </QueryFolder>
</QUERIES>

次の表に、クエリ フォルダーの構造、アクセス許可およびアップロードするクエリの指定に使用する要素を示します。 作業項目トラッキング プラグイン ファイルの taskXml コンテナー要素内で、次の要素を指定します。

要素

構文

説明

Permission

 
<permission allow="ListOfPermissions" identity="GroupName" />

Query の子要素です (省略可能)。

チーム クエリに割り当てられる既定のアクセス許可を指定します。 詳細については、「作業項目クエリのアクセス許可の割り当て」を参照してください。

Query

 
<Query name="QueryName" fileName="QueryFilePathName" />

次の例で、Active Bugs と表示されているのはアップロードできるクエリで、このクエリは ActiveBugs.wiq ファイルで定義されています。

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

QUERIES の子要素です (必須)。

アップロードするクエリを定義する .wiq ファイルの名前とパスを指定します。

QueryFolder

 
<QueryFolder name="FolderName">
   <Query />
</QueryFolder>

QUERIES の子要素です (省略可能)。

クエリ フォルダーの名前を指定します。

QUERIES

 
<QUERIES>
   . . . 
</QUERIES>

作業項目トラッキング プラグインの taskXml 要素の子要素です (省略可能)。

既定のクエリを作成するために使用するクエリ定義ファイルを指定します。

ページのトップへ

参照

概念

バグ、タスク、およびその他の作業項目の検索

その他の技術情報

作業項目を追跡するためのオブジェクトの作業項目トラッキング プラグインによる定義およびカスタマイズ