TFS 2010: Как создать журнал изменений (т.е. список рабочих элементов) между двумя выпусками приложения с использованием меток?
Я ищу способ автоматического создания журнала изменений (фактически списка рабочих элементов) между двумя выпусками моего приложения. У меня есть две версии моего приложения, 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? Спасибо.
Кстати, я нашел несколько вопросов по stackru, но ни один из них не дал мне ответов с метками. Например: Пример вопроса
4 ответа
Я думаю, что http://tfschangelog.codeplex.com/ может помочь вам здесь.
Приложение TFS ChangeLog позволяет пользователям автоматически создавать заметки о выпуске из TFS. Пользователи должны будут предоставить информацию о своем проекте, ветви и диапазоне наборов изменений, а затем приложение TFS ChangeLog извлечет информацию из каждого набора изменений в данном диапазоне и всех связанных рабочих элементов в такие наборы изменений. то есть он будет перемещаться от начального набора изменений до конечного набора изменений и будет извлекать данные о каждом наборе изменений вместе со связанными рабочими элементами в файле XML.
Затем пользователи могут использовать свою собственную логику преобразования, включая фильтр, сортировку, стилизацию, форматирование вывода и т. Д. Для создания отчета о выпуске.
Еще одна вещь, которую я хотел бы добавить, будет связана с метками в TFS. Метки в основном назначаются / ассоциируются с наборами изменений. В настоящее время приложение TFS ChangeLog не поддерживает метки для определения начальной и конечной точки, но поддерживает набор изменений, который можно использовать в качестве обходного решения.
Надеюсь, это полезно.
Я был в той же ситуации, что и вы. Я также хочу, чтобы рабочие элементы из объединенных наборов изменений были включены. Я включаю только рабочие элементы, которые выполнены. Также, если один и тот же рабочий элемент связан с несколькими наборами изменений, сообщается только о последнем наборе изменений. Я использую это в настройке 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();
}
}
}
В общем, абсолютный метод определения моментов времени в любом 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,
Этот вопрос приблизил меня к решению аналогичной проблемы, с которой я столкнулся.
Используйте тип LabelVersionSpec вместо VersionSpec для версий этикеток.
Заменить:
VersionSpec sFrom = VersionSpec.ParseSingleSpec("LLABEL1", null);
VersionSpec sTo = VersionSpec.ParseSingleSpec("LLABEL2", null);
с:
LabelVersionSpec sFrom = new LabelVersionSpec("LLABEL1");
LabelVersionSpec sTo = new LabelVersionSpec("LLABEL2");