将 Azure DevOps 连接到 GanttFather，使用审阅 Pull 和 Push，并在不暗示自动同步的情况下建立本地依赖关系。
GanttFather 可以将 Azure DevOps 工作项拉入交互式甘特图，并通过审阅 Push 发布映射的日期和状态。它不是自动双向同步：设置会执行第一次 Pull，后续 Pull 和 Push 由用户触发，并且不会在后台运行 Webhook 或计划。
产品行为已于 2026 年 8 月 30 日根据当前 GanttFather 集成合同和 Microsoft Azure DevOps 文档进行验证。
Azure DevOps 集成有什么作用？
GanttFather 项目可以与多个源进行 1 个 Azure DevOps 集成。每个源都可以代表已保存的查询或支持的待办事项板。拉取读取工作项并创建或更新映射的 GanttFather 任务；重复拉取会更新相同的映射任务，而不是故意创建重复任务。
集成映射规划字段，例如标题、描述、状态、优先级、日期、估计和父/子层次结构（如果可用）。审阅 Pull 和独立的同步来源操作决定如何应用新的 Azure 修订；估算仅从 Azure 读取。
| 能力 | 目前的行为 |
|---|---|
| 初始导入 | 保存七步设置流程时会启动第一次 Pull |
| 稍后刷新 | 所有者或管理员触发拉取 |
| 自动节奏或 webhook | 不可用 |
| 多种来源 | 保存的查询和板源可以共享一个集成 |
| 父/子层次结构 | 存在时导入 |
| 前任/后继链接 | 未导入到 GanttFather 依赖项中 |
| 审阅 Push | 单独的预览、审查、选择和确认流程 |
| MCP 集成控制 | 不可用 |
如何将 Azure DevOps 连接到 GanttFather？
所有者或管理员打开项目设置并启动 Azure DevOps 设置流程。
- 连接： 输入组织 URL 和 Personal Access Token，然后完成“测试连接”。
- 项目： 选择该令牌可访问的 Azure DevOps 项目。
- 来源： 选择已保存的查询或团队看板；对于看板，选择单层或完整树。
- 类型： 检查要导入的计划工作项类型。
- 日期和工作量： 为每个包含的类型映射开始、结束和可选工作量字段。
- 状态： 将检测到的 Azure 状态映射到准确的 GanttFather 项目状态，并检查 Push 使用的状态。
- 目标： 选择目标父任务，检查摘要并保存。保存会启动第一次 Pull。
添加来源 会复用已保存的连接和项目，从来源开始执行最后五个步骤。配置字段 使用相同的五步模型，但会在日期和工作量（第 3/5 步）打开；通过“返回”可检查类型和来源。
发现和 Pull 需要项目/团队读取和工作项读取权限。Push 需要工作项读写权限。GanttFather 会加密存储 PAT，并且不会在集成响应中返回它。
在项目中，Azure 快捷入口和 数据与同步 只显示日常使用的 从 Azure Pull 和 Push 到 Azure。初始导入在七步设置流程中完成；完整的 同步来源 是“设置”中的维护操作。
从快捷入口、设置或 数据与同步 打开 Pull 或 Push 时，如果上一次比较已经完成，系统会向服务器请求新的比较，以便审阅包含最新的 Azure 更改。只有在同一来源的检查仍在进行时再次打开，才会共享该进行中的请求。
拉动过程中会发生什么？
从 Azure Pull 会在更改时间线前打开已映射项目的审阅比较。仅 Azure 的更改会被选中；同一值在两端都更改时，默认保留本地日期或状态。正常 Pull 保持简洁；高级设置默认折叠，其中包含 保留我的更改 和 从 Azure 恢复。
即使更改数为零，也可以查看 Pull。如果缺少预期更新，检查映射字段 会打开设置 → 集成并突出显示相应的 配置字段 操作。同步来源 仍是独立的完整协调操作，用于来源成员、新工作、层级结构和已离开来源的项目。
拉取不会仅仅因为源或集成被删除而删除导入的任务。关闭或删除的外部项目遵循集成记录的映射行为。检查源结果，而不是假设单击“拉取”就意味着每条记录都发生了更改。
导入后应该如何对依赖关系进行建模？
Azure DevOps 交付计划可以可视化工作项之间的链接，但 GanttFather 的导入程序不会将 Azure 前驱/后继链接类型转换为本地任务依赖项。当您需要关键路径分析时，在 GanttFather 中添加并维护 FS、SS、FF 或 SF 关系。
这种分离避免了文章承诺不可见的链接镜像。Azure DevOps 提供映射的工作项字段，GanttFather 保存本地计划和依赖关系模型；发生映射字段冲突时，任何一方都不会自动胜出。审阅 Pull 默认保留冲突的本地日期或状态，选择 从 Azure 恢复 会明确让 Azure 胜出，而在审阅 Push 中确认 发送 会让 GanttFather 对所选映射日期和状态明确胜出。独立的完整 同步来源 流程仍是从 Azure 到 GanttFather 的协调。
有关完整的依赖关系工作流程，请阅读 如何在甘特图上对 Azure DevOps 依赖关系进行建模。
审阅 Push 如何运作？
Push 是明确的审阅操作。符合条件的本地日期和状态更改（包括冲突）默认被选中。如果选中的项目在 Azure 中也发生了更改，信息提示会说明“发送”将保留所选 GanttFather 值，并覆盖更新的 Azure 映射值。可在高级设置或详细信息中排除冲突；先 Pull 是可选的。
从提示中选择 审阅 Pull 会在同一对话框中切换方向并展开高级设置，立即显示 保留我的更改 和 从 Azure 恢复。保留我的更改 · 关闭 不会启动操作，并会关闭整个同步流程而不返回来源选择器。成功的 Pull 和 Push 在结果确认后也会关闭对话框。估算值归 Azure 所有，永远不会被 Push。
如果所选开始或结束日期与 Azure 中当前的另一日期组成无效范围，发送会在发布前被禁用，并且不会向 Azure 写入任何内容。审阅 Pull 会展开高级设置，以便恢复一致的日期范围；也可以关闭对话框并调整本地日期。
使用具有该操作的工作项写入权限的 PAT。当 Azure DevOps 自生成以来发生更改时刷新预览。切勿将加入同意或读取范围的令牌视为发布许可。
什么时候应该使用交付计划？
当团队需要 Azure DevOps 内的本机跨团队日历视图、汇总进度和依赖关系可视化时，请使用 Azure DevOps 交付计划。 Microsoft 文档表明 Azure DevOps 不提供本机甘特图。当您需要单独的交互式甘特计划、四种依赖性类型、浮动和关键路径分析时，请使用 GanttFather。
这些工具可以共存，但它们的链接和计算的时间表并不自动相同。
GanttFather 何时与 Azure DevOps 一起有用？
当 Azure Boards 仍然是工作项记录系统但交付领导者需要有重点的计划模型时，GanttFather 很有用。提取您想要可视化的字段，添加本地依赖关系逻辑，并与不需要编辑 Azure Boards 的利益相关者共享生成的时间线。
集成是受控且可审查的：它不提供连续的双向同步，不导入 Azure 前驱/后继链接，并且无法通过 GanttFather 的 MCP 服务器触发。
GanttFather 开放 并在扩展映射之前测试与一个非生产源的集成。
常见问题
Azure DevOps 连接是实时双向同步吗？
不可以。审阅 Pull 和 Push 是单独的用户操作。当前集成中没有 Webhook 或循环调度程序。
GanttFather 是否导入 Azure DevOps 依赖项？
它会导入存在的父/子层次结构，但不会将 Azure 前驱/后继链接导入为 GanttFather 任务依赖项。
谁可以配置或运行集成？
项目所有者或管理员。成员、访客、代理和陌生人无法访问集成端点。
AI 代理可以触发 Azure DevOps 通过 MCP 的拉动吗？
否。当前 MCP 工具界面不公开集成设置、触发器或状态工具。
删除集成是否会删除导入的任务？
不会。它会删除集成记录和映射；导入的任务仍保留在 GanttFather 项目中。
我应该使用哪个 Azure DevOps 视图进行本地规划？
交付计划提供了 Microsoft 跨团队的本机面向日历的视图，并且可以显示依赖关系。它不是具有与 GanttFather 相同的进度分析模型的完整甘特图。
