关于通过Polarion API获取文档修订号及自动管理的技术咨询

1. 如何获取新分支文档的修订号 #

• 分支创建完成后，调用文档详情API即可拿到目标修订号，API路径格式为/polarion/ws/rest/v1/projects/{projectId}/spaces/{spaceId}/documents/{documentId}，返回的JSON数据里revision字段就是当前文档的头部修订号。
• 分支操作的返回结果通常仅包含文档基础属性，不会自动携带修订号，因此必须在分支创建后单独发起GET请求拉取文档详情。
• 若使用SOAP API，调用getDocument方法也能返回包含revision属性的完整文档对象。

2. 脚本跟踪与自动变更修订号 #

• 跟踪修订号：两种实用方式可选：
  • 定时轮询文档详情API，定期获取最新修订号；
  • 配置Polarion的Webhook，监听文档modified事件，一旦有变更就自动触发脚本获取新修订号。
• 自动变更修订号：所有文档修改类API（如REST的updateDocument、SOAP的updateDocument）都要求传入当前修订号作为参数，用于版本一致性校验。标准流程为：先获取最新修订号 → 携带该修订号发起修改请求 → 操作成功后更新本地记录的修订号。
• 多步骤自动化：每一步修改前都必须重新拉取最新修订号，因为前一步操作可能已更新版本号，跳过此步骤会触发版本冲突错误。例如步骤1修改完成后，立即获取新修订号，再用该号执行步骤2的修改操作。

内容的提问来源于stack exchange，提问作者Alicemirror