让 Fiori Elements Overview Page 真正可用的钥匙：深入理解并配置 Global Filter（全局过滤器）

在 Fiori Elements 的 Overview Page（简称 OVP）里，Global Filter 是把零散卡片数据揉成业务视角的关键枢纽。它位于页面最上方，基于 sap.ui.comp.smartfilterbar.SmartFilterBar 控件实现，支持变体管理、持久化与分享过滤条件、跨卡片的统一筛选、基础搜索，以及语义日期范围（Semantic Date Range）等高级能力。本文以资深 SAP UI5 / Fiori Elements 研发者的视角，系统讲清它的工作原理、manifest.json 中的配置项、与注解的关系、性能与可用性考量，以及真实项目里的易错点与调优方法，并给出可直接复用的代码与案例。为了便于你查证，每一段核心论断，我都附上权威文档出处。

---

1）Global Filter 是什么：一处筛选，处处生效

OVP 的全局过滤器使用 SmartFilterBar 呈现可筛选属性（来源于你声明的实体集与其注解），用户可保存并共享筛选变体。只要卡片的数据实体类型中存在同名属性，这个过滤就会对这些卡片生效，实现跨卡片的统一收敛。例如，CompanyCode / ControllingArea 这类维度，常被多个卡片共用；用一次 Global Filter，就能同时限制多个卡片的查询范围，避免用户重复输入。这个能力来自 OVP 对 SmartFilterBar 的集成与增强。(