【待评审】Web支持显示组件与PcieCard序列号信息

Interface SIG Interface评审
1

背景

新需求要求针对主板、背板、PCIe卡、Riser卡等需要在web显示对应的SN、PN

关联ISSUE

整体方案

评审点

Web支持板卡信息展示SN、PN

详细描述

决策点一：

由于Webui已经支持组件扩展信息显示SN，需要后端将数据传递给前端，涉及URL

/UI/Rest/System/Units/IOExtensionUnit

/UI/Rest/System/Units/BasicComputingUnit

/UI/Rest/System/Units/StorageExtensionUnit

属性 属性说明 数据类型 默认值
SerialNumber 序列号 string null

决策点二：PCIeCard扩展信息支持序列号、部件编码显示

变更点1：

  • 涉及接口：

  • /UI/Rest/System/Boards/PCIeCard(已有)

  • /UI/Rest/System/Boards/OCPCard(已有)

  • 操作类型： Get

  • 变化类型： 新增属性

属性 属性说明 数据类型 默认值
SerialNumber 序列号 string null

变更点2：

Web不支持PCIeCard界面Raid卡、Net卡扩展信息显示SN、PN，需要新增显示字段

PCIeCard Web示例

image
image1816×498 42.7 KB

组件界面 Web示例：

image
image1828×726 55.9 KB

评审结论

决策点一：同意WebRest接口接口/UI/Rest/System/Units/IOExtensionUnit、/UI/Rest/System/Units/BasicComputingUnit、/UI/Rest/System/Units/StorageExtensionUnit新增SerialNumber属性，数据类型：string。默认值：null；
决策点二：同意WebRest接口/UI/Rest/System/Boards/PCIeCard、/UI/Rest/System/Boards/OCPCard新增SerialNumber属性，数据类型：string。默认值：null；
同意WebUI界面Raid卡、网卡扩展信息显示序列号、部件编码

遗留问题

1.URI确认是否有二级目录–闭环，评审涉及URL无二级URI，均为LIST展示信息
2.后台数据获取失败时，需要明确返回为null或空串—闭环，补充默认值为null，获取失败时返回默认值

2

决策点二：/bmc/kepler/Systems/1/PCIeDevices/PCIeCards/:id这个路径下本来就有SerialNumber。你是想评webrest接口？
决策点三：需要给出web示例

3

决策点二，最新开源代码rackmount/interface_config/web_backend/mapping_config/System/Boards.json 下的/bmc/kepler/Systems/1/PCIeDevices/PCIeCards/:id未看到SerialNumber字段

4

决策点3，是因为Webui针对PCIeCard不同类型做了web显示差异化，Raid卡未显示字段

image
image1318×459 23.3 KB

5

那应该评的是webrest接口，不是指向资源协作路径。从web示例来看你想加的URL应该是/UI/Rest/System/Boards/PCIeCard和/UI/Rest/System/Boards/OCPCard

6

是的，决策点二主要是已经支持SN和PN显示，但是后台数据未对所有PCIeDevice传递sn

8

决策点二建议把/UI/Rest/System/Boards/OCPCard带上，这个接口跟/UI/Rest/System/Boards/PCIeCard地位是一样的

9

已添加