TFS 2010: Как создать журнал изменений (т. Е. Список рабочих элементов) между двумя выпусками приложения с использованием меток?

Question

Я ищу способ автоматического создания журнала изменений (фактически списка рабочих элементов) между двумя выпусками моего приложения. У меня есть две версии моего приложения, v1 и v2, каждая из которых помечена меткой в ​​TFS 2010 (LABEL1 и LABEL2), которую я создал вручную перед сборкой настроек своего приложения. У меня есть система ветвления, что означает, что у меня есть транк, в котором большинство ошибок исправлено, и ветвь, в которой исправления применяются в основном с использованием слияний из транка (но есть также некоторые исправления только для ветви, которые не касаются транка) , Две версии моего приложения (v1 и v2) являются версиями из ветви.

Я бы хотел, чтобы TFS 2010 могла возвращать список исправленных ошибок (т. Е. Список рабочих элементов с типом = Ошибка, которые закрыты и проверены) между этими двумя метками.

Я пытался добиться этого, используя веб-интерфейс TFS 2010 или Visual Studio, но не нашел никакого способа.

Затем я попытался запросить у tf.exe историю, используя следующую командную строку:

tf history /server:http://server_url/collection_name "$/project_path" /version:LLABEL1~LLABEL2 /recursive /noprompt /format:brief

где LABEL1 - метка, которая была связана с исходным кодом v1 приложения, и LABEL2 - метка, которая была связана с исходным кодом v2 приложения. Это на самом деле дает сбой двумя способами: - командная строка возвращает только список наборов изменений, а не список связанных закрытых рабочих элементов - список наборов изменений содержит только наборы изменений, которые я применил к самой ветви, а не наборы изменений, которые я также применил, и ствол, а затем объединенный с этой ветвью. Установка или нет параметра "/ slotmode" ничего не меняет.

Там я попытался написать кусок кода C # для получения списка рабочих элементов (не списка наборов изменений):

var tfs = TfsTeamProjectCollectionFactory.GetTeamProjectCollection(new Uri("http://server_url/collection_name"));

VersionControlServer controlServer = tfs.GetService<VersionControlServer>();
VersionControlServer vcs = tfs.GetService<VersionControlServer>();

VersionSpec sFrom = VersionSpec.ParseSingleSpec("LLABEL1", null);
VersionSpec sTo = VersionSpec.ParseSingleSpec("LLABEL2", null);

var changesets = vcs.QueryHistory(
    "$/project_path",
    sTo,
    0,
    RecursionType.Full,
    null,
    sFrom,
    sTo,
    int.MaxValue,
    true,
    false); // Slotmode to false

Dictionary<int, WorkItem> dico = new Dictionary<int, WorkItem>();
foreach (Changeset set in changesets)
{
    foreach (WorkItem zz in set.WorkItems)
    {
        if (!dico.ContainsKey(zz.Id))
        {
            dico.Add(zz.Id, zz);
        }
    }
}

foreach (KeyValuePair<int, WorkItem> pair in dico.OrderBy(z => z.Key))
{
    Console.WriteLine(string.Format("ID: {0}, Title: {1}", pair.Key, pair.Value.Title));
}

Это на самом деле работает, я получаю список рабочих элементов между двумя моими ярлыками, что на самом деле то, что я хотел. Но учитываются только рабочие элементы, связанные с наборами изменений, которые были зафиксированы в самой ветви: рабочие элементы типа «Ошибка», которые были решены в стволе, а затем объединены с веткой, не отображаются. Слот-режим ничего не меняет.

Затем я наконец попытался заменить VersionSpecs, определенные меткой, на VersionSpecs, которые определены наборами изменений:

VersionSpec sFrom = VersionSpec.ParseSingleSpec("C5083", null);
VersionSpec sTo = VersionSpec.ParseSingleSpec("C5276", null);

И мой код наконец работает.

Итак, мой вопрос: как я могу получить тот же результат с метками, какие объекты TFS я использую для идентификации версии? Если это невозможно, как мне определить версию в TFS 2010? Thx.

Кстати, я нашел несколько вопросов о stackoverflow, но ни один из них не дал мне ответов с метками. Например: Пример вопроса

Answer 1

Я думаю http://tfschangelog.codeplex.com/ может вам помочь.

Приложение TFS ChangeLog позволяет пользователям автоматически создавать заметки о выпуске из TFS. Пользователи должны будут предоставить информацию о своем проекте, ветви и диапазоне наборов изменений, а затем приложение TFS ChangeLog извлечет информацию из каждого набора изменений в данном диапазоне и всех связанных рабочих элементов в такие наборы изменений. то есть он будет перемещаться от начального набора изменений до конечного набора изменений и будет извлекать данные о каждом наборе изменений вместе со связанными рабочими элементами в файле XML.

Пользователи могут использовать свою собственную логику преобразования, включая фильтр, сортировку, стилизацию, форматирование вывода и т. Д., Для создания отчета о выпуске.

Еще одна вещь, которую я хотел бы добавить, будет связана с метками в TFS. Метки в основном назначаются / ассоциируются с наборами изменений. В настоящее время приложение TFS ChangeLog не поддерживает метки для определения начальной и конечной точки, но поддерживает набор изменений, который можно использовать в качестве обходного решения.

Надеюсь, это полезно.

Answer 2

Я был в той же ситуации, что и вы. Я также хочу, чтобы рабочие элементы из объединенных наборов изменений были включены. Я включаю только рабочие элементы, которые Готово . Также, если один и тот же рабочий элемент связан с несколькими наборами изменений, сообщается только о последнем наборе изменений. Я использую это в настройке CI; и создайте журнал изменений для каждой сборки. Затем List<ChangeInfo> можно экспортировать в XML / HTML / TXT-файл. Вот мое решение:

namespace TFSChangelog
{
  public class TFSChangelogGenerator
  {
    private const string workItemDoneText = "Done";

    /// <summary>
    /// This class describes a change by:
    /// Changeset details
    /// and
    /// WorkItem details
    /// </summary>
    public class ChangeInfo
    {
      #region Changeset details

      public DateTime ChangesetCreationDate { get; set; }
      public int ChangesetId { get; set; }

      #endregion

      #region WorkItem details

      public string WorkItemTitle { get; set; }
      public int WorkItemId { get; set; }

      #endregion
    }

    public static List<ChangeInfo> GetChangeinfo(string tfsServer, string serverPath, string from, string to)
    {
      // Connect to server
      var tfs = TfsTeamProjectCollectionFactory.GetTeamProjectCollection(new Uri(tfsServer));
      tfs.Connect(ConnectOptions.None);
      var vcs = tfs.GetService<VersionControlServer>();

      // Create versionspec's
      VersionSpec versionFrom = null;
      if (!string.IsNullOrEmpty(from))
        versionFrom = VersionSpec.ParseSingleSpec(from, null);
      VersionSpec versionTo = VersionSpec.Latest;
      if (!string.IsNullOrEmpty(to))
        versionTo = VersionSpec.ParseSingleSpec(to, null);

      // Internally used dictionary
      var changes = new Dictionary<int, ChangeInfo>();

      // Find Changesets that are checked into the branch
      var directChangesets = vcs.QueryHistory(
        serverPath,
        VersionSpec.Latest,
        0,
        RecursionType.Full,
        null,
        versionFrom,
        versionTo,
        Int32.MaxValue,
        true,
        false
        ).Cast<Changeset>();
      foreach (var changeset in directChangesets)
      {
        foreach (var workItem in changeset.WorkItems.Where(workItem => workItem.State == workItemDoneText))
        {
          if (changes.ContainsKey(workItem.Id))
          {
            if (changeset.ChangesetId < changes[workItem.Id].ChangesetId) continue;
          }
          changes[workItem.Id] = new ChangeInfo { ChangesetId = changeset.ChangesetId, ChangesetCreationDate = changeset.CreationDate, WorkItemId = workItem.Id, WorkItemTitle = workItem.Title };
        }
      }

      // Find Changesets that are merged into the branch
      var items = vcs.GetItems(serverPath, RecursionType.Full);
      foreach (var item in items.Items)
      {
        var changesetMergeDetails = vcs.QueryMergesWithDetails(
          null,
          null,
          0,
          item.ServerItem,
          VersionSpec.Latest,
          0,
          versionFrom,
          versionTo,
          RecursionType.Full
        );
        foreach (var merge in changesetMergeDetails.Changesets)
        {
          foreach (var workItem in merge.WorkItems.Where(workItem => workItem.State == workItemDoneText))
          {
            if (changes.ContainsKey(workItem.Id))
            {
              if (merge.ChangesetId < changes[workItem.Id].ChangesetId) continue;
            }
            changes[workItem.Id] = new ChangeInfo { ChangesetId = merge.ChangesetId, ChangesetCreationDate = merge.CreationDate, WorkItemId = workItem.Id, WorkItemTitle = workItem.Title };
          }
        }
      }

      // Return a list sorted by ChangesetId      
      return (from entry in changes orderby entry.Value.ChangesetId descending select entry.Value).ToList();
    }
  }
}

Answer 3

В общем, абсолютный метод определения моментов времени в любом SCM - это явно идентификатор регистрации.
Использование меток для абстрагирования в TFS не является оптимальным, как обсуждалось здесь & здесь .Лучше использовать вместо этого сборки, особенно в современной среде CI.

Чтобы извлечь максимальный набор изменений, который содержался в данной сборке, вам нужно сделать что-то вроде этого:

using System;
using System.Collections.Generic;
using Microsoft.TeamFoundation.Build.Client;
using Microsoft.TeamFoundation.Client;

namespace GetChangesetsFromBuild
{
    class Program
    {
        static void Main()
        {
            TfsTeamProjectCollection tpc = TfsTeamProjectCollectionFactory.GetTeamProjectCollection(new Uri("http://TFSServer:8080/Name"));
            IBuildServer bs = (IBuildServer)tpc.GetService(typeof(IBuildServer));

            IBuildDetail build = bs.GetAllBuildDetails(new Uri("vstfs:///..."));

            List<IChangesetSummary> associatedChangesets = InformationNodeConverters.GetAssociatedChangesets(build);

            int idMax = associatedChangesets[0].ChangesetId; 
        }
    }
}

Сложность с вышеперечисленным состоит в том, чтобы получить BuildUri интересующих вас сборок. Чтобы получить эту информацию, вы можете сделать что-то вроде этого:

IBuildDetail[] builds = bs.QueryBuilds("TeamPorjectName", "yourBuildDefinitionName")

и затем извлекайте Uri, которые важны для вас.

Это также хороший способ, если вы в конечном итоге настаиваете на использовании меток: кроме Uri, каждый build[]также имеет LabelName.

Answer 4

Этот вопрос приблизил меня к решению аналогичной проблемы, с которой я столкнулся.

Используйте тип LabelVersionSpec вместо VersionSpec для версий этикеток.

Заменить:

VersionSpec sFrom = VersionSpec.ParseSingleSpec("LLABEL1", null);
VersionSpec sTo = VersionSpec.ParseSingleSpec("LLABEL2", null);

с:

LabelVersionSpec sFrom = new LabelVersionSpec("LLABEL1");
LabelVersionSpec sTo = new LabelVersionSpec("LLABEL2");