从 AttributeGroup 看 SAP 适配器配置界面的分组设计

从 AttributeGroup 看 SAP 适配器配置界面的分组设计

在 SAP PI/PO 适配器开发里,很多人一开始会把注意力放在连接、事务、模块链、消息传输这些运行时问题上。可真正把一个自定义 Adapter 做到可交付、可维护、可让顾问安心配置,另一块容易被低估的工作就是 Adapter Metadata。运行时负责把消息送出去或者收进来,Metadata 负责告诉配置界面应该怎么长,哪些字段应该出现,哪些字段应该被归到同一个区域,字段名在不同语言下如何显示,字段和运行时属性之间又如何对应。

AttributeGroup正是这套机制里一个很小却很关键的元素。SAP 官方对它的定义很直接,它可以把多个 attribute 组织到同一个组里,同一个组内的属性会在用户界面上以一个 frame 的形式显示出来。AttributeGroup自身是一个ComplexType,用于在 UI 上组合一个或多个属性,它下面可以包含NameGUILabels和一个或多个AttributeReference。其中Name是组名,GUILabels是 GUI 标签列表,每个标签包含语言键和显示文本,AttributeReference则指向属于这个分组的某个属性。SAP 官方也提到,JMS adapter 里就有 attribute groups 的例子,具体落点可以看 Sender JMS Adapter 的PI SettingsError Handling Settings。(