如何通过OpenProject API创建子工作包并建立父子关联

我之前折腾OpenProject的时候也碰到过这个问题——官方文档只提了普通关联类型，没明确说父子关联怎么弄，后来翻了社区讨论加自己试，终于搞定了，给你一步步说清楚：

1. 先创建对应的父子关联类型 #

OpenProject本身支持层级关联，只是需要先在系统层面配置好对应的关联类型：

• 登录OpenProject的管理员账号，进入系统设置 → 工作包 → 关联类型
• 点击“新建关联类型”，填写以下关键配置：
  • 名称：可以填“父子关联”（只是后台标识，不影响前端显示）
  • 关联方向：选择双向非对称（因为父和子是有明确层级关系的，不是对等的）
  • 正向名称：比如填Is parent of（当A关联B时，前端显示“A is parent of B”）
  • 反向名称：比如填Is child of（反向显示“B is child of A”）
  • 一定要勾选**允许层级（Allow hierarchy）**这个选项！这是让关联能在树视图里正常展示层级的核心
• 保存这个关联类型

2. 在工作包中设置父子关联 #

配置好关联类型后，就可以给工作包绑定父子关系了：

• 打开需要设置为“子工作包”的详情页，切换到关联标签页
• 点击“添加关联”，在下拉菜单里选择刚才创建的Is child of类型
• 在搜索框里输入父工作包的名称或ID，选中对应的工作包后保存
• 回到父工作包的关联标签页，你会看到自动生成了Is parent of的关联项，父子关系就正式建立好了

3. 开启层级视图展示父子结构 #

要直观看到父子工作包的层级，需要在工作包列表里开启树视图：

• 进入项目的工作包列表页面，点击右上角的显示设置图标
• 在“视图模式”里选择层级视图，保存设置后，子工作包就会缩进显示在父工作包下方，还可以点击父工作包展开/折叠查看子项

额外技巧：批量设置父子关联 #

如果有大量工作包需要设置父子关系，手动一个个加太麻烦，可以用CSV导入：

• 导出现有工作包的CSV模板，在模板里添加一列Parent ID
• 给每个子工作包的Parent ID字段填入对应父工作包的ID
• 导入CSV时，在字段映射里把Parent ID映射到“父工作包ID”即可批量完成关联

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