查看拉取请求(Reviewing)
如果你被标记为拉取请求的审阅者,你可以查看更改、评论、批准或拒绝请求,并将 Forking 的集合或环境合并到父元素中。
审查拉取请求
要访问拉取请求列表,请转到元素并选择 右侧栏中的拉取请求图标。每个项目都显示拉取请求的状态,这将OPEN
针对任何尚未合并或拒绝的请求。选择拉取请求的名称以将其打开。
当你被标记为拉取请求的审阅者时,Postman 会在团队成员创建拉取请求时通知你:
- 选择 Postman 标题中的通知图标 以查看通知。选择查看拉取请求以查看拉取请求。
- 你还将收到一封电子邮件,其中包含有关拉取请求的标题、拉取请求中包含的元素以及拉取请求的创建者的信息。在电子邮件中选择查看更改以访问 Postman 中的拉取请求。
如果你创建拉取请求并从同一 Postman 帐户对其进行更改,你将不会收到有关对拉取请求所做更改的任何通知。
查看差异
当你查看拉取请求时,了解拉取请求将引入父集合或环境的更改非常重要。fork 和父元素之间的差异称为diff。
要查看差异,请执行以下操作:
- 在拉取请求中,查看 Changes标题下的差异。
diff 将告诉你更改是添加、删除还是修改。
作为审阅者添加评论是拉取请求流程的重要组成部分,促进有意义的对话并允许利益相关者在流程中发表意见。
要向拉取请求添加评论,请执行以下操作:
- 选择要评论的更改旁边的评论图标 。
- 写完评论后,选择添加评论。
要在你的评论中标记其他用户,请在其用户名前使用@符号。
编辑或拒绝拉取请求
你可以在批准拉取请求之前编辑拉取请求的详细信息,也可以拒绝它。
要编辑拉取请求详细信息,请执行以下操作:
- 选择右上角的更多操作图标 ,然后选择编辑。
- 对拉取请求的标题、描述和审阅者列表进行任何更改。
- 选择保存更改。
如果你不想将拉取请求合并到父元素中,你可以拒绝它。你无法重新打开已拒绝的拉取请求,因此如果你想请求编辑或提供反馈, 请改为添加评论 。
要拒绝拉取请求,请执行以下操作:
- 选择右上角的更多操作图标 ,然后选择拒绝。
- 选择拒绝拉取请求。
批准拉取请求
如果你被标记为拉取请求的审阅者,你可以批准拉取请求。
要批准拉取请求,请选择批准。
如果你需要撤销批准,请选择取消批准。
批准拉取请求后,其在拉取请求列表中的状态为APPROVED
。
在拉取请求期间拉取更新
你可以使 Forking 的集合和环境与父元素的任何更改保持同步,例如,如果另一个团队成员已将更改合并到父元素中。
创建拉取请求。 Postman 将警告你自上次更新以来父元素已更改。
选择Pull Changes以使用对父元素的更改来更新你的 Forking。
查看差异并选择Pull changes。
要在不打开拉取请求的情况下从父元素拉取更新,请参阅 从父元素拉取更新 。
合并来自拉取请求的更改
当你准备好从拉取请求中添加更改时,你会将它们合并到父集合或环境中。在请求的审阅者批准拉取请求后,你可以将其合并到父元素中。
从批准的拉取请求中,选择Merge。
如果父元素自你上次更新你的 Forking 以来有任何更改,你可以在合并之前 提取这些更改。
选择以下合并选项之一:
- 合并更改- 将更改合并到父元素中。这不会对 Forking 进行任何更改。你必须拥有对父元素的编辑访问权限。
- 合并更改和更新源- 将更改合并到父元素中。父元素中的任何差异也会影响分支。你必须拥有对父实体和分支实体的编辑访问权限。
- 合并更改并删除源- 将更改合并到父元素中。合并过程完成后,Postman 删除 Forking。你必须拥有对父实体和分支实体的编辑访问权限。
选择合并。
要在不打开拉取请求的情况下合并来自 Forking 的更改,请参阅 合并来自 Forking 的更改 。
解决来自拉取请求的冲突
当你尝试将更改合并到更新的父元素中并且 Postman 无法自动解决两者之间的差异时,就会发生合并冲突。如果在你尝试合并拉取请求时发生冲突,你需要在继续之前决定如何解决它们。
合并冲突可能涉及多个工作空间中的更改。
要解决来自拉取请求的合并冲突,请执行以下操作:
开始创建拉取请求 中描述的拉取请求过程。
选择更改以查看合并冲突中的更改。
选择“解决冲突”以解决 Forking 元素和父元素之间的合并冲突。
你还可以选择“为任何冲突拉取更改”。
对于每个冲突,选择合并时要包括的版本。选择保留源以保留对父元素的更改。选择Keep Destination以保留 Forking 上的更改。你还可以为每个冲突选择要保留的版本。
要保留 Forking 上的所有更改,请选择Keep all changes to source。要保留对父元素的所有更改,请选择Keep all changes to destination。
解决冲突后,选择Pull changes以 拉取更新 。