📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

PropertySync 类 ​

📊 属性定义详表 ​

PropertySync 类 - 必选属性 ​

PropertySync 类 - 可选属性 ​

📂 同步模式说明 ​

📂 目标发现说明 ​

接口发现模式订阅接口的添加和移除信号，新增目标会触发一次全量同步，移除目标会回收对应监听。短暂发现失败时保留已有目标。

📂 SyncObjectItem结构 ​

📂 分类标准 ​

硬件属性 ​

• 定义：与硬件特性和物理参数直接相关的属性
• 特点：无
• 示例：无

软件属性 ​

• 定义：用于逻辑控制和软件管理的参数
• 特点：由CSR配置管理，用于属性同步逻辑控制
• 示例：SyncMode、SyncInterval、TTL、SyncObjectName、SyncObjectItems

📝 配置示例 ​

实时同步配置 ​

{
  "PropertySync": {
    "SyncMode": 0,
    "SyncInterval": 5,
    "TTL": 3600,
    "SyncObjectName": "/bmc/kepler/Systems/TargetNode",
    "ServiceName": "bmc.kepler.frudata",
    "SyncObjectItems": [
      {
        "Interface": "bmc.kepler.Systems.FruCtrl",
        "Properties": ["PowerState", "PowerOnStrategy"]
      }
    ]
  }
}

周期性同步配置 ​

{
  "PropertySync": {
    "SyncMode": 1,
    "SyncInterval": 30,
    "TTL": 0,
    "SyncObjectName": "#/BackupNode",
    "ServiceName": "bmc.kepler.frudata",
    "SyncObjectItems": [
      {
        "Interface": "bmc.kepler.Systems.ThermalTrip",
        "Properties": ["Action", "TimeDelaySeconds"]
      }
    ]
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置SyncMode：选择实时、周期或实时且周期模式
2. 配置ServiceName和SyncObjectName：指定路径、CSR引用或留空进行接口发现
3. 配置SyncInterval：周期性同步时设置间隔（5-60秒）
4. 配置TTL：设置同步数据老化时限，0表示不限制
5. 配置SyncObjectItems：定义需要同步的对象接口和属性列表

注意事项 ​

• 实时同步 (0)：属性值变化时立即触发同步，适用于对实时性要求高的场景
• 周期性同步 (1)：按固定间隔同步，适用于对带宽敏感的场景
• 实时且周期 (2)：兼顾实时性和周期性兜底，适用于信号偶发丢失或目标动态变化的场景

故障排查 ​

• 属性未同步：检查SyncObjectItems配置是否正确
• 目标未发现：检查SyncObjectName格式和ServiceName；接口发现时确认目标对象已暴露配置接口
• 同步延迟：检查网络状况和SyncInterval设置
• 数据过期：检查TTL设置是否合理