Udostępnij za pośrednictwem

Definiuj kwerendę elementu pracy, aby dodać do szablonu procesu.

  • Artykuł

Można utworzyć element roboczykwerenda (.wiq), plik najłatwiej w Team Explorer. W przypadku istniejącego zespołu projekt, można użyć Team Explorer utworzyć wszystkie element roboczy kwerend, który chcesz dodać doszablon proces, a następnie wykonaj kroki opisane w tym temacie, można zapisać każdy kwerenda jako plik .wiq. Aby uzyskać więcej informacji o sposobach utworzyćkwerendelement roboczy , zobacz Określ kryteria filtru kwerendy.

W tym temacie

  • Zapisywanie kwerendy elementu pracy jako.Plik Wiq

  • Tworzenie kwerendy elementu pracy odwołuje się do ścieżki iteracji

  • Przykład kwerendy specyficzne dla poszczególnych iteracji element pracy

  • Odwołanie WorkItemQuery Element

Wymagane uprawnienia

Aby utworzyć kwerenda, musi być członkiem czytelników grupalub użytkownika Wyświetlanie elementów pracy, w tym węźle uprawnienie musi być ustawiona na Zezwalaj dla każdego zespołu projekt kwerenda. Aby zapisać kwerenda jako zespół kwerenda, muszą mieć odpowiednie uprawnienia.Aby uzyskać więcej informacji, zobacz Organizowanie i ustawić uprawnienia dla kwerendy elementu pracy.

Zapisywanie kwerendy elementu pracy jako.Plik Wiq

Aby zapisać element roboczy kwerenda do pliku .wiq

  1. W Team Explorer, kliknij prawym przyciskiem myszy kwerenda, a następnie kliknij przycisk Kwerendy w widoku.

  2. Na pliku menu, kliknij przycisk zapisać < nazwa kwerenda> [Query] As.

  3. W Zapisz kwerendę jako okno dialogowe, kliknij przycisk plikui określ lokalizację i nazwa pliku pliku .wiq. Jako alternatywę, kliknij przeglądać, określ nazwa pliku, przejdź do lokalizacji, aby zapisać plik, a następnie kliknij przycisk zapisać.

  4. Skopiuj plik do \WorkItem Tracking\Queries folderu, który znajduje się w folderze, do którego został pobranyszablon proces.

  5. Otwórz plik .wiq w edytortekstu.

  6. Usuń <TeamFoundationServer> i <TeamProject> elementów, które skojarzyć kwerenda z określonego serwera, na którym działa Visual Studio Team Foundation Server i określonego zespołu projekt, jak pokazano w następującym przykładzie:

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

    [!UWAGA]

    Należy edycja plik .wiq w edytor tekstu i usunąć <TeamFoundationServer> i <TeamProject> elementów, które skojarzyć kwerenda z określonego serwera i zespołu projekt.W przeciwnym razie kwerenda nie będzie działać poprawnie, jeśli proces szablon zostanie przekazany do innego serwera.Jako alternatywę należy użyć makra, gdzie można tak, że kwerenda nie zawiera jawna nazwa bieżącego zespołu projekt lub inne wartości, które są specyficzne dla pewnych środowisko.

  7. Usuń dodatkowe elementy, które są specyficzne dla użytkownik.

Powrót do początku

Tworzenie kwerendy elementu pracy odwołuje się do ścieżki iteracji

Można zdefiniować kwerenda , która odwołuje się do ścieżki określonej iteracja poprzez włączenie makro dla zespołu projekt, $$ NAZWAPROJEKTU$ $ i nazwa ścieżki iteracja , która jest zdefiniowana w pliku dodatku klasyfikacji.Na przykład następująca składnia określa kwerenda , która obejmuje tylko tych elementów pracy, którego ścieżka iteracja jest iteracja 1.

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

Po utworzeniu zespołu projekt makro jest zastępowany nazwą zespołu projekt.

Za pomocą tego makro, można zdefiniować skoroszytów, odwołujące się do ścieżki określonej iteracja .processzablon MSFzwinne wytwarzanie oprogramowania zawiera iteracja-określonej kwerenda, Iteration1Backlog.wiq, który obsługuje iteracja-wybrany skoroszyt, Backlog.xlsm iteracji.

Gdy wysyłasz iteracja-szczególnych zapytań, zadanie do proces w pliku Classification.xml należy wykonać przed zadania proces pliki kwerenda .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.

Powrót do początku

Aa721742.collapse_all(pl-pl,VS.110).gifPrzykład kwerendy specyficzne dla poszczególnych iteracji element pracy

Poniższy przykład pokazuje Iteration1Backlog element roboczy kwerenda, który obsługuje skoroszytu 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>

Powrót do początku

Odwołanie WorkItemQuery Element

Następująca składnia pokazuje struktura WorkItemQuery elementu i jego elementów element podrzędny .

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

Element

Składnia

Opis

TeamFoundationServer

 
<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

Opcjonalne element podrzędny elementu WorkItemQuery.

Ważna uwagaWażne
Ogólnie rzecz biorąc Usuń ten element z kwerendy, które dodają do szablonów proces .

Określa URI zbioru zespołu projekt w następującym formacie:

http://Nazwa_serwera: port/NazwaKataloguWirtualnego/nazwa_kolekcji

Jeśli katalog wirtualny nie jest używany, należy użyć następującego formatu dla URI:

http://Nazwa_serwera: port / nazwa_kolekcji

Typ atrybut jest ServerNameType o maksymalnej długości 2047.

TeamProject

 
<TeamProject>TeamProjectName</TeamProject>

Opcjonalne element podrzędny elementu WorkItemQuery.

Ważna uwagaWażne
Ogólnie rzecz biorąc Usuń ten element z kwerendy, które dodają do szablonów proces .

Określa zespołu projekt przeciwko do uruchamiania kwerenda.

Typ atrybut jest ProjectNameType o maksymalnej długości 255 znaków.

Wiql

 
<Wiql>WorkItemQueryLanguage</Wiql>

Wymagane element podrzędny elementu WorkItemQuery.

Określa sekwencję poleceń Structured Query Language (SQL), które działają jako kryteria filtrowania, aby znaleźć zestaw elementów pracy w zespole projekt i zwraca wartości, które są przypisane do numeru zestawu pól.

Szablonyproces MSFzapewniają różne przykłady poleceń SQL Wiql obsługuje elementu. Te pliki znajdują się w folderze kwerendy folderu śledzenia elementu pracy.Aby uzyskać więcej informacji na temat sposobu definiowania kwerend, zobacz Wyszukiwanie błędów, zadań i innych elementów pracy.

Powrót do początku

Zobacz też

Koncepcje

Wyszukiwanie błędów, zadań i innych elementów pracy

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