变量主要用于存储和传递数据。物联网应用开发(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. 单击保存
    创建成功后,可在变量面板中看到已添加的变量,支持编辑(修改默认值、描述、是否加密)或删除。

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

    变量列表

变量值重置说明

变量值是否重置为默认值见下表,其中:

  • √:表示会重置变量值为默认值。
  • -:表示当前变量值不受操作影响。
表 1. 全局变量
操作 测试环境 正式环境
编辑变量
部署服务 - -
发布服务 - -
单击重置全局变量 -
说明 您可在项目详情主页业务服务页签下找到重置全局变量按钮。
表 2. 局部变量
操作 测试环境 正式环境
编辑变量 - -
部署服务 -
发布服务 -

使用变量

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

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

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

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

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

最佳实践

统计会议签到人数