表达式

Amazon IoT Events提供了多种在创建和更新探测器模型时指定值的方法。您可以使用表达式来指定文字值，也Amazon IoT Events可以在指定特定值之前对表达式求值。

语法

您可以在Amazon IoT Events表达式中使用文字、运算符、函数、引用和替代模板。

文本

整数
十进制
字符串
布尔值

运算符

一元

不是（布尔值）：!
不是（按位）：~
减号（算术）：-

字符串

串联：+

两个操作数都必须是字符串。字符串字符串串串串串串串串串串串串串串串串串串串串串串串串

例如：'my' + 'string'->'mystring'

算术

加法：+

两个操作数都必须是数字。
减法：-
部门：/

除法的结果是四舍五入的整数值，除非至少有一个操作数（除数或除数）是十进制值。
乘法：*

按位（整数）

或者：|

例如：13 | 5->13
以及：&

例如：13 & 5->5
XOR：^

例如：13 ^ 5->8
不是：~

例如：~13->-14

布尔值

小于：<
小于或等于：<=
等于：==
不等于：!=
大于或等于：>=
大于：>
以及：&&
或者：||

注意
当的子表达式||包含未定义的数据时，该子表达式被视为false。

圆括号

您可以使用圆括号对表达式中的术语进行分组。

函数

内置函数

timeout("timer-name")

计算为指定的计时器true是否已过。将 “timer-nam e” 替换为您定义的计时器名称（带引号）。在事件操作中，您可以定义计时器，然后启动计时器、重置计时器或清除先前定义的计时器。参见字段detectorModelDefinition.states.onInput|onEnter|onExit.events.actions.setTimer.timerName。

在一个状态下设置的计时器可以在不同的状态下被引用。在进入引用计时器的状态之前，必须访问创建计时器的状态。

例如，探测器模型有两种状态，即 TemperatureChecked 和 RecordUpdated。您在 TemperatureChecked 状态下创建了计时器。必须先访问该 TemperatureChecked 状态，然后才能在该 RecordUpdated 状态下使用计时器。

为了确保准确性，应将计时器的最短时间为 60 秒。

注意

timeout()true仅在计时器实际到期后首次检查时返回，false之后返回。

convert(type, expression)

计算为转换为指定类型的表达式的值。类型值必须为StringBoolean、或Decimal。使用这些关键字之一或计算结果为包含该关键字的字符串的表达式。只有以下转换成功并返回有效值：

BOLEAN

返回字符串"true"或"false"。
DECIMAL
字符串-> LEAN
字符串-> DECIM

指定的字符串必须是十进制数字的有效表示形式，否则将convert()失败。

如果convert()没有返回有效值，则它所属的表达式也是无效的。此结果等同于false且不会触发actions或过渡到nextState指定值，作为表达式发生的事件的一部分。

isNull(expression)

true如果表达式返回 null，则计算为。例如，如果输入MyInput收到消息{ "a": null }，则以下计算结果为true，但isUndefined($input.MyInput.a)计算结果为false。


isNull($input.MyInput.a)

isUndefined(expression)

true如果表达式未定义，则计算为。例如，如果输入MyInput收到消息{ "a": null }，则以下计算结果为false，但isNull($input.MyInput.a)计算结果为true。


isUndefined($input.MyInput.a)

triggerType("type")

类型值可以是"Message"或"Timer"。计算结果为true是否因为计时器已过期而对其出现的事件条件进行评估，如下例所示。


triggerType("Timer")

或者收到了输入消息。


triggerType("Message")

currentInput("input")

评估其出现的事件条件true是否因为已收到指定的输入消息而被评估。例如，如果输入Command收到消息{ "value": "Abort" }，则以下计算结果为true。


currentInput("Command")

使用此函数验证是否正在评估条件，因为已收到特定输入且计时器尚未过期，如以下表达式所示。


currentInput("Command") && $input.Command.value == "Abort"

字符串匹配函数

startsWith(expression1, expression2)

计算结果为第一个字符串表达式true是否以第二个字符串表达式开头。例如，如果 inputMyInput 收到消息{ "status": "offline"}，则以下计算结果为true。


startsWith($input.MyInput.status, "off")

这两个表达式的计算结果必须为字符串值。如果任一表达式的计算结果均未为字符串值，则该函数的结果为未定义。不进行任何转换。

endsWith(expression1, expression2)

true如果第一个字符串表达式以第二个字符串表达式结尾，则计算为。例如，如果 inputMyInput 收到消息{ "status": "offline" }，则以下计算结果为true。


endsWith($input.MyInput.status, "line")

这两个表达式的计算结果必须为字符串值。如果任一表达式的计算结果均未为字符串值，则该函数的结果为未定义。不进行任何转换。

contains(expression1, expression2)

计算结果为第一个字符串表达式true是否包含第二个字符串表达式。例如，如果 inputMyInput 收到消息{ "status": "offline" }，则以下计算结果为true。


contains($input.MyInput.value, "fli")

这两个表达式的计算结果必须为字符串值。如果任一表达式的计算结果均未为字符串值，则该函数的结果为未定义。不进行任何转换。

按位整数操作函数

bitor(expression1, expression2)

计算整数表达式的按位或（对整数的相应位执行二进制 OR 运算）。例如，如果 inputMyInput 收到消息{ "value1": 13, "value2": 5 }，则以下计算结果为13。


bitor($input.MyInput.value1, $input.MyInput.value2)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果均未为整数值，则该函数的结果未定义。不进行任何转换。

bitand(expression1, expression2)

计算整数表达式的按位 AND（对整数的相应位执行二进制 AND 运算）。例如，如果 inputMyInput 收到消息{ "value1": 13, "value2": 5 }，则以下计算结果为5。


bitand($input.MyInput.value1, $input.MyInput.value2)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果均未为整数值，则该函数的结果未定义。不进行任何转换。

bitxor(expression1, expression2)

计算整数表达式的按位 XOR（对整数的相应位执行二进制 XOR 运算）。例如，如果 inputMyInput 收到消息{ "value1": 13, "value2": 5 }，则以下计算结果为8。


bitxor($input.MyInput.value1, $input.MyInput.value2)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果均未为整数值，则该函数的结果未定义。不进行任何转换。

bitnot(expression)

计算整数表达式的按位 NOT（对整数的位执行二进制 NOT 运算）。例如，如果 inputMyInput 收到消息{ "value": 13 }，则以下计算结果为-14。


bitnot($input.MyInput.value)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果均未为整数值，则该函数的结果未定义。不进行任何转换。

参考

输入

$input.input-name.path-to-data

input-name是您使用CreateInput操作创建的输入。

例如，如果您有一个名TemperatureInput为的输入定义了inputDefinition.attributes.jsonPath条目，则这些值可能会出现在以下可用字段中。


{
    "temperature": 78.5,
    "date": "2018-10-03T16:09:09Z"
  }

要引用该temperature字段的值，请使用以下命令。


$input.TemperatureInput.temperature

对于值为数组的字段，您可以使用引用数组的成员[n]。例如，给定以下值：


{
    "temperatures": [
      78.4,
      77.9,
      78.8
    ],
    "date": "2018-10-03T16:09:09Z"
  }

78.8可以使用以下命令引用该值。


$input.TemperatureInput.temperatures[2]

Variables

$variable.variable-name

variable-name是您使用CreateDetectorModel操作定义的变量。

例如，如果您使用一个名TechnicianID为的变量进行定义detectorDefinition.states.onInputEvents.actions.setVariable.variableName，则可以使用以下命令引用最近给该变量的（字符串）值。


$variable.TechnicianID

您只能使用setVariable操作来设置变量的值。你不能为表达式中的变量赋值。无法取消设置变量。例如，您不能为其分配值null。

注意

在使用不遵循（正则表达式）模式的标识符的引用中[a-zA-Z][a-zA-Z0-9_]*，必须将这些标识符括在反引号 (`) 中。例如，对名为、字段名为MyInput的输入的引用_value必须将此字段指定为$input.MyInput.`_value`。

在表达式中使用引用时，请检查以下各项：

使用引用作为具有一个或多个运算符的操作数时，请确保您引用的所有数据类型都兼容。

例如，在以下表达式中，整数2是和运&&算符的操作数。==为了确保操作数兼容，$variable.testVariable + 1并且$variable.testVariable必须引用整数或十进制。

此外，整数1是运+算符的操作数。因此，$variable.testVariable必须引用整数或十进制。
```
‘$variable.testVariable + 1 == 2 && $variable.testVariable’
```
使用引用作为传递给函数的参数时，请确保该函数支持您引用的数据类型。

例如，以下timeout("time-name")函数需要一个以双引号作为参数的字符串。如果使用对计时器名称值的引用，则必须引用带双引号的字符串。
```
timeout("timer-name")
```
注意
对于convert(type, expression)函数，如果您使用引用作为类型值，则引用的计算结果必须为StringDecimal、或Boolean。

Amazon IoT Events表达式支持整数、十进制、字符串和布尔数据类型。下表提供了不兼容的类型列表。

类型对不兼容
整数
整数
十进制，字符串
DECIMAL
字符串值

替换模板

'${expression}'

将该字符串${}标识为插值字符串。expression可以是任何Amazon IoT Events表达式。这包括运算符、函数和引用。

例如，您使用SetVariableAction操作来定义变量。variableName 是 SensorID，value 是 10。您可以创建以下替代模板。

替代模板	结果字符串
`'${'Sensor ' + $variable.SensorID}'`	`"Sensor 10"`
`'Sensor ' + '${$variable.SensorID + 1}'`	`"Sensor 11"`
`'Sensor 10: ${$variable.SensorID == 10}'`	`"Sensor 10: true"`
`'{\"sensor\":\"${$variable.SensorID + 1}\"}'`	`"{\"sensor"\:\"11\"}"`
`'{\"sensor\":${$variable.SensorID + 1}}'`	`"{\"sensor\":11}"`

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

使用其他Amazon服务

用量