次の方法で共有

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

  • [アーティクル]

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

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

重要

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

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

このトピックの内容

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

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

  • QUERIES 要素リファレンス

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

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

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

各クエリの定義は、WorkItemQuery 親要素を使用して、独自のファイル (拡張子は .wiq) で指定します。また、wiq.xsd ファイルで指定されたスキーマに従っている必要があります。 作業項目の追跡のスキーマ ファイルは、Microsoft Web サイトの「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 要素の子要素です (省略可能)。

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

ページのトップへ

参照

概念

作業項目のクエリ

作業項目トラッキング プラグインを使用した作業項目を追跡するためのオブジェクトの定義