【发布时间】：2014-06-09 07:30:42
【问题描述】：
我们能否从 checkIN 历史记录中获取发布信息。
我们使用的是 TFS 2012。
我们经常每周或每 14 天发布一次。
我们可以从 TFS 生成发布文档吗？
（类似，基于在 cmets 中检查的 TFS 或其他方式）
【问题讨论】：
标签： tfs release release-management
【发布时间】：2014-06-09 07:30:42
【问题描述】：
一种方法是使用工作项（例如用户故事和错误）来生成您的发行说明。
但这需要您的团队遵守规则，将信息输入 TFS，以便将工作项与发布相关联。例如：
- 要求开发人员将变更集与工作项相关联
- 在工作项中使用“Iteration”或“Integrated in build”等字段来标识工作项所属的版本。
然后您可以创建合适的团队查询并将其导出到 Excel 以生成发行说明。
【讨论】：
我喜欢TFS Changelog 工具。随时可用且易于集成。
TFS ChangeLog 允许 Team Foundation Server (TFS) 用户将与变更集和相关工作项相关的信息提取为 XML 格式，然后再转换为 HTML。
【讨论】：
-
TFS changlog 不再处于活动状态。
我倾向于使用Tf history 命令行工具来获取两个特定日期（或变更集）之间的变更集信息。您可以通过 /format:detailed 参数来获取详细信息，例如所涉及的更改。
例如，下面将列出 01/02/2014 和 24/04/2014 之间的所有更改，并将其写入历史文件。
tf 历史 /noprompt * /recursive /v:D01/02/2014~D24/04/2014 /format:detailed > C:\history.txt
【讨论】：
所有这些都是不错的工具，但我认为仍然缺少一些东西。
- 这些是技术说明（更像是构建/历史说明），但实际的发行说明包含更多客户友好的项目
- 并非客户版本说明中需要 TFS 中的所有信息（内部发现的错误与报告的错误）
到目前为止，我使用TFS Community build manager 来生成技术构建说明。它使用 OpenXML 并且可以很好地为您构建注释。为它创建一个自定义的 Word 文档甚至很容易。
对于发行说明，我们实际上使用 TFS 用户故事/任务来对其进行查询。现在，我们使用查询结果手动创建文档。我们正在研究创建一些可能执行以下操作的工具：
- 运行与文档段落对应的查询
- 我们有一个 TFS 模板字段，指示工作项必须在客户发行说明中（但我们应该将其更改为使用“特殊”迭代等，以消除对自定义字段的需求。
- 自动填充文档中的 OpenXml 占位符，方式与构建注释生成器相同。
- 与 TFS 社区构建管理器一样，您可以创建一个 TFS 社区发行说明管理器，它会询问查询名称并运行这些查询以获取所需的数据。
这里的主要问题是是否已经有工具可以做到这一点？
【讨论】：
我知道这是一个老问题，但也许您可以使用此任务扩展 Generate Release Notes Build Task（用于本地 TFS 或作为 VisualStudio.com 的扩展）。
此扩展是您可以在构建步骤中使用的构建任务。此任务基于传递到工具中的模板生成 Markdown 发行说明文件。以下是发行说明输出的示例：
构建 SampleSolution.Master 的发行说明
内部版本号：20160229.3 内部版本开始时间：29/02/16 15:47:58 来源 分支：refs/heads/master
相关工作项
Task 60 [Assigned by: Bill ] 设计 WP8 客户端相关变更 设置/提交
ID bf9be94e61f71f87cb068353f58e860b982a2b4b 添加了模板 ID 8c3f8f9817606e48f37f8e6d25b5a212230d7a86 项目开始
【讨论】：
-
始终欢迎提供指向潜在解决方案的链接，但请add context around the link，以便您的其他用户知道它是什么以及为什么存在。始终引用重要链接中最相关的部分，以防目标站点无法访问或永久离线。考虑到仅仅是指向外部站点的链接是Why and how are some answers deleted? 的一个可能原因。
-
@Mogsdad 你是对的。我在答案中添加了一些关于外部链接的信息