Freigeben über

Definieren einer Arbeitsaufgabenabfrage zum Hinzufügen zu einer Prozessvorlage

  • Artikel

Aktualisiert: April 2011

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 Angeben von Abfragefilterkriterien.

In diesem Thema

  • Speichern einer Arbeitsaufgabenabfrage als WIQ-Datei

  • Erstellen einer Arbeitsaufgabenabfrage, die auf einen Iterationspfad verweist

  • Beispiel für eine iterationsspezifische Arbeitsaufgabenabfrage

  • WorkItemQuery-Elementverweis

Erforderliche Berechtigungen

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. Weitere Informationen finden Sie unter Organisieren und Festlegen von Berechtigungen für Arbeitsaufgabenabfragen.

Speichern einer Arbeitsaufgabenabfrage als WIQ-Datei

So speichern Sie eine Arbeitsaufgabenabfrage in einer WIQ-Datei

  1. Klicken Sie in Team Explorer mit der rechten Maustaste auf die Abfrage, und klicken Sie dann auf Abfrage anzeigen.

  2. Klicken Sie im Menü Datei auf die Option <Name der Abfrage> [Abfrage] speichern unter.

  3. Klicken Sie im Dialogfeld Abfrage speichern unter auf die Option Datei, und geben Sie einen Speicherort und einen Dateinamen für die WIQ-Datei an. Sie können auch auf Durchsuchen klicken, einen Dateinamen angeben, zum Speicherort navigieren, um die Datei zu speichern und dann auf Speichern klicken.

  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 das <TeamFoundationServer>- und das <TeamProject>-Element, 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>

    Tipp

    Sie müssen die WIQ-Datei mit einem Text-Editor bearbeiten und das <TeamFoundationServer>-Element sowie das <TeamProject>-Element 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.

Zurück nach oben

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 der anfänglichen Bereiche und Iterationen im Klassifizierungs-Plug-In und Definieren der Stammaufgaben mit der Plug-In-Datei für Prozessvorlagen.

Zurück nach oben

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>

Zurück nach oben

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.

Wichtiger HinweisWichtig
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/NameVirtuellesVerzeichnis/Sammlungsname

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

http://ServerName:Port/Sammlungsname

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

TeamProject

 
<TeamProject>TeamProjectName</TeamProject>

Optionales untergeordnetes Element von WorkItemQuery.

Wichtiger HinweisWichtig
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". Weitere Informationen zur Definition von Abfragen finden Sie unter Suchen nach Fehlern, Aufgaben und anderen Arbeitsaufgaben.

Zurück nach oben

Siehe auch

Konzepte

Suchen nach Fehlern, Aufgaben und anderen Arbeitsaufgaben

Weitere Ressourcen

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

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

April 2011

Jedes WorkItemQuery-Element wurde beschrieben, und Links zu verwandten Themen wurden entfernt.

Informationsergänzung.