excel - PowerShell のリンクされた作業項目に対する VSTS WIQL クエリ

Question

PowerShell で WIQL (Work Item Query Language) を使用して、特定の「反復パス」と「エリア パス」の下にあるすべての作業項目の作業項目リンク関係の詳細で構成される VSTS チーム プロジェクトに関するレポートを作成したいと考えました。例: Epics→Features→UserStories。Epics と Features の間には親子関係があり、Features と UserStories の間にも親子関係があるためです。したがって、入力は「反復パス」と「エリア パス」になり、対応する出力は、これらの作業項目とその関係のすべての詳細を含むレポート (.csv または .xls) になります。PowerShell で WIQL を使用してこれを達成する方法を誰かに教えてもらえますか?

Answer 1

簡単なサンプル:

    #Load TFS PowerShell Snap-in
    if((Get-PSSnapIn -Name Microsoft.TeamFoundation.PowerShell -ErrorAction SilentlyContinue) -eq $null)
    {
        Add-PSSnapin Microsoft.TeamFoundation.PowerShell
    }
    #Load Reference Assemblies
    $Tfs2015AssembliesPath="C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer"
    Add-Type -Path "$Tfs2015AssembliesPath\Microsoft.TeamFoundation.Client.dll"
    Add-Type -Path "$Tfs2015AssembliesPath\Microsoft.TeamFoundation.Common.dll"
    Add-Type -Path "$Tfs2015AssembliesPath\Microsoft.TeamFoundation.WorkItemTracking.Client.dll"
    Function GetWorkItems{
        param([string]$teamProjectName,[string]$address)
        $credentials = New-Object System.Net.NetworkCredential("[user name]", "[password]")
        $tfsCollection = New-Object Microsoft.TeamFoundation.Client.TfsTeamProjectCollection((New-Object System.URI($address)))
        $wis = $tfsCollection.GetService([Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItemStore])
        $wiqlQT="select [System.Id], [System.WorkItemType], [System.Title], [System.AssignedTo], [System.State], [System.Tags] from WorkItemLinks where (Source.[System.TeamProject] = @project and Source.[System.WorkItemType] = 'Epic' and Source.[System.State] <> '' and Source.[System.AreaPath] = 'Agile2015Starain' and Source.[System.IterationPath] = 'Agile2015Starain') and ([System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward') and (Target.[System.TeamProject] = @project and Target.[System.WorkItemType] <> '') mode (Recursive)"
        $variableValues=@{}
        $variableValues.Add("project", $teamProjectName)
        $query=New-Object Microsoft.TeamFoundation.WorkItemTracking.Client.Query($wis,$wiqlQT,$variableValues)
        $witCollection=$query.RunLinkQuery()

           #logical to save data to excel or csv

        $wits=New-Object "System.Collections.Generic.List[Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem]"
        $title=""
        $id=0
        Foreach($witItem in $witCollection)
            {
                $id=$witItem.SourceId
                 if($id -gt 0)
                    {
                        $parentWorkItem = $wits | where {$_['ID'] -eq $id}
                        $t = $parentWorkItem.Title;
                    }
                    $currentWorkItem = $wis.GetWorkItem($witItem.TargetId);
                    $t = $currentWorkItem.Title;
                    $wits.Add($currentWorkItem);
            }
    }

GetWorkItems "Agile2015Starain" "https://[your vsts name].visualstudio.com"