跳到主要内容

查看拉取请求(Reviewing)

如果你被标记为拉取请求的审阅者,你可以查看更改、评论、批准或拒绝请求,并将 Forking 的集合或环境合并到父元素中。

审查拉取请求

要访问拉取请求列表,请转到元素并选择 拉取请求图标 右侧栏中的拉取请求图标。每个项目都显示拉取请求的状态,这将OPEN针对任何尚未合并或拒绝的请求。选择拉取请求的名称以将其打开。

拉取请求列表

当你被标记为拉取请求的审阅者时,Postman 会在团队成员创建拉取请求时通知你:

  • 选择 Postman 标题中的通知图标 通知图标 以查看通知。选择查看拉取请求以查看拉取请求。
  • 你还将收到一封电子邮件,其中包含有关拉取请求的标题、拉取请求中包含的元素以及拉取请求的创建者的信息。在电子邮件中选择查看更改以访问 Postman 中的拉取请求。

如果你创建拉取请求并从同一 Postman 帐户对其进行更改,你将不会收到有关对拉取请求所做更改的任何通知。

查看差异

当你查看拉取请求时,了解拉取请求将引入父集合或环境的更改非常重要。fork 和父元素之间的差异称为diff

要查看差异,请执行以下操作:

  1. 在拉取请求中,查看 Changes标题下的差异。

查看拉取请求时查看差异

diff 将告诉你更改是添加、删除还是修改。

作为审阅者添加评论是拉取请求流程的重要组成部分,促进有意义的对话并允许利益相关者在流程中发表意见。

要向拉取请求添加评论,请执行以下操作:

  1. 评论图标 选择要评论的更改旁边的评论图标 。
  2. 写完评论后,选择添加评论

向拉取评论添加评论

要在你的评论中标记其他用户,请在其用户名前使用@符号。

编辑或拒绝拉取请求

你可以在批准拉取请求之前编辑拉取请求的详细信息,也可以拒绝它。

刷新、编辑或拒绝拉取请求

要编辑拉取请求详细信息,请执行以下操作:

  1. 更多操作图标 选择右上角的更多操作图标 ,然后选择编辑
  2. 对拉取请求的标题、描述和审阅者列表进行任何更改。
  3. 选择保存更改

如果你不想将拉取请求合并到父元素中,你可以拒绝它。你无法重新打开已拒绝的拉取请求,因此如果你想请求编辑或提供反馈, 请改为添加评论

要拒绝拉取请求,请执行以下操作:

  1. 更多操作图标 选择右上角的更多操作图标 ,然后选择拒绝
  2. 选择拒绝拉取请求

批准拉取请求

如果你被标记为拉取请求的审阅者,你可以批准拉取请求。

要批准拉取请求,请选择批准

如果你需要撤销批准,请选择取消批准

批准拉取请求

批准拉取请求后,其在拉取请求列表中的状态为APPROVED

批准的拉取请求

在拉取请求期间拉取更新

你可以使 Forking 的集合和环境与父元素的任何更改保持同步,例如,如果另一个团队成员已将更改合并到父元素中。

  1. 创建拉取请求。 Postman 将警告你自上次更新以来父元素已更改。

  2. 选择Pull Changes以使用对父元素的更改来更新你的 Forking。

    拉取最近的更改

  3. 查看差异并选择Pull changes

    将更改拉入 fork

要在不打开拉取请求的情况下从父元素拉取更新,请参阅 从父元素拉取更新

合并来自拉取请求的更改

当你准备好从拉取请求中添加更改时,你会将它们合并到父集合或环境中。在请求的审阅者批准拉取请求后,你可以将其合并到父元素中。

  1. 从批准的拉取请求中,选择Merge

    合并拉取请求

    如果父元素自你上次更新你的 Forking 以来有任何更改,你可以在合并之前 提取这些更改。

  2. 选择以下合并选项之一:

    • 合并更改- 将更改合并到父元素中。这不会对 Forking 进行任何更改。你必须拥有对父元素的编辑访问权限。
    • 合并更改和更新源- 将更改合并到父元素中。父元素中的任何差异也会影响分支。你必须拥有对父实体和分支实体的编辑访问权限。
    • 合并更改并删除源- 将更改合并到父元素中。合并过程完成后,Postman 删除 Forking。你必须拥有对父实体和分支实体的编辑访问权限。

    合并Forking选项

  3. 选择合并

要在不打开拉取请求的情况下合并来自 Forking 的更改,请参阅 合并来自 Forking 的更改

解决来自拉取请求的冲突

当你尝试将更改合并到更新的父元素中并且 Postman 无法自动解决两者之间的差异时,就会发生合并冲突。如果在你尝试合并拉取请求时发生冲突,你需要在继续之前决定如何解决它们。

合并冲突可能涉及多个工作空间中的更改。

要解决来自拉取请求的合并冲突,请执行以下操作:

  1. 开始创建拉取请求 中描述的拉取请求过程。

  2. 选择更改以查看合并冲突中的更改。

  3. 选择“解决冲突”以解决 Forking 元素和父元素之间的合并冲突。

    你还可以选择“为任何冲突拉取更改”

    解决冲突

  4. 对于每个冲突,选择合并时要包括的版本。选择保留源以保留对父元素的更改。选择Keep Destination以保留 Forking 上的更改。你还可以为每个冲突选择要保留的版本。

    拉动变化

要保留 Forking 上的所有更改,请选择Keep all changes to source。要保留对父元素的所有更改,请选择Keep all changes to destination

解决冲突后,选择Pull changes拉取更新