如何通过Polarion的Web Service Client API在LiveDoc中插入已有工作项？

针对你遇到的没有直接API插入已有WorkItem到LiveDoc/module的情况，有两个可行的间接方案，都可以用通用Web Service Client实现：

方案1：复制+替换占位符 #

• 先调用createWorkItemInModule接口，在LiveDoc的目标插入位置创建一个临时占位工作项（可以设置特殊标题标识，方便后续识别）
• 使用copyWorkItem接口，将目标已有WorkItem复制到临时项所在位置，复制时保留原WorkItem的所有属性
• 调用deleteWorkItem接口删除之前创建的临时占位项
• 优势：不需要移动原WorkItem的原始位置，适合原WorkItem需要保留在其他模块的场景

方案2：移动+调整顺序 #

• 如果目标WorkItem允许从当前位置移动，先调用moveWorkItemBetweenModules接口，将其移动到目标模块的末尾（部分Polarion版本也支持用addWorkItemToModule直接添加已有项到模块）
• 调用moveItemInModule接口，指定目标位置的前后项，把刚移动过来的WorkItem调整到需要的插入点
• 优势：不需要创建临时项，操作步骤更少，适合原WorkItem可以脱离原模块的场景

注意事项 #

• 权限校验：确保Web Service账号拥有目标模块的编辑权限，以及对目标WorkItem的读取/移动/复制权限
• 版本冲突：操作前先获取模块的最新版本号，执行修改后校验版本，避免并发修改导致内容丢失
• 属性同步：复制或移动后，检查原WorkItem的模块关联属性（比如自定义字段、模块内排序依赖）是否需要手动同步到新位置的项中

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