OpenProject 工作包(Work Packages)完全指南:创建、编辑、日期调度、关系层级与导出实战
【免费下载链接】openprojectOpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub项目地址: https://gitcode.com/GitHub_Trending/op/openproject
工作包(Work Package)是 OpenProject 中承载项目执行的最小业务单元,覆盖任务、特性、风险、用户故事、缺陷与变更请求等场景。本文以官方用户指南docs/user-guide/work-packages/README.md为核心骨架,完整讲解工作包的视图体系、创建与编辑、日期与工期调度、关系与层级、基线对比、共享、自动主题以及表格配置与导出,并辅以仓库源码证据(如app/models/relation.rb中的关系类型定义),帮助你在真实项目中高效落地。
什么是工作包(Work Package)
工作包是项目中的条目(例如任务、特性、风险、用户故事、缺陷、变更请求)。它捕获重要信息,并可以被分配给项目成员执行。每个工作包都具备以下基本属性:
- 类型(Type):工作包可以表示的不同条目,例如任务(task)、特性(feature)、缺陷(bug)、阶段(phase)、里程碑(milestone)。工作包类型可以在系统管理(system administration)中配置。
- ID:分配给新创建工作包的唯一标识符。
- 主题(Subject):工作包的名称/标题。
- 附加属性:状态(Status)、受派人(Assignee)、优先级(Priority)、截止日期(Due date)等。
工作包 ID 的两种编号规则
工作包 ID是分配给新创建工作包的唯一标识符。默认情况下,OpenProject 使用实例级的数值序列(例如#12345)。管理员也可以启用基于项目的标识符,它将项目标识符与序号组合在一起(例如PROJ-123)。
工作包标识符不能手动编辑,并将在整个生命周期内始终与该工作包关联。
工作包类型的配置
类型是工作包可以表示的不同条目。工作包类型可在系统管理中配置;同时,每个项目需要激活工作包模块(work package module)才能使用工作包功能。工作包可以显示在项目时间线(timeline)中,例如作为里程碑或阶段。
在源码层面,工作包模型定义在 app/models/work_package.rb,是所有工作包行为(日期、关系、状态流转)的核心载体。
工作包视图(Work packages views)
在 OpenProject 中,视图(view)是基于一组过滤条件的工作包列表,显示满足这些条件的所有工作包。每个项目的工作包模块默认包含以下视图:
| 默认视图 | 内容 |
|---|---|
| All open(所有打开) | 所有未关闭(状态未定义为 closed)的工作包,按 ID 升序排列(最小编号在最上方) |
| Latest activity(最近活动) | 所有打开和关闭的工作包,按最后更新时间降序排列 |
| Recently created(最近创建) | 所有打开的工作包,按创建时间降序排列 |
| Overdue(逾期) | 完成日期已过去的所有打开工作包,按逾期时长降序排列 |
| Summary(汇总) | 按类型、状态、优先级、受派人、责任人、作者、版本、类别和子项目分组的工作包数量表格概览 |
| Created by me(我创建的) | 当前用户创建的所有工作包,按最后更新时间降序排列 |
| Assigned to me(分配给我的) | 分配给当前用户的所有工作包,按最后更新时间降序排列 |
| Shared with users(与用户共享) | 所有已与用户或群组共享的工作包 |
你还可以创建、保存和修改自己的工作包视图,它们将显示在Private(私有)视图下;如果将可见性设置为Public(公共)或Favorite(收藏),则会显示在对应的视图分区下。
视图模式(View modes)
任何视图中的工作包都可以用多种方式展示,这些模式展示同一组工作包但呈现方式不同:
- 表格视图(Table view):将所选属性作为列,以表格形式显示所有工作包。
- 分屏视图(Split screen view):点击工作包行最右端的信息图标打开;也可通过表格右上角过滤器按钮旁的信息按钮启用或停用。分屏开启后,点击表格中的某行即可在右侧分屏中查看其详情。
- 全屏视图(Full screen view):在表格中双击某行即可全屏展示该工作包的全部详情;也可在分屏视图头部(Watcher 旁)点击全屏图标。返回表格视图可使用浏览器的返回箭头。
- 甘特图视图(Gantt view):见 gantt-chart。
- 看板视图(Board view):见 boards-introduction。
创建工作包(Create Work packages)
OpenProject 提供多种创建工作包的方式,可满足从快速录入到精细填写的不同需求:
- 通过顶部导航从应用任意位置创建;
- 在工作包表格中内联创建,快速批量新建;
- 在分屏视图中创建,从一开始就录入详细信息。
通过顶部导航创建
点击顶部导航栏中的绿色+按钮,直接选择一种工作包类型。表单打开后,你可以指定项目、名称、描述、优先级、日期等;根据所选类型,表单可能包含额外的必填字段。
[!TIP] 如果你尚未选择项目,受派人(Assignee)和责任人(Accountable)将没有可选值。一旦选择项目,该项目成员即可被选为受派人与责任人。
在工作包模块中创建
选择一个项目,进入左侧项目菜单中的Work packages模块(也可使用全局工作包模块),点击表格上方的+ Create按钮并选择工作包类型。
在表格视图中内联创建
点击表格下方的+ Create new work package链接,新工作包会以高亮行出现在表格中。直接输入主题,并在表格中就地修改类型、状态等属性,按Enter保存。这种方式适合快速连续创建多个工作包。
在分屏视图中创建
在工作包模块中点击绿色+ Create按钮并选择类型,新工作包表单将在分屏视图中打开,可从一开始就填写描述、受派人、状态、优先级、截止日期等信息,点击Save保存。
为工作包添加表情符号
所有文本编辑器(包括工作包描述)都支持表情符号:输入冒号和字母(例如:a)即可获得可用表情的建议列表。
添加附件
- 可以将图片直接复制粘贴到工作包描述中,或使用描述上方工具栏的Insert image图标;
- 在工作包表单底部,可以通过拖放或从文件夹选择文件上传附件。
[!TIP] 非项目成员也可以在被授予权限后向工作包添加附件(例如用于确认缺陷报告),前提是管理员已授予相应权限。
[!NOTE] 你还可以使用 Nextcloud、OneDrive 或 SharePoint 集成,将文件上传到文件存储或将已有文件/文件夹链接到工作包的Files标签页。
设置与修改日期和工期(Set and change dates and duration)
OpenProject 提供两种工作包调度模式:手动(Manual)和自动(Automatic),在保证任务间逻辑依赖的同时提供项目规划的灵活性。
[!NOTE] OpenProject 15.4 在手动调度之外引入了新的自动调度模式。默认情况下,所有新建工作包都设置为手动调度。
打开日期选择器
你可以通过以下任一入口打开日期选择器:
- 点击工作包全屏视图中的日期字段;
- 点击分屏视图中的日期字段(可从任意视图进入,包括通知中心、团队规划器、看板等);
- 点击表格视图中的开始日期、完成日期或工期字段。
日期选择器包含以下元素:
- 信息横幅:位于日期选择器顶部,说明当前调度模式以及因既有工作包关系可能存在的日期约束;该横幅只对有关系的工作包显示。
- Show relations 按钮:打开甘特图视图,展示所有直接相关的工作包。
- 关系标签页:查看当前工作包的前置任务(predecessors)、后续任务(successors)或子任务(children)。
- 调度模式开关:在手动与自动模式之间切换。
- Working days only 开关:选择只按工作日还是按所有日历日计算总工期。
- 开始日期、完成日期和工期输入字段。
- 迷你日历:用于日期范围预览。
- 保存与取消按钮。
信息与警告横幅
日期选择器顶部的横幅提供变更日期/调度模式时的关键上下文信息:
- 信息横幅(蓝色或黄色背景):有帮助但不关键的信息,例如在自动调度模式下相关工作包(前置任务或子任务)正在为当前工作包设定日期、手动模式下前置任务与当前工作包之间存在间隔或日期重叠。
- 警告横幅(橙色背景):关键信息,可能对项目排程产生较大影响。
[!NOTE] 当信息横幅与警告横幅同时适用时,只显示更重要的警告横幅。
日期选择器标签页
除默认的Dates标签页外,日期选择器还包含以下关系相关标签页:
- Predecessors(前置任务):必须在前置任务完成后才能开始当前任务的依赖。在自动模式下,当前工作包日期来源的最近前置任务会标记“closest”标签。
- Successors(后续任务):当前任务结束后才开始的后续任务。在自动模式下,后续任务的开始日期受当前工作包完成日期影响。
- Children(子任务):当前工作包下的子任务。如果工作包有子任务,则默认为自动调度模式,父工作包的开始与完成日期将覆盖其所有子工作包的日期范围。
[!TIP] 标签名称旁的数字表示相关工作包的数量。
手动调度模式(Manual scheduling)
手动调度适用于需要固定日期的场景,例如依赖关系尚不确定或未定义时。启用手动调度后,你可以设置任意开始/结束日期,忽略follows/proceeds(前置/后续)或children(子任务)等依赖关系。在日期选择器的Scheduling mode开关中点击Manual即可启用。
在手动模式下,父与子工作包在调度上不再关联:父日期不会随子日期调整,子任务也可以安排在父范围之外。这些关系在甘特视图中仍然可见,但在切换回自动模式前不会影响调度。
从自动切换到手动时,警告横幅会提示follows/precedes与parent/child关系现在被忽略。
[!TIP] 从 OpenProject 15.4 引入新自动模式起,手动调度成为新建工作包的默认模式。
自动调度模式(Automatic scheduling)
自动调度适用于存在依赖的工作包。一个工作包只有在前置任务或子任务存在时才能处于自动调度模式。
- 带有前置任务的自动调度工作包将在最近前置任务完成日期的后一个工作日自动开始;
- 你可以通过修改工期或完成日期来调整后续任务的日期;由自动调度推导出的开始日期之前的日期将不可用(完成日期必须不早于开始日期);
- 即使前置任务日期发生变化,这种时间关系仍会保持:例如前置任务因完成日期或工期变化而前后移动时,自动调度的工作包也会相应改变开始日期,从而形成自动适应规划变更的可靠工作包链条。
单日期模式、单日事件与范围模式
- 单日期模式(Single-date mode):默认情况下新建工作包从单日期模式开始,只有Finish date字段可用;点击+ Start date可进入范围模式,也可通过清除完成日期回到只有开始日期的单日期模式。若管理员启用了“使用当前日期作为新工作包开始日期”的设置,则开始日期始终被设置并作为激活日期。
- 单日事件(One-day events):只有开始日期或只有完成日期的工作包会被自动视为单日事件;要让工作包(如里程碑)在同一天开始和结束,只需连续点击同一天两次。
- 范围模式(Range mode):工作包同时具有开始与完成日期,因此也具备工期。
日期输入技巧
- 键入日期需使用 ISO 8601 标准格式YYYY-MM-DD(如
2022-10-12),但会按你的区域/语言格式显示; - 点击日期字段下方的Today可快速设置今天;
- 在迷你日历中先点开始日期,再悬停预览日期范围,最后点击完成日期;
- 点击字段中的clear 图标("×")可清除日期;
- 高级功能:可以逆序选择日期(先点开始日期再回点更早的日期,则更早的日期成为开始日期);已具备开始/完成日期的工作包可以只调整完成日期;范围模式下清除另一个日期并保存即回到单日期模式。
日期变更会记录在工作包的Activity标签页中。
Show relations 按钮
信息/警告横幅上的Show Relations按钮会打开新标签页,以层级模式在甘特视图中显示与当前工作包的全部直接关系。
[!NOTE] 该预览仅展示可能影响当前工作包排程的直接关系,不显示二级及以上的关系。完整概览请使用项目工作包表格视图或甘特视图配合所需的过滤/视图配置。
工作日与工期(Working days and duration)
工作日由 OpenProject 实例的管理员定义,默认是周一至周五,周六周日为非工作日。
- Working days only 开关默认开启:调度和工期推导会跳过周末(或定义为非工作日的日期),非工作日以更深的颜色标记且不可点击,工作包不能在非工作日开始或完成,这些天也不计入工期;关闭后,之前禁用的非工作日变为可调度日期并计入工期。
- 工期(Duration)始终以天为单位,是开始与完成日期之间的总天数(含两端)。工期可以由日期自动推导,也可以手动输入——聚焦工期字段后直接输入天数数字即可(无需输入"天"字)。
不同场景下的工期计算
- 开始与完成日期都存在时:工期自动推导。例如开始日期为 2022-10-12(周三)、完成日期为 2022-10-14(周五),则工期为 3 天。此时修改工期会更新完成日期:Working days only 开启时(假设周末非工作日)改为 4 天,完成日期自动设为 2022-10-17(周一);关闭时则设为 2022-10-15(周六)。
- 只存在一个日期时:工作包不能同时只有一个日期和工期。范围模式下另一日期会自动推导(如设置开始日期 10-12 和 3 天工期,完成日期推导为 10-14);单日期模式下工期字段不可用。
- 无日期、仅有工期时:适合只有大致工时估算、尚无确切日期的阶段规划。一个实用技巧是:创建一系列代表主要阶段的工作包,设置各阶段的估算工期并用 follow/precedes 关系链接它们,然后给链上第一个工作包设置开始日期,其余所有工作包的开始与结束日期都会被自动推导。
[!NOTE] precedes-follows 关系可能约束或影响工作包日期,详见 Moving related work packages。
编辑工作包(Edit work packages)
双击表格视图中的工作包行,或打开分屏视图即可编辑。在详情中点击任意字段即可更新(描述、状态、优先级、受派人、评论等)。描述保存点击checkmark图标,其他输入字段用Enter保存;成功后顶部会显示绿色提示消息。
- 本地自动保存:已做的修改会保存在本地;若因技术问题未能保存,可通过编辑器工具栏恢复最近的更改。
- 所有更改都记录在工作包Activity标签页中。
- 注意:无法使用 Ctrl+Z 撤销工作包更改。
链接或创建 Wiki 页面
可以通过富文本编辑器工具栏的Insert→Existing wiki page/New wiki page从描述中链接或创建 Wiki 页面(该功能也适用于会议描述与成果、评论、Wiki 页面内容和Text类型自定义字段)。
- 创建新 Wiki 页面:输入标题;如有多个 Wiki 提供方(如OpenProject内置 Wiki 或企业版配置的XWiki),选择提供方并点击Next(若仅配置一个提供方则自动跳过此步);选择父 Wiki 页面;点击Add创建页面并在描述中插入链接。
- 链接已有 Wiki 页面:跳过命名步骤;选择 Wiki 提供方后搜索并选择页面(也可直接输入 URL);点击Add将链接添加到描述。
所有链接的 Wiki 页面都会出现在工作包的Wikis标签页中,其中可能包含:各 Wiki 提供方分区(如OpenProject、XWiki Knowledge Hub)、Mentioned in description(描述中提及)和Referenced in(被引用)分区。可以通过行末的三点菜单移除页面链接,或将“提及/被引用”的页面通过+ Add to related pages转为关联页面。
分配团队成员
工作包区分受派人(Assignee)与责任人(Accountable):责任人对工作包的交付负责,受派人是当前正在处理该工作包的人。从下拉框选择团队成员;若想添加的成员不在列表中,说明其可能还不是项目成员,需要先邀请加入项目。
更新工作包状态
点击详情中的当前状态,从下拉列表选择新状态。注意:状态因工作包类型而异,可在系统管理中配置。
添加与编辑评论
打开工作包的详情视图或分屏视图,在Activity标签页底部有评论输入框。你可以:
- 引用评论:点击评论右侧的More(三点)图标并选择Quote this comment,被引用的评论作者将自动被 @提及并收到回复通知;
- 编辑评论:选择Edit this comment(视权限而定,可能可以编辑他人的评论);
- 复制评论链接:选择Copy link to clipboard,复制指向该特定评论的直接链接。
内部评论(Enterprise add-on)
可以添加只对特定人群可见的评论,即内部评论(internal comments)。更多细节参见 activity 用户指南。
@ 提及通知
通过 @ 提及团队成员,他们会根据其账户设置中的通知设置在 OpenProject 内收到更新通知。详见 notifications。
表情符号
从 OpenProject 13.0 起,所有文本编辑器(包括评论)都支持表情符号,输入:加字母即可触发建议列表。
手动附加文件
在项目设置中启用文件附件功能后,可在详情视图的Files标签页通过拖放或+Attach files上传文件。该标签页会列出所有已上传附件(文件名、上传者、上传时间);悬停附件并点击Delete图标可删除。描述/评论中的图片等附件也计入其中(评论中的附件不显示在 Files 标签页下)。
工作包提醒(Reminders)
点击详情视图中的Reminder(闹钟)图标,可从预定义选项中选择:明天、3 天后、一周后、一个月后、或特定日期/时间。预定义选项默认设为所选日期的上午 9 点;弹窗中可调整日期与时间,并可添加备注(提醒触发时会显示在通知中心)。设置成功后图标会出现角标,再次点击可修改。
[!NOTE] 若同一工作包存在多个通知,提醒将优先显示。若同时存在提醒与日期提醒通知,两者会合并显示。你还可以在账户设置中设置即时邮件通知。
关注者(Watchers)
Watchers是可以添加至工作包以接收变更通知的成员。打开工作包详细视图,在右侧选择Watchers标签页,通过下拉菜单或输入姓名添加成员(也可以添加自己为关注者)。移除关注者:悬停其姓名并点击姓名旁的叉号。注意,若该用户是工作包的作者、受派人或责任人,即使移除关注者仍可能收到通知。
项目属性(Project attributes)
如果管理员为所选工作包类型启用了项目属性,它们会显示并可在工作包的Project attributes标签页中编辑。对项目属性的修改会直接应用到项目本身,并立即反映在项目概览页等所有展示位置。项目属性为整个项目共享,其可用性由管理员按工作包类型配置,且会包含在工作包的PDF 导出中。
批量编辑工作包(Bulk edit)
在表格视图中按住Ctrl键选中多个工作包,点击鼠标右键打开快捷上下文菜单,可对所选工作包批量执行:
- 打开所有选中工作包的详情视图/全屏视图;
- 批量编辑、批量更改项目、批量复制(含层级关系)、批量删除;
- 若 Backlogs 模块已激活,还可批量更改Sprint和Backlog分配(需要Manage sprint items权限)。
页面底部可选择是否发送变更通知——对于大批量更新,建议取消勾选以免用户被邮件淹没。
表格视图中的快捷上下文菜单
在表格视图中右键任意工作包可执行:打开详情视图、打开全屏视图、复制链接到剪贴板、记录工时(Log time)、记录单位成本(Log unit costs)、移动到其他项目(Move to another project)、复制(Duplicate)、在其他项目复制(Duplicate in another project)、删除(Delete)、下载 PDF、下载 Atom、缩进层级(Indent hierarchy)、创建子任务(Create new child)等。对有父工作包的工作包还提供Outdent hierarchy(取消父子关系)选项。
[!TIP] 在 OpenProject 14.5 中,Copy a work package更名为Duplicate a work package,Change project更名为Move to another project。
复制、移动与删除工作包
在表格视图中右键(或点击行末三点菜单),或在详情视图的More functions菜单中选择相应操作:
- 复制(Duplicate):显示一个预填了原工作包值的新表单,可基于现有工作包快速创建和调整新工作包;
- 复制链接到剪贴板(Copy link to clipboard):复制工作包的短链接,便于快速批量复制多个链接;
- 移动到其他项目(Move to another project):将工作包移动到其他项目或子项目,确认后点击Move。你只能移动到自己是成员且被授权执行此操作的项目;若目标项目没有当前工作包类型,会提示激活或选择其他类型。如果工作包有子任务,它们会一并被移动;
- 删除(Delete):删除权限与特定角色绑定(例如系统管理员),因项目而异。
批量操作参见 bulk edit。
工作包表格配置(Work package table configuration)
点击表格右上角的More(三点)图标并选择Configure view,或点击列名行最右侧的Settings图标打开配置:
- 添加/移除列:在Columns标签页中输入属性名搜索添加;点击属性旁的x移除;拖拽可调整列顺序;点击Apply应用。
- 过滤工作包:点击表格顶部的Filter按钮(按钮上的数字表示当前过滤条件数量),通过+ Add filter下拉列表添加条件,可添加任意多个;也支持按自定义字段过滤。大多数选择类属性(如 Assignee)支持is (OR)、is not、is not empty、is empty运算符,多选属性还支持is (AND)。
- 排序:可按特定标准对表格排序。
- 显示设置:可在平铺列表(flat list)、层级模式(hierarchy mode)与分组(group by)之间切换,并支持合计(sum)功能。
- 属性高亮(Attribute highlighting):高亮表格中的特定属性。
- 保存视图:将当前视图保存后即可从项目菜单直接访问。保存时可将可见性设为Public或Favorite,分别显示在对应的视图分区下。完整配置细节参见 work-package-table-configuration。
[!TIP] 过滤工作包表格会临时调整默认工作包类型和状态以匹配过滤值,确保新建的工作包在表格中可见。
工作包关系与层级(Relations and hierarchies)
你可以创建工作包关系(relations)与层级(hierarchies):关系表示两个工作包之间的功能或时间联系(例如前置/后续、阻塞、部分包含等),层级则是一种层次关系(父-子关系)。
创建关系
- 选择工作包,点击Relations打开Relations标签页,点击+ Relation按钮;
- 从下拉菜单选择关系类型;
- 输入目标工作包的 ID 或名称(支持按类型和状态查找,自动补全会给出建议);
- 输入关系描述(双方都可见);
- 按 Enter 并点击Save。
关系类型(源码级定义)
源码 app/models/relation.rb 中定义了完整的关系类型常量,与界面选项一一对应:
| 界面选项 | 源码常量 | 语义 |
|---|---|---|
| Related to | TYPE_RELATES | 在工作包 A 与 B 之间添加链接,成员可立即看到联系 |
| Predecessor (before) / Successor (after) | TYPE_PRECEDES/TYPE_FOLLOWS | 定义两个工作包之间的时间关系,例如 A 前置 B 时 B 的开始日期至少晚于 A 完成日期一天 |
| Duplicates / Duplicated by | TYPE_DUPLICATES | 语义联系(如处理同一任务),修改需手动同步;A 关闭时 B 也会自动关闭(方向相关) |
| Blocks / Blocked by | TYPE_BLOCKS | 状态变更限制:A 阻塞 B 时,B 不能设为关闭/已解决,直到 A 关闭 |
| Includes / Part of | TYPE_INCLUDES | A 包含或从属于 B,无额外效果 |
| Requires / Required by | TYPE_REQUIRES | A 需要或依赖 B,无额外效果 |
| Parent / Child | TYPE_PARENT | 父-子层级关系(单独维护) |
[!TIP] 所选关系状态会自动显示在目标工作包上:例如在工作包 A 中选择 "Blocks" 并指定 B,则 B 会自动显示 "Blocked by" A。 在 15.1 之前,Predecessor (before)称为Precedes,Successor (after)称为Follows。
关系中的 Lag(间隔)
对于前置/后续关系,可以定义lag——两个工作包之间保留的最小工作日数,默认值为 0,也可以为负:
- lag 为 0:后续任务在前置任务完成后的一个工作日后开始;
- lag 为 2:后续任务在前置任务完成后的三个工作日后开始;
- lag 为 -1:后续任务与前置任务完成的同一天开始;
- lag 为 -2:后续任务在前置任务完成前一个工作日开始。
计算 lag 时只考虑工作日:例如前置任务在周三完成、周六周日为非工作日,则 lag 为 -3 时后续任务在上一个周四开始。描述与 lag 字段之后都可以随时编辑。
移动相关工作包
predecessor/successor 是唯一会约束或影响工作包日期的关系。自动调度模式下,后续任务默认在前置任务完成后立即开始,前置任务被延迟时后续任务会自动被推迟;可通过lag制造计划中的间隔。手动调度模式下,具有前置/后续关系的工作包保留关系,但可各自自由排程,后续任务甚至可以安排在完全早于前置任务的时间。
在表格中显示关系
点击表格右上角的三点图标 →Insert columns,搜索关系名称并添加为列。关系列显示每个工作包拥有的该关系类型的数量,点击数字可查看具有该关系的工作包。
工作包层级
工作包可以按层级结构组织,例如将大型工作包拆分为若干小任务:一个父工作包至少有一个子工作包。
添加子工作包有四种方式:
- 在详情视图的Relations标签页中点击+ Relation,选择Create new child(新建)或Child(关联已有工作包);
- 在表格中右键工作包并选择Create new child;
- 在表格中右键并选择Indent hierarchy,将其添加为上方工作包的子任务;
- 在工作包表单中直接包含相关工作包表格(企业版表单配置功能)后,在该表格下直接添加。
创建新子工作包时需要选择类型、输入主题并可添加描述;若所选类型存在必填字段也会一并显示。若当前工作包已有子任务,还可以使用 Children 分区标题中的+Child按钮。
更改父工作包:在详情视图顶部的层级中点击编辑或删除图标;或通过Relations标签页中父关系旁的Delete relation。
显示层级:在表格中确保Subject列可见,点击其旁的图标可展开/收起层级;也可在表格配置中添加Parent列显示父关系信息。Parent列只显示直接子工作包,若要包含更深层级(孙级等),请使用Descendants of过滤器(详见 filtering for descendants)。
[!NOTE] 关系相关日期(children、predecessor、successor)会显示在Relations标签页中。如果你只有部分权限(例如只共享了单个工作包而非整个项目),可以看到关系存在及其日期,但看不到相关工作包的其他详情。
基线对比(Baseline comparison)
基线(Baseline)是一个强大的功能,允许你查看给定时间段内工作包表格的变化。它可以应用于已保存的视图或新的过滤查询,项目经理可借此快速了解一段时间内的变化,便于汇报项目进展与状态。
启用基线
- 点击主工具栏中的Baseline按钮;
- 选择比较基准点:预设选项或输入具体日期和时间;
- 点击Apply启用基线。
社区版:对比昨天
免费的开源社区版(Community edition)始终支持对比昨天以来的工作包变化。
企业版:预设周期、特定日期或自定义日期范围
- 预设周期:Yesterday(昨天,社区版同样可用)、Last working day(最近一个工作日)、Last week(七个工作日前)、Last month(三十个工作日前)。默认比较基准点为相关日期的本地时间上午 8 点,可改为任意时间。这些是相对比较点(如 Yesterday 总指当前日期的前一天),可用于设置“滚动式”基线。
- 特定日期:选择 “a specific date” 并指定过去某日期,视图始终与这一固定日期比较,相当于“冻结”比较基准点。
- 两个特定日期之间:选择 “between two specific dates” 并选取两个过去日期,创建固定基线视图。
理解对比结果
启用基线后,表格顶部会显示图例:比较点/比较周期、新增(现在满足过滤条件的工作包数)、移除(不再满足过滤条件的工作包数)、保持但已修改(仍然满足且被修改的工作包数)。
三种变更图标:
- Added(现在满足过滤条件):现在满足过滤条件但过去不满足的工作包——可能是在比较点之后新建的,也可能是属性变化使其满足条件;注意它们不一定是新建工作包。
- Removed(不再满足过滤条件):在比较周期内被过滤掉的工作包。注意这不代表被删除的工作包——删除的工作包因不保留历史而完全不可见,基线会直接忽略它们。
- Modified(保持但有变更):现在与比较点都满足过滤条件、但某些属性发生变化的工作包。
- 无变化时不显示任何图标。
旧值展示:当变更涉及表格中可见列时,基线会同时显示旧值与当前值:变更的属性单元格有灰色背景,旧值以删除线显示在单元格左上角,新值在其下方。若属性未显示为列,需要先将其添加为列。Spent time和Progress等属性不受基线跟踪,不显示旧值,未跟踪的列头会显示警告图标。
与活动过滤器的关系
基线始终在当前活动过滤器的上下文中比较两个时间点的工作包,更改过滤器可能改变比较结果;不支持在两个不同过滤查询之间比较。Watcher、Attachment content、Attachment file name和Comment等过滤器属性不受基线跟踪,过滤器面板中会有警告图标标记。
共享工作包(Enterprise add-on)
你可以将工作包共享给非项目成员或尚未在实例中注册的用户(后者需要注册后才能查看工作包)。功能受企业版特性work_package_sharing控制。
共享流程
- 打开工作包详细视图,点击Share按钮;
- 弹出的对话框显示已共享用户列表(未共享则为空);
- 按用户类型或角色过滤列表:用户类型过滤器包括Project member(项目成员)、Not project member(非项目成员)、Project group(属于项目内群组的用户)、Not project group(属于项目外群组的用户);角色过滤器包括Edit(可编辑)、Comment(可评论)、View(仅可查看);
- 通过用户名、群组名或邮箱搜索;可从下拉框选择现有用户,或输入新用户邮箱发送注册邀请;可同时添加多个用户或群组;
- 被共享用户默认获得Work Package Viewer角色,但不会自动成为整个项目的成员,并会收到共享通知邮件;
- 之后可通过用户名旁的下拉菜单随时调整权限。
[!NOTE] 要与非成员共享工作包,你需要被分配全局角色create users。若看不到共享选项,请联系管理员。授予edit权限后,即可将该用户设置为工作包的Assignee或Accountable。
共享成功后,Share按钮上会显示共享用户数量。
移除共享权限
点击用户名旁的Remove即可撤销该用户对此工作包的权限——这不会删除用户账户,只撤销此工作包的权限。若要撤销某个用户的所有共享权限,请在项目成员中处理或联系项目管理员。
共享工作包概览
在全局模块中选择Work Packages,应用默认过滤器Shared with users,即可查看所有已共享工作包。默认视图包含Shared with列,列出共享对象;超过两个时显示两个并以上角标指示总数,点击可查看详情。可在特定项目内应用同一过滤器,并保存为私有过滤器。
配置注意
拥有编辑角色的用户可以更新共享工作包的大多数属性(如主题、描述)及状态,状态变更受该角色配置的工作流约束,管理员需要预先设置相应工作流;界面底部会提示管理员配置(见 copying workflows)。
自动主题(Enterprise add-on)
自动主题(Automatic subjects)是预定义的、动态的工作包标题,有助于对重复性任务强制实施一致的命名规范。该功能属于企业版附加功能,需要 Enterprise cloud 或 Enterprise on-premises。
定义与工作原理
管理员可以按工作包类型启用自动主题:定义一个主题模式(subject pattern),包含静态文本与属性引用(如 Author、Start date、自定义字段、父工作包与项目详情)。创建工作包时,主题会根据模式自动生成并在之后持续更新。
示例模式:
- 请假申请:
[Author] [Start date] - [Finish date] - 候选人面试:
[Custom Field: Candidate] with [Assignee] on [Start date] - 供应商发票:
[Author] Invoice [Creation date] - [Custom Field: Invoice ID]
被锁定的主题字段表示管理员为该工作包类型强制启用了自动主题模式。
[!IMPORTANT] 如果主题字段被锁定,也可能表示你缺少编辑该工作包的权限。
使用方法
自动主题工作包与普通工作包的使用方式基本一致,仅两点不同:
- 创建或编辑时:照常填写所有工作包详情,唯独主题字段留空;
- 主题只读:主题自动生成,不能手动编辑。
[!TIP] 对工作包属性的任何更改都会触发主题自动更新,即使更改的属性未被模式引用。
属性在主题中的呈现
自动主题反映管理员配置的属性实际值:日期([Start date]、[Finish date])、用户([Author]、[Assignee])、属性([Priority]、[Category]、[Custom Field: X])、项目详情([Project name]、[Project identifier])。
- 引用的属性不可用时显示"N/A";
- 引用的属性当前无值时显示[Attribute Name](属性名占位)。
常见问题(FAQ)
- 主题如何更新?当模式中引用的属性(如日期或自定义字段)变化时,保存后主题自动更新,无需额外操作。
- 模式引用父工作包或项目属性时?父工作包或项目属性变化不会立即影响子工作包的主题;只有更新并保存子工作包后主题才会刷新(该行为计划在未来版本中改进)。
- 为什么出现 "N/A"?常见原因:模式引用父属性但没有父工作包;存在父工作包但其类型没有该属性;属性未在当前项目激活。属性可用并填充后,更新保存工作包即可刷新主题。示例:模式
INVOICE: [Custom Field: Invoice ID] - [Start date],若 Invoice ID 不可用,将显示INVOICE: N/A - 2025-01-23。 - 为什么出现 [Attribute Name]?表示引用的属性尚未填充或设置。
导出工作包(Export work packages)
你可以导出多个工作包(PDF/XLS/CSV 格式)或单个工作包(PDF/Atom 格式)。
导出多个工作包
- 进入Work packages模块,选择要导出的默认或已保存视图(表格或卡片视图);
- 点击右上角的设置图标,从下拉菜单触发Export对话框;
- 选择所需格式;PDF 还需选择导出类型:table(表格)、report(报告)或Gantt chart(甘特图);
- 调整选项并点击Export。
导出在后台准备,对话框显示进度,文件就绪后可下载;生成的文件只保留有限时间,下载链接不能无限复用。
[!NOTE] 导出工作包列表需要Export work packages权限,可在角色与权限管理中为角色分配。
保存导出设置
对于已保存的工作包视图,可以勾选Save setting复选框保存导出设置,便于与团队共享并节省时间。该复选框不适用于默认视图或尚未保存的视图。如果查询是公共的,其他用户可以编辑并保存导出设置;如需阻止,请创建私有工作包查询。
导出单个工作包
点击右上角设置图标,选择Generate PDF或Download Atom即可导出单个工作包。
PDF 导出特性
- 支持常用字符集,包括多种字母的多语言字体、各类符号(数学、技术)与表情符号;
- 富文本可通过 Macros 嵌入(如其他工作包的描述),只要嵌入不在表格单元格内或仅包含基础文本格式即可;
- 描述中使用分页符后,内容会按页拆分显示。
各格式详情参见 pdf-table、pdf-report、gantt-chart-pdf、xls-excel、csv、work-package-pdf、work-package-atom。
延伸阅读
- 工作包视图
- 创建工作包
- 设置与修改日期和工期
- 编辑工作包
- 基线对比
- 共享工作包
- 自动主题
- 复制、移动与删除工作包
- 工作包表格配置
- 工作包关系与层级
- 工作包 FAQ
- 关系类型源码定义:app/models/relation.rb
【免费下载链接】openprojectOpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub项目地址: https://gitcode.com/GitHub_Trending/op/openproject
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考