OpenProject 工作包 XLSExcel导出指南列管理、描述与关系导出及导出上限详解【免费下载链接】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/openprojectXLS 导出是 OpenProject 中最常用的电子表格导出方式之一它把工作包表格中的列与行原样输出为 Microsoft Excel 可直接打开的.xls文件并严格遵循当前视图的过滤器。本文以官方用户指南为主体结合仓库中的导出实现源码完整讲解 XLS 导出的触发方式、列选择与排序、描述与关系导出选项、管理员可配置的导出上限以及当前版本的功能限制帮助你在实战中精准控制导出内容。XLS 导出是什么XLS是一种纯表格plain sheet导出格式它忠实对应 OpenProject 工作包表格中的列结构每一行对应一个工作包行集合由当前视图中所选用的过滤器决定。也就是说导出的数据范围不是全部工作包而是当前表格里看到的那些工作包——过滤器筛选出什么XLS 就导出什么。与 PDF 报告导出包含封面、目录、描述等排版内容不同XLS 导出以数据为中心适合后续在 Excel 中进行二次加工、透视或与团队共享结构化数据。在XLS格式的导出对话框中你可以管理并重新排序要包含的列决定是否在报告中包含关系relations决定是否在报告中包含描述descriptions。如何触发导出XLS 属于多工作包导出Export multiple work packages能力触发方式与 PDF/CSV 一致进入Work packages工作包模块选择一个默认视图或已保存的工作包视图表格或卡片视图点击右上角的设置图标从下拉菜单中选择Export导出在弹出对话框中选XLS (Excel)格式按需调整选项后点击Export按钮导出在后台异步准备进度对话框会在文件就绪后提供下载生成的文件仅保留有限时间下载链接不能无限期复用。完整的触发步骤与通用导出选项含保存导出设置勾选项、默认视图与已保存视图的行为差异等见 导出工作包。[!NOTE] 导出工作包列表需要Export work packages权限该权限可在 角色与权限 管理中被分配给某个角色。导出列的选择与排序在 XLS 导出对话框中你可以选择哪些列出现在表格中并改变它们的顺序默认预选中的列就是当前工作包表格查询query中所配置的列长文本字段long text fields类型的列不参与列选择即无法通过对话框将其加入 XLS 导出你可以通过勾选/取消勾选来增减列并通过拖拽调整顺序直到得到目标表格结构。若希望预选列更符合团队习惯可以先把工作包表格配置好并保存为视图再执行导出。关于如何保存视图可参考 保存工作包视图表格的列增删与排序交互拖拽、Apply 应用参见 工作包表格配置。从源码实现看列集合来自查询对象本身WorkPackage::Exports::QueryExporter#get_columns直接取query.columns并显式剔除关系选择列Queries::WorkPackages::Selects::RelationSelect这部分逻辑见 query_exporter.rb。而描述列在需要时作为额外列追加见下文实现于 csv.rb 的get_columns/description_column。包含描述的 XLSXLS with descriptions勾选Include descriptions选项后报告中会额外增加一列展示各工作包的描述内容。其导出规则是描述以**去除 HTML 标签后的纯文本raw text**形式导出因此原本的格式化字符仍可见例如换行、空格等排版字符会保留在文本中但加粗、标题等富文本样式会丢失。在源码中该选项通过options[:show_descriptions]传递with_descriptions用ActiveModel::Type::Boolean将字符串形式的参数安全转换为布尔值为true时把:description属性选择列追加到列集合末尾见 csv.rb。XLS 导出对话框中的同名复选框渲染逻辑见 export_settings_component.html.erb。包含关系的 XLSXLS with relations勾选Include relations选项后导出逻辑发生显著变化每个工作包按其拥有的关系数量被重复为多行每有一个关系就单独占一行没有关系的工作包则保持单行导出。每一行会在原列基础上额外追加三列关系的Relation type关系类型、Lag延迟/间隔和Description关系描述追加列之后紧接着是该关系所关联工作包的所选列即被关联工作包同样按你选定的列集合展开。层级关系hierarchy relations同样被包含它们被标记为parent of父级和child of子级。这意味着带关系的导出是一种宽表long/wide format便于在 Excel 中做关系维度的分析例如筛选出所有前置任务行、查看跨包依赖的 Lag 天数。该复选框在导出对话框中的位置与渲染见 XLS 导出设置组件关系类型、Lag 等字段的取值语义可参考 工作包关系与层级。导出上限Export limitXLS 导出遵循与其他多工作包导出一致的上限机制默认情况下当前所选视图中工作包表格包含的所有工作包都会被导出但实例管理员可以在系统管理中设定导出上限超过上限的部分会被截断truncated新建实例的默认上限为 500 个工作包。管理员配置入口位于Administration → System settings → Exports对应文档 导出设置其中的Work packages / Projects export limit设置即用于指定单次导出允许包含的最大工作包或项目数量。系统设置表单见 exports_settings_form.rb。从仓库的默认值定义可以确认config/constants/settings/definition.rb中work_packages_projects_export_limit的默认值为500见 definition.rb与文档所述新实例默认 500完全一致。设置文案说明见 en.yml单次导出可包含的工作包或项目的最大数量。更大的导出将被截断到此限制。该上限在导出时真正生效的位置是查询分页WorkPackage::Exports::QueryExporter#get_work_packages使用query.results.work_packages.includes(...).page(page).per_page(Setting.work_packages_projects_export_limit.to_i)来限制每次取出的记录数见 query_exporter.rb。Exports::Exporter基类同时负责导出文件名的规范化sane_filename会保留.xls扩展名并对文件名做安全转写见 exporter.rb。此外导出文件在 MIME 类型层面被识别为application/vnd.ms-excel映射为xls扩展名参见 mime_type.rb。当前限制Limitations需要注意的是OpenProject 的 XLS 导出目前不会完全遵循被导出工作包视图中的全部显示选项工作包视图中的层级结构不会被保留无论视图显示为层级模式导出的 XLS 始终是扁平flat模式即所有工作包按普通行平铺输出不做缩进或父子分组。如果你需要在导出中呈现层级可以改用 Gantt chart PDF 或 PDF 报告 等排版型导出若仍需 XLS 但想追踪父子关系则可结合上文包含关系选项利用其导出的parent of/child of标记在 Excel 中重建层级信息。与其他导出格式的关系XLS 只是 OpenProject 多种导出格式之一。多工作包层面支持格式特点PDF 表格按所选列以表格形式输出 PDFPDF 报告含标题页、目录与描述的工作计划报告Gantt chart PDF将甘特图导出为 PDFXLS (Excel)本文主题输出为 Excel 电子表格CSV以逗号分隔的 CSV 文件导出单工作包层面则支持 工作包 PDF 导出 与 Atom 导出。小结XLS 导出的核心要点可归纳为数据范围始终以当前视图的过滤器为准导出表格中可见的工作包列控制预选列继承自工作包表格查询可在对话框中增删、拖拽排序长文本字段列不可选择描述选项追加一列以去 HTML 的纯文本导出描述格式化字符保留关系选项每个关系单独成行追加 Relation type / Lag / Description 三列及关联工作包的所选列层级关系标记为parent of/child of导出上限管理员可在System settings → Exports调整新实例默认 500超出部分截断分页逻辑实现在 query_exporter.rb已知限制层级视图一律以扁平模式导出。掌握这些选项后你就能按需生成面向 Excel 分析、汇报或数据交换的工作包报表并在需要大范围导出时提前与管理员确认上限配置。【免费下载链接】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），仅供参考