Freigeben über

Definieren einer Arbeitsaufgabenabfrage zum Hinzufügen zu einer Prozessvorlage

  • Artikel

Eine Datei für die Abfrage von Arbeitsaufgaben (WIQ-Datei) kann in Team Explorer problemlos erstellt werden. In einem vorhandenen Teamprojekt können Sie mit Team Explorer alle Arbeitsaufgabenabfragen erstellen, die Sie der Prozessvorlage hinzufügen möchten, und dann die Schritte in diesem Thema ausführen, um jede Abfrage als WIQ-Datei zu speichern. Weitere Informationen zum Erstellen von Abfragen für Arbeitsaufgaben finden Sie unter Abfragen von Arbeitsaufgaben.

Anforderungen

  • Zum Erstellen einer Abfrage müssen Sie Mitglied der Gruppe Readers sein, oder die Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen muss für jedes Teamprojekt in der Abfrage auf Zulassen festgelegt sein.

  • Um eine Abfrage als Teamabfrage speichern zu können, müssen Sie über die erforderlichen Berechtigungen verfügen (siehe Set permissions on queries).

Speichern einer Arbeitsaufgabenabfrage als WIQ-Datei

  1. Öffnen Sie in Team Explorer die Abfrage, die Sie speichern möchten.

  2. Wählen Sie im Menü Datei die Option <Name der Abfrage> [Abfrage] speichern unter.

  3. Wählen Sie im Dialogfeld Abfrage speichern unter die Option Datei, und geben Sie einen Speicherort und einen Dateinamen für die WIQ-Datei an. Sie können auch Durchsuchen wählen, einen Dateinamen angeben, zum Speicherort navigieren, an dem die Datei gespeichert werden soll, und dann Speichern wählen.

  4. Kopieren Sie die Datei in den Ordner \Work Item Tracking\Queries. Dieser befindet sich in dem Ordner, in den die Prozessvorlage heruntergeladen wurde.

  5. Öffnen Sie die WIQ-Datei in einem Text-Editor.

  6. Entfernen Sie die Elemente <TeamFoundationServer> und <TeamProject>, die die Abfrage einem bestimmten Server, der Visual Studio Team Foundation Server ausführt, und einem bestimmten Teamprojekt zuordnen, wie in folgendem Beispiel gezeigt:

    <TeamFoundationServer>CollectionURL</TeamFoundationServer>
<TeamProject>ProjectName</TeamProject>

    Hinweis

    Sie müssen die WIQ-Datei mit einem Text-Editor bearbeiten und die Elemente <TeamFoundationServer> und <TeamProject> entfernen, durch die die Abfrage einem bestimmten Server und Teamprojekt zugeordnet wird.Andernfalls funktioniert die Abfrage nicht ordnungsgemäß, wenn die Prozessvorlage auf einen anderen Server hochgeladen wird.Verwenden Sie als Alternative wenn möglich Makros, damit die Abfrage nicht den expliziten Namen des aktuellen Teamprojekts oder andere explizite Werte enthält, die spezifisch für bestimmte Umgebungen sind.

  7. Entfernen Sie alle zusätzlichen Elemente, die für spezifisch für einen bestimmten Benutzer sind.

Erstellen einer Arbeitsaufgabenabfrage, die auf einen Iterationspfad verweist

Sie können eine Abfrage definieren, die auf einen bestimmten Iterationspfad verweist, indem Sie das Makro für das Teamprojekt ($$PROJEKTNAME$$) und den Namen eines Iterationspfads, der in der Plug-In-Datei "Classification" definiert wird, einschließen. Die folgende Abfragesyntax gibt z. B. eine Abfrage an, die nur diejenigen Arbeitsaufgaben einschließt, deren Iterationspfad sich unter "Iteration 1" befindet.

AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'

Wenn das Teamprojekt erstellt wird, wird das Makro mit dem Namen des Teamprojekts ersetzt.

Mit diesem Makro können Sie Arbeitsmappen definieren, die auf bestimmte Iterationspfade verweisen. Die Prozessvorlage für MSF for Agile Software Development enthält eine iterationsspezifische Abfrage ("Iteration1Backlog.wiq"), die die iterationsspezifische Arbeitsmappe "Iteration Backlog.xlsm" enthält.

Beim Hochladen iterationsspezifischer Abfragen muss die Aufgabe zum Verarbeiten der Datei "Classification.xml" vor der Aufgabe zum Verarbeiten der Abfragedateien ausgeführt werden. Weitere Informationen finden Sie unter Definieren des Plug-Ins für Klassifizierung und Definieren der Stammaufgaben mit der Plug-In-Datei für Prozessvorlagen.

Beispiel für eine iterationsspezifische Arbeitsaufgabenabfrage

Folgendes Beispiel zeigt die Arbeitsaufgabenabfrage "Iteration1Backlog", die die Arbeitsmappe "Iterationsrückstand" unterstützt.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.State],
           [System.AssignedTo],
           [Microsoft.VSTS.Scheduling.RemainingWork],
           [Microsoft.VSTS.Scheduling.CompletedWork],
           [Microsoft.VSTS.Scheduling.StoryPoints],
           [Microsoft.VSTS.Common.StackRank],
           [Microsoft.VSTS.Common.Priority],
           [Microsoft.VSTS.Common.Activity],
           [System.IterationPath],
           [System.AreaPath]
      FROM WorkItemLinks
     WHERE (Source.[System.TeamProject] = @project 
       AND  [Source].[System.AreaPath] UNDER @project
       AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
       AND (
               Source.[System.WorkItemType] = 'User Story' 
            OR Source.[System.WorkItemType] = 'Task'
           )
           )
       AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
       AND [Target].[System.WorkItemType] = 'Task'
       ORDER BY [Microsoft.VSTS.Common.StackRank], [Microsoft.VSTS.Common.Priority]
       mode(Recursive)
  </Wiql>
</WorkItemQuery>

WorkItemQuery-Elementverweis

Die folgende Syntax zeigt die Struktur des WorkItemQuery-Elements und der untergeordneten Elemente.

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

Element

Syntax

Beschreibung

TeamFoundationServer

 
<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

Optionales untergeordnetes Element von WorkItemQuery.

Wichtig

Im Allgemeinen entfernen Sie dieses Element aus Abfragen, die Prozessvorlagen hinzugefügt werden.

Gibt den URI der Teamprojektsammlung im folgenden Format an:

http:// Servername:Port/VirtuellerVerzeichnisname/Auflistungsname

Wenn kein virtuelles Verzeichnis verwendet wird, verwenden Sie das folgende Format für den URI:

http:// Servername:Port/Auflistungsname

Der Attributtyp ist ServerNameType mit einer maximalen Länge von 2047 Zeichen.

TeamProject

 
<TeamProject>TeamProjectName</TeamProject>

Optionales untergeordnetes Element von WorkItemQuery.

Wichtig

Im Allgemeinen entfernen Sie dieses Element aus Abfragen, die Prozessvorlagen hinzugefügt werden.

Gibt das Teamprojekt an, für das die Abfrage auszuführen ist.

Der Attributtyp ist ProjectNameType mit einer maximalen Länge von 255 Zeichen.

Wiql

 
<Wiql>WorkItemQueryLanguage</Wiql>

Erforderliches untergeordnetes Element von WorkItemQuery.

Gibt eine Reihenfolge von Structured Query Language (SQL)-Befehlen an, die als Filterkriterien für die Suche nach Arbeitsaufgaben in einem Teamprojekt dienen und die Werte zurückgeben, die einer festgelegten Anzahl von Feldern zugewiesen wurden.

Die MSF-Prozessvorlagen beinhalten mehrere Beispiele für SQL-Befehle, die vom Wiql-Element unterstützt werden. Diese Dateien befinden sich im Ordner "Abfragen" des Ordners "WorkItem-Nachverfolgung".

Siehe auch

Konzepte

Abfragen von Arbeitsaufgaben

Definieren von Objekten zum Nachverfolgen von Arbeitsaufgaben mit dem Plug-In für die Arbeitsaufgabenverfolgung