变量主要用于存储和传递数据。物联网应用开发（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脚本节点使用变量。

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

最佳实践

统计会议签到人数