新增数据监控点

• 功能说明

  该接口可用于用户添加数据监控点

• 请求地址

  旧版：（二选一）

  URL1： [apiBaseUrl]v2/box/{boxId}/dmon

  URL2： [apiBaseUrl]v2/box/dmon?boxNo={boxNo}

  新版：（二选一）

  URL1: [Host Server]/api/v2/box/{boxId}/dmon

  URL2: [Host Server]/api/v2/box/dmon?boxNo={boxNo}

  
  

• 地址参数说明

  字段名	类型	描述
  apiBaseUrl	string	详情见名词解释
  boxId	Long	FBox列表获取接口中boxRegs下box下id
  boxNo	string	FBox的序列号

• 请求方式

  PUT

• Headers

  字段名	类型	描述
  Authorization	string	Bearer+ 空格+登录接口中获得的access_token

• Body

  一次性集合长度不要超过20个

  Body为数据监控点列表，JSON格式传输

  字段名	类型	描述
  dmonGrpId	string	监控点分组Id，若使用dmonGrpId则无需使用dmonGrpName
  dmonGrpName	string	监控点分组名称，若使用dmonGrpName属性则无需使用dmongrpId属性,若分组不存在，系统自动创建
  name	string	监控点名称
  intDigits	int	整数位（目前无效），对位类型、二进制、十六进制、字符串类型无效
  fracDigits	int	小数位
  unit	string	字类型单位
  privilege	int	读写模式2：只写模式，4：只读模式，6：读写模式
  devAlias	string	设备驱动别名,请查看FlexManager里"远程下载"的别名
  station	int	PLC通讯站号
  dataType	int	数据类型，详情见附录二
  regId	int	寄存器Id，与ioWidth联合使用，确定唯一寄存器
  ioWidth	int	寄存器位宽，与regId联合使用，确定唯一寄存器
  regName	string	寄存器名称，能确定唯一寄存器，与上面两参数任选其一
  addr	int	PLC主地址
  subAddr	int	PLC子地址
  addrBlk	int	PLCDB块地址
  trafficSaving	boolean	是否省流量模式，true:启用，false：不启用，字符串类型无效
  deadValue	float	死区值，数据再±deadValue范围内数据不推送，字符串、位类型、16进制、2进制不支持
  label	JSON对象	位类型时显示标签，属性ttext:值为1时显示的文本，ftext：值为0时显示的文本
  memo	string	备注信息
  encoding	int	编码格式，字符串类型使用0：无，非字符串类型使用，1：Unicode,2:Ascii
  stringByteOrder	int	字符串字节序，编码为Ascii格式时有效0：倒序，1：正序
  charCount	int	字符串个数（仅字符串类型有效
  bitIndexEnabled	boolean	是否启用按位索引
  bitIndex	int	按位索引号
  valueTransform	jobject	数值运算设置
  executeOnEdge	boolean	是否启用边缘执行，启用时必须配置数值运算

  数值运算设置详细表

  字段名	类型	描述
  maxValue	int	数值上限
  minValue	int	数值下限
  scaleMaxValue	int	比例上限
  scaleMinValue	int	比例下限
  gain	int	增益
  offset	int	偏移量
  type	int	1：比例转换，2：缩放

• 响应成功

  返回添加监控点的Id(long)List集合

• 返回码

  字段名	描述
  200	执行成功
  401	accessToken过期
  404	接口不存在，请检查URL
  400	错误信息在HTTP Header里[X-FBox-Code]，详细见附录三
  429	访问接口频率过快，详情见429状态码

• Postman调用示例

• 使用案例如下图