1.2.3 编辑服务

优质
小牛编辑
120浏览
2023-12-01

更新时间:2019-05-30 19:08:30

步骤2:编辑服务

拖拽功能节点到画布上,并配置节点名称、数据源、参数等,您就可以可视化的方式开发服务。本文介绍如何可视化的编辑服务流。

前提条件

已完成步骤1:创建项目。

操作步骤

  1. 在项目页,选择**服务开发 > 新建服务**
  2. 填写服务基本信息,创建服务。
参数说明
服务名称服务的唯一标识符,在项目下具有唯一性。可包含中文汉字、英文字母、数字和下划线(_),长度不超过20个字符(一个中文汉字算一个字符)。
所属项目服务所属的项目。
备注描述服务的用途等信息。长度不超过100个字符(一个中文汉字算一个字符)。
  1. 服务创建成功后,页面跳转至服务列表页。
  2. 在服务列表下,选择要编辑的服务,再单击左侧导航栏中节点按钮。
  3. 配置服务触发节点。拖拽一个输入节点到画布上,在页面右侧配置节点名称、数据源等。表 1. 可选触发节点
节点说明
定时触发服务将在指定时间点触发,或在指定时间范围内循环触发。可选触发模式:
- 特定时间触发:需设置触发时间点。该服务将只在该时间点触发一次。
- 循环定时触发:需设置循环周期、生效时间、结束时间或永久生效。
HTTP请求开发HTTP接口时,需选择该输入节点。该节点的配置即作为调用接口的输入参数。需配置:
- Action:使用SDK调用接口时的Action参数值。可包含英文大小写字母和数字。
- 新增入参:配置调用接口所需的入参信息,包括参数名称、类型、是否为必填参数等。


说明 服务流的最后一个节点需配置为HTTP返回作为接口返回结果节点。 |
| 设备触发 | 将设备上报的属性或事件数据作为服务的触发。如果您要监听设备的上报数据,并进行后续动作,可选择该节点。在功能节点下,选择设备,该节点将显示里列表下。
需配置触发服务的设备数据信息,包含产品、设备、上报信息类型。 |


  1. 说明 目前,IoT Studio不会自动保存您的配置,请务必点击页面右上角保存按钮保存当前配置。
    下图示例中,以空气检测设备上报的属性数据作为该服务的触发。

  1. 配置实现服务功能逻辑的节点。根据您的业务需要,配置服务功能逻辑。可配置多个节点共同实现服务功能。说明将功能节点拖拽到画布后,请先从上一个节点右侧锚点连线到当前节点的左侧锚点,再进行节点配置。表 2. 可选功能节点
节点说明
数值计算根据配置的运算方法进行数值计算。需配置:
- 数据源:可设置为静态数值、上一节点(payload)、或本节点之前的任一节点的某个数值。
说明 数据源只能是数值型数据。
  • 运算方法:选择数据源输入值与参数值的计算方法。
    - 参数:设置与数据源输入值进行计算的参数值。
    例如,数据源为一个设备上报的属性PM2.5为100,运算方法选择为相乘,参数设置为静态取值0.25,则数值计算为:100*0.25=25。 | | Python脚本 | 若现有节点不能满足您的业务需求,您可以编写Python脚本实现功能逻辑。需在脚本最后填写return 对象名称,作为该节点输出的payload。 | | Node.js脚本 | 若现有节点不能满足您的业务需求,您可以编写Node.js脚本实现功能逻辑。需在脚本最后填写return 对象,作为该节点输出的payload。 | | 条件判断 | 如果需要对输入值做判断,根据判断结果执行不同的逻辑,需使用该节点。需配置:
    - 条件选择:选择同时满足所有条件或满足任一条件。
    - 条件判断配置:配置具体的判断条件。可配置多条。
    | | 路径选择 | 设置路径。需配置:
    - 数据源:可设置为静态数值、上一节点(payload)、本节点之前的任一节点的某个值、或条件判断结果等。
    - 新增路径:根据业务场景添加路径。
    | | 自定义API | 若需在服务中,调用自定义的HTTP接口作为中间逻辑节点,须使用该节点。需配置:
    - 请求方法:支持GET、POST两种方法。
    - API地址:要调用的HTTP接口的URL地址。
    - 编码:支持UTF-8、GBK。
    - 参数填写:可设置为静态参数或动态参数。设置动态参数,可使用query.[参数名称](query表示输入节点的输出参数),或payload.[参数名称](payload表示上一个节点的输出参数)等方法。
    | | 项目内API | 若需在服务中,调用该项目下已部署服务的API,须使用该节点。填写参数时,可设置为静态参数或动态参数。设置动态参数,可使用query.[参数名称](query表示输入节点的输出参数),或payload.[参数名称](payload表示上一个节点的输出参数)等方法。 | | 云市场API | 若需在服务中,调用您已在阿里云市场中购买的API,须使用该节点。填写参数时,可设置为静态参数或动态参数。设置动态参数,可使用query.[参数名称](query表示输入节点的输出参数),或payload.[参数名称](payload表示上一个节点的输出参数)等方法。 | | 键值对操作 | 如果以键值对形式进行数据的写入、获取、删除操作,使用该节点作为服务的中间逻辑节点。键值对存储节点已封装KV存储服务API。 | | 云数据库MySQL | 该节点提供访问云数据库RDS版的能力,配置该节点对数据库中的数据进行增、删、改、查操作。需配置您的云数据库RDS版的数据库信息。请在云数据库RDS版控制台中,查看对应信息。 | | 表格存储 | 该节点提供访问表格存储的能力,配置该节点对表格存储实例中的数据进行增、删、改、查操作。需配置您的表格存储实例信息。请在表格存储控制台中,查看对应信息。

说明 需单击授权,授予IoT Studio访问您的表格存储实例的权限。 |
| 设备 | 使用该节点下发设备动作执行、查询设备属性、查询设备其他信息的指令。
- 设备动作执行:设置属性或调用服务。
- 查询设备属性:查询设备的属性快照值或历史值。
- 查询设备其他信息:查询设备的基本信息、物模型详情、事件数据等。
|
| 钉钉机器人 | 使用钉钉机器人节点将消息发布到钉钉群或指定的接收者。请先在钉钉群对话框中,单击右上角...按钮,然后选择群机器人,添加自定义机器人。需将该机器人的Webhook地址配置到该节点中。 |

  1. 本示例中,依次定义了以下功能逻辑节点:
    1. 配置一个条件节点。其中,包含两个条件:Sensor上报的PM25值大于100和Sensor上报的SO2值大于0.25,条件选择为满足任一条件,
    2. 为满足条件的情况,配置一个设备节点。根据条件判断结果,向空气净化器发送指令:设置属性switch1为开。
    3. 配置一个钉钉机器人节点,通知钉钉群空气污染情况。
    4. 为不满足条件的情况,配置一个路径选择。路径的数据源为Sensor上报的PM25值,包含两个路径,路径1:PM25值50。
    5. 为路径1配置对应的设备节点,向空气净化器设备发送指令:设置属性switch1为关。
    6. 为路径1配置钉钉机器人,通知空气质量情况。
    7. 为路径2配置钉钉机器人节点。
  2. (可选)开发HTTP接口时,需配置一个HTTP返回节点作为输出。
节点说明
HTTP返回开发HTTP接口时,选择该节点为输出节点。 需配置:输出:可配置为静态数据或动态数据(即来自其他节点的值)。
新增返回码:IoT Studio已定义了系统返回码。单击新增返回码,可自定义返回码。

  1. 配置完成后,单击部署将服务部署到云端。
  2. 部署成功后,单击启动按钮启动服务。