物联网应用开发(IoT Studio)的业务逻辑提供变量配置功能,您可在业务服务编辑页面配置全局变量和局部变量,用于存储和传递数据。

添加变量

  1. 创建业务服务。具体操作,请参见创建业务服务
  2. 在业务逻辑编辑页面,单击右上角的变量配置按钮变量配置
  3. 变量面板,单击+变量
    变量
  4. 添加变量对话框中,配置参数项。
    添加参数
    参数 说明
    变量名称 用于标识变量。包含英文字母、数字和下划线,必须以字母开头,长度不超过50个字符。

    在同一项目下,全局变量名称需全局唯一,局部变量名称可在不同服务中重复。同一服务中,全局变量和局部变量名称不可重复。

    变量类型 可选:
    • 全局变量:应用于项目下的所有业务服务中。
    • 局部变量:仅应用于当前业务服务。
    数据类型 可选:Num(数值型)、String(字符型)、Boolean(布尔型)、Array(数组)、JSON(结构体)。

    创建后,不支持修改。

    默认值 变量的初始值。
    描述 可描述变量用途等信息,方便大型服务的维护。
    加密 当变量存储机密信息(账号、密码、身份证号、手机号等)时,可选中加密。此时,在运行日志中,加密后的变量值会显示为一段字符串,可防止私密数据的泄露。

    示例

    • imageURL:图片链接,不加密,默认值为https://www.test.com/***
    • idCardNum:身份证号,加密,默认值为真实身份证号码。

    如下所示,运行日志中imageURL显示配置值,idCardNum显示了一段字符串。

    "变量":{
    "imageURL":"https://www.test.com/***"
    "idCardNum":"VOtCb21WWJleCKQDLReIJi34Ct5zfy+0japG4fuzEig="
    }
    说明 加密功能支持在变量传递过程中加密变量值,使用时再进行解密。加解密过程会稍微延长服务执行时间。
  5. 单击保存
    创建成功后,可在变量面板中看到已添加的变量,支持编辑(修改默认值、描述、是否加密)或删除。

    您可通过选择变量类型或输入关键字,搜索变量。

    变量列表

使用变量

您可在配置服务节点时,将变量作为参数使用。目前,IoT Studio支持通过以下节点修改并传递变量值。

  • 变量设置:详细使用方法,请参见最佳实践统计会议签到人数
  • NodeJS脚本:通过global.变量名指定某个变量。如下图所示,其中test_list为已配置的变量。脚本修改变量
注意
  • 使用NodeJS脚本修改变量值时,修改值的数据类型与该变量的数据类型必须保持一致。

    如果修改全局变量时,数据类型不一致,则会导致该变量所属项目下的所有业务服务运行失败,从而导致整个项目无法正常运行。

    综上所述,虽支持但不推荐通过NodeJS脚本节点使用变量。

  • 使用变量设置修改变量值时,可校验数据类型,推荐您通过此节点来使用变量。

最佳实践

统计会议签到人数