跳到主要内容

查看拉取请求(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以 拉取更新 。