OpenProject 12.4.1 补丁版本深度解读:15 项缺陷修复的完整清单与对应源码定位
OpenProject 12.4.1 补丁版本深度解读15 项缺陷修复的完整清单与对应源码定位【免费下载链接】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/openprojectOpenProject 12.4.1 是 12.x 系列的一个纯缺陷修复patch版本官方文档明确建议升级以获取本版本包含的若干 bug fixes。本篇以该版本的发布说明为主体完整继承其 15 项修复清单并按功能域对每一项修复进行分类解读同时结合当前仓库中的真实源码路径OpenID Connect 认证、BIM 模块、自定义字段等定位修复所涉及的实现区域帮助运维与开发者在升级前后快速核对影响面。版本基本信息以下信息直接来自发布说明 docs/release-notes/12/12-4-1/README.md项目内容版本号12.4.1发布日期2022-12-14版本定位缺陷修复版本不含新功能官方建议建议升级至最新版本需要说明的是12.4.1 是紧接在 12.4.0 之后的维护版本。12.4.0发布于 2022-12-05见 docs/release-notes/12/12-4-0/README.md引入了日期提醒date alerts、社区版双因素认证、官方 Helm Charts 等重要特性而 12.4.1 的若干修复正是围绕 12.4.0 新特性在落地后暴露的问题展开的后文会具体展开。仓库根目录的 CHANGELOG.md 也表明项目的显著变更统一记录于发布说明文档中因此docs/release-notes/12/12-4-1/是核对本版本内容的权威入口。完整修复清单原样继承自发布说明以下是 12.4.1 发布说明中列出的全部 15 项修复未作删减。原文中的每一项都对应一个上游工单编号#41676 等保留编号便于读者在 OpenProject 社区的版本页中进一步查证Fixed: Margin under road map caption when version is overdue [#41676]Fixed: Issues with project selection on mobile [#44440]Fixed: Typo in translation source string [#45071]Fixed: Can not sort project CF in Administration [#45099]Fixed: Centos7 fails with undefined symbol: PQconninfo due to outdated postgresql-libs shared library [#45101]Fixed: Labels are not fully visible for date alerts in DE, FR, ES [#45163]Fixed: Work package wrongfully displayed as child candidate [#45171]Fixed: Member shown twice when filtering by group when in multiple groups [#45331]Fixed: Custom Fields in WP View (Full and Side) are scrubbed [#45343]Fixed: In Activity page, subprojects is checked when navigating between pages [#45348]Fixed: Can not delete files from WiKi pages [#45385]Fixed: Missing Translation for duration activity changes [#45391]Fixed: Bad Spacing between versions in Roadmap page [#45392]Fixed: Login and email missing during AzureAD OpenID Connect registration [#45415]Fixed: xeokit-metadata fails to find dotnet-runtime in Ubuntu 22.04 [#45442]其中 15 项修复可归入六个功能域管理端自定义字段、路线图与日期提醒、认证集成、BIM 模块、成员/活动/Wiki 交互以及部署环境兼容性。下面逐类展开。管理端与工作包视图自定义字段相关修复本版本包含两项与自定义字段Custom Fields下称 CF直接相关的修复#45099 管理端无法排序项目自定义字段在 Administration 中对 project CF 进行排序的操作失效。从源码结构看自定义字段的管理界面位于 app/components/custom_fields/ 目录下该组件负责字段定义与排序交互修复使管理端的排序能力恢复正常。#45343 工作包视图中自定义字段被 scrubWork Package 的 Full 视图和 Side 视图中自定义字段值被“scrubbed”即显示被剥离或截断导致用户看不到完整的自定义字段内容。工作包前端视图组件位于 app/components/work_packages/修复恢复了这两个视图中自定义字段的完整呈现。对于多租户场景的部署方而言这两项修复直接影响自定义字段的配置管理与数据可见性升级后建议在管理端重新执行一次字段排序操作以验证效果。路线图与日期提醒紧随 12.4.0 新特性的缺陷收敛12.4.0 引入了“即将到期的开始/完成日期提醒”与“逾期任务提醒”特性12.4.0 发布说明中明确其属于 Enterprise add-on见 docs/release-notes/12/12-4-0/README.md 的 Date alerts 章节。12.4.1 中有四项修复与该特性的周边体验相关#45163 日期提醒标签在 DE/FR/ES 语言下显示不全德语、法语、西班牙语下 date alerts 的标签label无法完整显示属于通知中心中日期提醒卡片的本地化排版问题。这提醒多语言部署方OpenProject 的翻译文件位于 config/locales/中通知类文案的长度差异可能导致界面截断升级后宜在德/法/西语环境下抽查通知中心。#41676 版本逾期时路线图标题下方边距异常当某版本version已逾期时Roadmap 页面上方的 caption 与下方内容之间的间距不正确。#45392 Roadmap 页面各版本之间间距异常Roadmap 中多个版本区块的垂直间距bad spacing得到修正。#45391 duration 活动变更缺失翻译活动Activity中工时/时长变更的翻译文案缺失属于 i18n 文案补全。路线图与版本相关的前端实现可参见 frontend/src 中的版本/路线图相关组件目录上述修复均为纯表现层spacing、margin、翻译字符串问题的修正不涉及数据模型变更。认证集成AzureAD OpenID Connect 注册修复#45415修复了通过 AzureADAzure Active DirectoryOpenID Connect 方式注册新用户时login登录名和 email邮箱字段缺失的问题。结合当前仓库源码可以印证该功能所在区域OpenID Connect 模块位于 modules/openid_connect/其 Provider 模型 modules/openid_connect/app/models/openid_connect/provider.rb 中明确标注了 Azure 专属选项第 81–82 行的# azure specific option与use_graph_api属性并提供了entra_id?判断方法第 126–128 行识别oidc_provider microsoft_entra配置映射服务 modules/openid_connect/app/services/openid_connect/configuration_mapper.rb 中亦存在针对 Azure 的专用分支第 99 行when /azure/。这说明 OpenProject 对 AzureAD 场景有专门的配置与声明claims映射路径本修复正是补齐了该路径下注册流程中 login/email 两个声明到用户字段的映射完整性。对使用 AzureAD 单点登录的部署方升级后应重点回归验证新注册用户是否自动带出登录名与邮箱以及既有映射配置claim mapping是否仍按预期工作。BIM 模块xeokit-metadata 依赖 dotnet-runtime 的修复#45442修复了 BIM 模块在 Ubuntu 22.04 上运行时xeokit-metadata找不到dotnet-runtime的问题。仓库源码证实了这一依赖链modules/bim/app/services/bim/ifc_models/view_converter_service.rb 第 35 行定义了 IFC 模型转换的流水线命令PIPELINE_COMMANDS || %w[IfcConvert COLLADA2GLTF gltf2xkt xeokit-metadata]并在第 185 行通过Open3.capture2e(xeokit-metadata, ...)实际调用该二进制modules/bim/bin/setup_dev.sh 第 17 行以apt-get install -y dotnet-runtime-6.0安装 .NET 运行时随后下载并解压xeokit-metadata-linux-x64工具包。xeokit-metadata依赖 .NET 运行时dotnet-runtime而 Ubuntu 22.04 的默认仓库中 .NET 运行时包名与路径较旧版发行版有变化直接安装可能找不到dotnet-runtime。本修复使 BIM 模块在 Ubuntu 22.04 环境下能够正确解析到 .NET 运行时。仅启用了 BIM 模块IFC 模型查看的部署方需要关注此项若服务器使用 Ubuntu 22.04升级前可先用dotnet --info确认运行时可被正确识别。成员、活动页与 Wiki 交互类修复以下四项为日常高频交互路径上的缺陷修复#44440 移动端项目选择问题移动端mobile上的项目选择存在交互缺陷升级后建议在手机/平板端重新走一遍项目切换流程。#45171 工作包被错误显示为子级候选项设置父/子关系时某工作包被错误地列为了可以设为子级child的候选对象属于关系relations候选集合计算错误。关系模型实现位于 app/models/relation.rb 与 app/components/work_package_relations_tab/本修复属于候选项过滤逻辑的修正。#45331 按组过滤时成员重复显示当一名成员同时属于多个组时按组group过滤成员列表会将其重复展示。组成员模型位于 app/models/members/ 与 app/models/group_user.rb修复消除了跨组去重缺失的问题。#45348 活动页翻页后 “subprojects” 复选框状态异常在 Activity 页面切换页码后“subprojects” 过滤项会被错误地保持勾选状态属于前端分页时过滤状态未重置的问题。#45385 Wiki 页面无法删除文件从 Wiki 页面删除附件/文件的操作失效影响 Wiki 内容维护。Wiki 控制器与组件可参考 app/controllers/wiki_controller.rb 及 app/components/wiki_pages/。部署环境兼容性CentOS 7 的 PostgreSQL 客户端库问题#45101修复了 CentOS 7 上因过时的postgresql-libs共享库导致的undefined symbol: PQconninfo错误。该错误表明应用启动时加载的 PostgreSQL 客户端库libpq符号与编译期版本不匹配——CentOS 7 基础源中的postgresql-libs版本较老缺少PQconninfo这一较新版本才引入的符号。从部署角度可以推断修复方向是确保镜像/安装脚本引入的 libpq 版本与 pg 驱动要求一致避免因系统自带旧库遮蔽正确版本。在 CentOS 7 上部署或升级 OpenProject 的运维人员若曾遇到该undefined symbol: PQconninfo启动失败升级至 12.4.1 后应重新验证服务能否正常启动同时建议用ldd检查运行时实际链接的 libpq 路径确认其来自预期的软件源。其他修复#45071 翻译源字符串中的拼写错误修正了一条 translation source string 中的 typo属于 i18n 源文案质量修复间接影响所有基于源字符串进行本地化的语言。社区致谢Contributions发布说明原文的 Contributions 章节感谢了社区成员报告 bug 并协助定位与修复特别鸣谢原文致谢名单Rince windChristina VechkanovaMagdalena Rybak升级建议与核对清单官方发布说明的结论是本版本包含若干 bug fixes建议更新到最新版本。由于 12.4.1 不引入任何新功能升级风险较低可按以下清单核对升级收益使用 AzureAD OpenID Connect 的实例回归验证新用户注册的 login/email 字段#45415启用 BIM 模块且运行于 Ubuntu 22.04 的实例验证 IFC 模型转换流水线#45442CentOS 7 部署确认PQconninfo启动错误已消除#45101多语言DE/FR/ES通知中心抽查日期提醒标签完整性#45163、#45391使用自定义字段较多的实例验证管理端排序与 WP 视图字段展示#45099、#45343使用组权限/多组成员的实例验证按组过滤成员无重复#45331。本篇全部事实均以 docs/release-notes/12/12-4-1/README.md 发布说明为基准源码引用均来自当前仓库实际存在的文件与行号可作为升级前评审与升级后回归测试的直接依据。【免费下载链接】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),仅供参考