Define a work item query to add to a process template

Článek
09/11/2015

Můžete vytvořit soubor pracovní položka dotazu (.wiq) nejvíce snadno v Průzkumník týmových projektů. V existující týmový projekt, můžete použít Průzkumník týmových projektů Chcete-li vytvořit všechny dotazy pracovní položky, které chcete přidat do šablony procesu a potom postupujte podle kroků v tomto tématu každý dotaz uložit jako soubor .wiq. Další informace o tom, jak vytvořit pracovní položku dotazy, naleznete v Dotaz na pracovní položky.

Požadavky

Vytvořit dotaz, musí být členem skupiny čtenáři skupiny, nebo vaše zobrazení pracovních položek v tomto uzlu musí být nastaveno na hodnotu Povolit pro každou týmový projekt v dotazu.
Chcete-li uložit dotaz jako dotaz týmu, musí mít vhodná oprávnění popsané v Set permissions on queries.

Uložení dotazu na pracovní položky jako souboru .wiq

V Průzkumník týmových projektů, otevřete dotaz, který chcete uložit.
Na soubor nabídce zvolte Uložit < název dotazu > [dotaz] jako.
V Uložit dotaz jako dialogové okno zvolte soubor, a zadejte název souboru a umístění souboru .wiq. Alternativně zvolte Procházet, zadejte název souboru, přejděte k umístění pro uložení souboru a poté zvolte možnost Uložit.
Zkopírujte soubor, který má \WorkItem Tracking\Queries složky, která je ve složce, do kterého jste stáhli šablonu procesu.
Otevřete soubor .wiq v textovém editoru.
Odebrat < TeamFoundationServer > a < TeamProject > elementů, u nichž přidružit konkrétní server, který je spuštěn dotaz Visual Studio Team Foundation Server a konkrétní týmový projekt, jako ukazuje následující příklad:
```
<TeamFoundationServer>CollectionURL</TeamFoundationServer>
<TeamProject>ProjectName</TeamProject>
```
Poznámka

Je nutné upravit soubor .wiq v textovém editoru a odebrat < TeamFoundationServer > a < TeamProject > elementů, u nichž přidružit dotaz na určitém serveru a týmového projektu.Pokud to neuděláte, nebude dotaz správně fungovat, pokud se šablona procesu odešle na jiný server.Kde je to možné, můžete alternativně použít makra, aby dotaz neobsahoval explicitní název aktuálního týmového projektu nebo jiné hodnoty, které jsou specifické pro určité prostředí.
Odeberte všechny další elementy, které jsou specifické pro uživatele.

Vytvoření dotazu na pracovní položky, který odkazuje na cestu iterace

Zahrnutím makra $$PROJECTNAME$$ pro týmový projekt a názvu cesty iterace, který je definován v souboru Classification modulu plug-in, můžete definovat dotaz, který odkazuje na konkrétní cestu iterace. Následující syntaxe například určuje dotaz, který zahrnuje pouze ty pracovní položky, jejichž cesta iterace je uvnitř Iterace 1.

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

Po vytvoření týmového projektu je makro nahrazeno názvem týmového projektu.

Pomocí tohoto makra lze definovat sešity, které odkazují na konkrétní cesty iterace. Šablona procesu pro agilní vývoj softwaru MSF obsahuje iterační dotaz Iteration1Backlog.wiq, který podporuje iterační sešit Iteration Backlog.xlsm.

Při odesílání iteračních dotazů musí být dokončena úloha zpracování souboru Classification.xml, aby bylo možné zpracovat soubory dotazů. Další informace naleznete v tématu Definování modulu plug-in pro klasifikaci a Define the root tasks using the process template plug-in file File.

Příklad iteračního dotazu na pracovní položky

Následující příklad znázorňuje dotaz na pracovní položky Iteration1Backlog, který podporuje sešit nevyřízených položek iterace.

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

Odkaz na element WorkItemQuery

Následující syntaxe ukazuje strukturu WorkItemQuery elementu a jeho podřízených elementů.

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

Element	Syntaxe	Popis
TeamFoundationServer	`<TeamFoundationServer>collectionURL </TeamFoundatonServer>`	Volitelný podřízený prvek WorkItemQuery. Důležité Tento element se obecně odebírá z dotazů, které přidáte do šablon procesů. Určuje identifikátor URI kolekce týmových projektů v následujícím formátu: http:// Název_serveru: port/název_virtuálního_adresáře/CollectionName Pokud se nepoužívá virtuální adresář, použijte následující formát identifikátoru URI: http:// Název_serveru: port / CollectionName Typ atributu je ServerNameType s maximální délkou 2047.
TeamProject	`<TeamProject>TeamProjectName</TeamProject>`	Volitelný podřízený prvek WorkItemQuery. Důležité Tento element se obecně odebírá z dotazů, které přidáte do šablon procesů. Určuje týmový projekt, vůči kterému chcete dotaz spustit. Typ atributu je ProjectNameType s maximální délkou 255 znaků.
Wiql	`<Wiql>WorkItemQueryLanguage</Wiql>`	Požadovaný podřízený element WorkItemQuery. Určuje sekvenci příkazů SQL (Structured Query Language), které se chovají jako kritéria filtru a hledají sadu pracovních položek v týmovém projektu a vrací hodnoty, které jsou přiřazeny nastavenému počtu polí. Šablony procesů MSF poskytují několik příkladů SQL příkazy, které Wiql podporuje prvek. Tyto soubory jsou umístěny ve složce Queries uvnitř složky WorkItem Tracking.

Element

Syntaxe

Popis

TeamFoundationServer

<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

Volitelný podřízený prvek WorkItemQuery.

Důležité

Tento element se obecně odebírá z dotazů, které přidáte do šablon procesů.

Určuje identifikátor URI kolekce týmových projektů v následujícím formátu:

http:// Název_serveru: port/název_virtuálního_adresáře/CollectionName

Pokud se nepoužívá virtuální adresář, použijte následující formát identifikátoru URI:

http:// Název_serveru: port / CollectionName

Typ atributu je ServerNameType s maximální délkou 2047.

TeamProject

<TeamProject>TeamProjectName</TeamProject>

Volitelný podřízený prvek WorkItemQuery.

Důležité

Tento element se obecně odebírá z dotazů, které přidáte do šablon procesů.

Určuje týmový projekt, vůči kterému chcete dotaz spustit.

Typ atributu je ProjectNameType s maximální délkou 255 znaků.

Wiql

<Wiql>WorkItemQueryLanguage</Wiql>

Požadovaný podřízený element WorkItemQuery.

Určuje sekvenci příkazů SQL (Structured Query Language), které se chovají jako kritéria filtru a hledají sadu pracovních položek v týmovém projektu a vrací hodnoty, které jsou přiřazeny nastavenému počtu polí.

Šablony procesů MSF poskytují několik příkladů SQL příkazy, které Wiql podporuje prvek. Tyto soubory jsou umístěny ve složce Queries uvnitř složky WorkItem Tracking.

Viz také

Koncepty

Dotaz na pracovní položky

Define objects for tracking work items using the work Item tracking plug-in

Sdílet prostřednictvím