Zdefiniuj zapytanie o element roboczy, aby dodać do szablonu procesu

Artykuł
06/09/2015

Najłatwiej plik zapytania o element roboczy (.wiq) utworzyć w programie Team Explorer.W istniejącym projekcie zespołowym można za pomocą programu Team Explorer utworzyć zapytania o wszystkie elementy robocze, które mają zostać dodane do szablonu procesu, a następnie wykonać kroki opisane w tym temacie, aby zapisać każde zapytanie jako plik .wiq.Aby dowiedzieć się więcej o tworzeniu zapytań o elementy robocze, zobacz Zapytanie o elementy pracy.

Wymagania

Aby utworzyć zapytanie, musisz być członkiem grupy Czytelnicy albo w swoim uprawnieniu Wyświetl elementy robocze w tym węźle mieć ustawiony stan Zezwalaj dla każdego projektu zespołowego objętego zapytaniem.
Aby zapisać kwerendy jako kwerendy zespołu, musi mieć odpowiednie uprawnienia, które są opisane w Ustawianie uprawnień dla zapytań zespołu.

Zapisywanie zapytania o element roboczy jako pliku .wiq

W programie Team Explorer otwórz zapytanie, które chcesz zapisać.
Na pliku menu, wybierz polecenie Zapisz < nazwa zapytania > [zapytania] jako.
W oknie dialogowym Zapisz zapytanie jako kliknij opcję Plik i określ lokalizację oraz nazwę pliku .wiq.Alternatywnie kliknij przycisk Przeglądaj, określ nazwę pliku, przejdź do lokalizacji, w której chcesz zapisać plik, i kliknij przycisk Zapisz.
Skopiuj plik do folderu \WorkItem Tracking\Queries. Znajduje się on w folderze, do którego pobrano szablon procesu.
Otwórz plik .wiq w edytorze tekstu.
Usuń < TeamFoundationServer > i < TeamProject > elementy, które skojarzenia zapytania z określonym serwerze z programem Visual Studio Team Foundation Server i projektu zespołowego określonych, jak pokazano w następującym przykładzie:
```
<TeamFoundationServer>CollectionURL</TeamFoundationServer>
<TeamProject>ProjectName</TeamProject>
```
[!UWAGA]

Plik .wiq w edytorze tekstu, nie można usunąć < TeamFoundationServer > i < TeamProject > elementy, które skojarzenia zapytania z określonego serwera i projektu zespołowego.W przeciwnym razie zapytanie nie będzie działać poprawnie, jeśli szablon procesu zostanie przekazany do innego serwera.Alternatywnie w miarę możliwości należy stosować makra, tak aby zapytanie nie zawierało jawnej nazwy bieżącego projektu zespołowego ani żadnych innych wartości specyficznych dla określonego środowiska.
Usuń wszelkie dodatkowe elementy specyficzne dla użytkownika.

Tworzenie zapytania o element roboczy odwołującego się do ścieżki iteracji

Można utworzyć zapytanie, które odwołuje się określonej ścieżki iteracji. W tym celu należy w zapytaniu podać makro projektu zespołowego $$PROJECTNAME$$ oraz nazwę ścieżki iteracji zdefiniowanej w pliku wtyczki Klasyfikacja.Na przykład poniższa składnia określa zapytanie obejmujące tylko te elementy robocze, których ścieżka iteracji należy do iteracji 1.

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

Po utworzeniu projektu zespołowego nazwa makra zostanie zastąpiona nazwą projektu zespołowego.

Użycie tego makra pozwala zdefiniować skoroszyty odwołujące się do konkretnych ścieżek iteracji.Szablon procesu do zwinnego tworzenia oprogramowania w środowisku MSF zawiera zapytanie specyficzne dla iteracji Iteration1Backlog.wiq, które obsługuje skoroszyt specyficzny dla iteracji Backlog.xlsm.

Po przesłaniu zapytań specyficznych dla iteracji najpierw musi zostać ukończone zadanie przetwarzania pliku Classification.xml, a dopiero potem może się rozpocząć zadanie przetwarzania plików zapytań.Aby uzyskać więcej informacji, zobacz Definiowanie obszarów początkowych i iteracji we wtyczce klasyfikacji i Definiowanie zadań głównych z wykorzystaniem pliku wtyczki szablonu procesu.

Przykład zapytania o element roboczy specyficznego dla iteracji

Poniższy przykład ilustruje zapytanie o element roboczy Iteration1Backlog, które obsługuje skoroszyt Zaległości iteracji.

<?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>

Opis elementu WorkItemQuery

Poniższa składnia pokazuje strukturę elementu WorkItemQuery i jego elementy podrzędne.

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

Element

Składnia

Opis

TeamFoundationServer

<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

Opcjonalny element podrzędny elementu WorkItemQuery.

Ważne
Zasadniczo element ten należy usuwać z zapytań dodawanych do szablonów procesów.

Określa identyfikator URI kolekcji projektów zespołowych w następującym formacie:

http://Nazwa_serwera: port/NazwaKataloguWirtualnego/CollectionName

Jeśli nie jest używany żaden katalog wirtualny, identyfikator URI powinien mieć następujący format:

http://Nazwa_serwera: port / CollectionName

Typem atrybutu jest ServerNameType o maksymalnej długości 2047 znaków.

TeamProject

<TeamProject>TeamProjectName</TeamProject>

Opcjonalny element podrzędny elementu WorkItemQuery.

Ważne
Zasadniczo element ten należy usuwać z zapytań dodawanych do szablonów procesów.

Określa projekt zespołowy, na którym ma zostać wykonane zapytanie.

Typem atrybutu jest ProjectNameType o maksymalnej długości 255 znaków.

Wiql

<Wiql>WorkItemQueryLanguage</Wiql>

Wymagany element podrzędny elementu WorkItemQuery.

Określa sekwencję poleceń języka SQL (Structured Query Language), które działają jako kryteria filtrowania w celu odnalezienia zbioru elementów roboczych w projekcie zespołowym i zwrócenia wartości przypisanych ustalonej liczbie pól.

Szablony procesów MSF zawierają kilka przykładów poleceń SQL obsługiwanych przez element Wiql.Te pliki znajdują się w podfolderze Queries folderu WorkItem Tracking.

Zobacz też

Koncepcje

Zapytanie o elementy pracy

Definiowanie obiektów śledzenia elementów pracy za pomocą wtyczki śledzenia elementów pracy

Udostępnij za pośrednictwem