部分组件支持使用数据分析服务接口、自定义接口、项目内服务开发的HTTP接口和查询产品和物(设备)的信息的接口返回的结果数据作为数据源。

接口
参数 说明
选择数据源 勾选接口
接口来源 可选:
  • 数据分析服务:调用开发者在物联网数据分析服务中开发的API接口(包含官方通用接口、用户自定义接口),将返回数据作为组件数据源。

    有关数据分析服务的API接口详细内容,请参见API服务开发

  • 自定义接口:调用开发者自己开发的开放接口或第三方接口,将返回数据作为组件数据源。
    注意 自定义接口必须满足以下要求:
    • 如果设置了请求参数,该参数必须使用JSON格式数据。
    • 接口返回的数据必须是JSON格式的。

    支持的JSON的数据格式有:

    • 对象(Object):{}
    • 数组(Array):[]
    • 字符串(string):"test"
    • 数字(number):123
    • 布尔值(bool):truefalse
  • 服务开发工作台:调用在当前项目中,通过服务开发工作台开发的HTTP接口,将返回数据作为组件数据源。
  • 产品与物的管理:调用查询产品信息列表的接口、查询产品属性的接口、查询物的详情列表的接口、或查询物的数量的接口,将返回数据作为组件数据源。
请求方法 选择自定义接口的请求方法,可选:getpost

当接口来源选择为自定义接口时出现的参数。

请求地址 输入您的自定义接口的请求地址。

当接口来源选择为自定义接口时出现的参数。

选择接口 选择要调用的接口。

当接口来源选择为数据分析服务服务开发工作台产品与物的管理时出现的参数。

请求参数 可选:
  • 静态参数:需在下方输入框中,填入键值对组成的请求参数,格式需为标准的JSON格式。
  • 动态参数:需在下方添加请求参数,设置键和值。

    自动更新:当参数变化时,数据源更新。如果不勾选该选项,您可以通过交互动作触发数据源更新。

    参数值来源可选择为:

    • 变量:选择在当前应用中,已创建的变量作为参数值来源。创建变量和给变量赋值,请参见变量管理
    • 组件值:选择当前应用中,已配置的表单组件作为参数值来源。
    • URL参数:以最终发布页面上的某个参数,作为该接口的请求参数值。常用于嵌入页面时,由宿主页提供动态参数,如将传入的产品型号,作为当前接口的请求参数。
    • 登录账号:在开启应用账号鉴权的情况下。配置自定义接口服务开发工作台接口时,可以选择登录的账号信息做为请求参数,以完成一些界面或功能的定制需求。
数据过滤脚本 勾选后,基于JavaScript对接口返回的原始数据进行一定的加工以适配图表或文字的展示需求。
数据表配置 勾选后,对接口返回或脚本处理之后的结构化数据进行解析并排序,以决定在组件上具体显示数据。
处理结果 经过脚本处理以及数据表配置优化之后的结果,将直接用于组件的显示。

当勾选了数据过滤脚本时出现的参数。

返回结果 单击验证数据格式确定时,系统都会调用该接口,请求结果会写入到返回结果中,以供您参考。
定时刷新 勾选后,需指定每隔多少秒自动调用接口一次,以获得最新数据。默认不开启。
表 1. 数据格式验证
操作 说明
格式参考 单击格式参考,查看组件支持的数据格式。
验证数据格式 单击验证数据格式按钮,验证当前数据格式是否满足组件的格式要求。满足要求,则提示“验证成功”;不满足,则会提示详细的错误信息。