本页目录

Action节点根据入站的消息执行各种动作。

• Math函数
• 清除警报
• 延迟
• 生成节点
• 日志节点
• RPC调用回复
• RPC调用请求
• 保存属性
• 保存时间序列
• 保存到自定义表
• 分配给客户
• 取消分配给客户
• 创建关系
• 删除关系
• GPS地理围栏事件
  • 从消息元数据中获取边界信息
  • 从节点配置中获取周边信息
  • 事件类型
• 推送到云
• 推送到edge
• Add To Group Node
• Remove From Group Node
• Generate Report Node
• Integration Downlink Node
• REST Call Reply Node
• Change Owner Node

Math函数

Math函数规则节点应用数学计算并将结果保存到消息或数据库中。请参阅下表支持的函数：

使用5种类型的参数：

• 常量；
• 参数来自消息；
• 参数来自元数据；
• 参数来自属性；
• 参数来自遥测；

此规则节点的主要用例是从数据库中获取一个或多个值，并根据消息中的数据修改它们。例如：可以根据设备报告的totalWaterConsumption增加deltaWaterConsumption。

另一种用例是用更轻量级和高性能的实现替换简单的JS script节点。例如：可以使用自定义操作和表达式将华氏度转换为摄氏度(C = (F - 32) / 1.8) 自定义操作符和表达式: (x - 32) / 1.8)。

执行在消息发起方（例如设备）和服务器节点的范围内同步，如果规则节点位于不同的规则链中则它们将在服务器节点的作用域中同步处理来自同一发起方的消息

函数的结果可以添加到消息正文或元数据中还可以将结果作为属性或时间序列保存到数据库中。

该节点尝试加载为消息发起者配置的Alarm Type最新警报。

如果存在Uncleared警报则将更新此警报否则将创建新的警报。

节点配置:

• Alarm Details Builder 脚本
• Alarm Type - 代表警报类型的任何字符串
• Alarm Severity - {CRITICAL | MAJOR | MINOR | WARNING | INDETERMINATE}
• 是否传播 - 是否将警报传播到所有与父相关的实体。

注意：自TB版本2.3.0起规则节点具有以下功能：

• 从消息中读取警报配置：

• 使用带有消息元数据字段的模式来获取警报类型：

  

注意：自TB版本2.4.3起规则节点具有以下功能：

• 按关系类型过滤传播到父实体：

  

Alarm Details Builder用于生成警报详细信息JsonNode。

这对于在Alarm内部存储其他参数很有用；例如：可以从原始消息payload或Metadata中保存属性名称/值对。

Alarm Details Builder脚本应返回details对象。

• 消息payload可以通过msg变量访问。例如：msg.temperature
  
• 可以通过metadata变量访问消息。例如：metadata.customerName
  
• 可以通过msgType变量访问。例如：msgType
  

可选:可以通过访问先前的警报详细信息metadata.prevAlarmDetails。 如果先前的警报不存在则该字段将不会出现在元数据中。注意这个metadata.prevAlarmDetails 是一个原始的String字段，需要使用以下结构将其转换为对象:

1
2
3
4
var details = {};
if (metadata.prevAlarmDetails) {
    details = JSON.parse(metadata.prevAlarmDetails);
}

Alarm Details Builder可以使用Test JavaScript function来验证警报详细信息生成器脚本功能。

Details Builder 功能示例

count会从警报中获取属性并进行递增最后将temperature消息payload的属性放入警报详细信息。

1
2
3
4
5
6
7
8
9
10
var details = {temperature: msg.temperature, count: 1};

if (metadata.prevAlarmDetails) {
    var prevDetails = JSON.parse(metadata.prevAlarmDetails);
    if(prevDetails.count) {
        details.count = prevDetails.count + 1;
    }
}

return details;

:使用以下属性创建/更新警报

• Alarm details - object returned from 从Alarm Details Builder 脚本中返回对象
• Alarm status - 如果是 new alarm -> ACTIVE_UNACK. 如果是 existing Alarm -> 不改变
• Severity - 节点中配置的值
• Propagation - 节点中配置的值
• Alarm type - 节点中配置的值
• Alarm start time - 如果是 new alarm -> 当前系统时间. 如果是 existing Alarm -> 不改变
• Alarm end time - 当前系统时间

出站消息具有以下结构:

• Message Type - 警报
• Originator - 入站消息具有相同的消息发起者
• Payload - 以JSON的形创建和更新警报
• Metadata -原始消息中的所有Metadata字段

创建警报后出站消息将在Metadata中包含isNewAlarm属性其值为true消息将通过Created链传递。

现有警报更新后出站消息将在Metadata中包含isExistingAlarm属性其值为true消息将通过Updated链传递。

这是出站消息的payload示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "tenantId": {
    "entityType": "TENANT",
    "id": "22cd8888-5dac-11e8-bbab-ad47060c9bbb"
  },
  "type": "High Temperature Alarm",
  "originator": {
    "entityType": "DEVICE",
    "id": "11cd8777-5dac-11e8-bbab-ad55560c9ccc"
  },
  "severity": "CRITICAL",
  "status": "ACTIVE_UNACK",
  "startTs": 1526985698000,
  "endTs": 1526985698000,
  "ackTs": 0,
  "clearTs": 0,
  "details": {
    "temperature": 70,
    "ts": 1526985696000
  },
  "propagate": true,
  "id": "33cd8999-5dac-11e8-bbab-ad47060c9431",
  "createdTime": 1526985698000,
  "name": "High Temperature Alarm"
}

可以在本教程中中找到有关Thingsboard中警报的更多详细信息

在下一面教程中你可以看到使用该节点的真实示例：

• 生成和清除警报

清除警报

该节点加载具有为消息发起者配置的Alarm Type的最新警报并清除警报（如果存在）。

节点配置:

• Alarm Details Builder脚本
• Alarm Type - 代表警报类型的任何字符串

Alarm Details Builder脚本用于更新警报详细信息JsonNode。 这对于在Alarm内部存储其他参数很有用；例如：可以从原始消息payload或Metadata中保存属性名称/值对。

Alarm Details Builder脚本应返回详细信息对象。

• 消息payload可以通过msg变量访问。例如：msg.temperature
  
• 可以通过metadata变量访问消息。例如：metadata.customerName
  
• 可以通过msgType变量访问。例如：msgType
  
• 当前的报警信息可以通过metadata.prevAlarmDetails访问

注意 metadata.prevAlarmDetails是一个原始字符串字段需要使用此结构将其转换为对象:

1
2
3
4
var details = {};
if (metadata.prevAlarmDetails) {
    details = JSON.parse(metadata.prevAlarmDetails);
}

可以使用Test JavaScript function验证警报详情构建器脚本函数。

Details Builder功能示例

count会从警报中获取属性并进行递增。最后将 temperature消息payload的属性放入警报详细信息。

1
2
3
4
5
6
7
8
9
10
var details = {temperature: msg.temperature, count: 1};

if (metadata.prevAlarmDetails) {
    var prevDetails = JSON.parse(metadata.prevAlarmDetails);
    if(prevDetails.count) {
        details.count = prevDetails.count + 1;
    }
}

return details;

更新节点当前警报：

• 如果已经确认警报状态则将警报状态更改为CLEARED_ACK否则更改为CLEARED_UNACK
• 为当前系统设置确切的时间
• 使用从Alarm Details Builder返回的新对象更新警报细节

当警报不存在或已清除警报时原始消息将通过false链传递到下一个节点，否则新的消息将通过Cleared链传递。

出站消息的结构如下:

• Message Type - ALARM
• Originator - 来自入站消息的同一发起者
• Payload - JSON表示清除的警报
• Metadata - 来自原始消息元数据的所有字段，元数据中的额外属性将被添加：isClearedAlarm值为True。

这是出站消息的payload示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "tenantId": {
    "entityType": "TENANT",
    "id": "22cd8888-5dac-11e8-bbab-ad47060c9bbb"
  },
  "type": "High Temperature Alarm",
  "originator": {
    "entityType": "DEVICE",
    "id": "11cd8777-5dac-11e8-bbab-ad55560c9ccc"
  },
  "severity": "CRITICAL",
  "status": "CLEARED_UNACK",
  "startTs": 1526985698000,
  "endTs": 1526985698000,
  "ackTs": 0,
  "clearTs": 1526985712000,
  "details": {
    "temperature": 70,
    "ts": 1526985696000
  },
  "propagate": true,
  "id": "33cd8999-5dac-11e8-bbab-ad47060c9431",
  "createdTime": 1526985698000,
  "name": "High Temperature Alarm"
}

可在本教程中找到有关Thingsboard中警报的更多详细信息

在下一面教程中你可以看到使用该节点的真实示例：

• 生成和清除警报

延迟

通过配置的时间段延迟入站消息。

配置:

• Period in seconds - 指定应暂停入站消息的时间段
• Maximum pending messages - 指定允许的最大未处理消息数（已暂停消息的队列）

当到满特定入站消息的延迟时间时将从挂起队列中删除并通过Success链路由到下一个节点。

如果达到最大消息限制则每个下一条消息将通过Failure链进行路由。

生成节点

生成具有可配置周期的消息JavaScript函数用于生成消息。

节点配置:

• 消息生成频率以秒为单位
• 消息发起者
• JavaScript函数将生成实际的消息。

JavaScript函数接收3个输入参数:

• prevMsg - 是先前生成的消息的payload.
• prevMetadata - 是先前生成的消息的metadata.
• prevMsgType - 是先前生成的消息类型.

脚本应返回以下结构:

1
2
3
4
5
{   
    msg: new payload,
    metadata: new metadata,
    msgType: new msgType 
}

结果对象中的所有字段都是可选的如果未指定则将从先前生成的Message中获取。

来自此节点的出站消息将是使用已配置的JavaScript函数构造的新消息。

使用Test JavaScript function来验证JavaScript生成器功能。

该节点可用于规则链调试

日志节点

使用配置好的JavaScript函数将传入消息转换为String并将最终值记录到Thingsboard日志文件中。

INFO 日志级别用于记录.

JavaScript函数接收3个输入参数

• metadata - 消息metadata.
• msg - 消息payload.
• msgType - 消息类型.

脚本应返回字符串值。

JavaScript转换功能可以使用Test JavaScript function进行验证。

在下一面教程中你可以看到使用该节点的真实示例：

• RPC调用回复

RPC调用回复

发送从设备来的RPC调用的回复

发送从设备来的RPC调用的回复所有入站的RPC请求都通过规则链作为消息传递，同样所有RPC请求都具有请求ID字段它用于映射请求和响应，消息发起者必须是Device实体因为已向消息发起者发起了RPC响应。

节点配置具有特殊的请求ID字段映射如果未指定映射则默认使用requestId元数据字段。

可以通过不同的传输方式接收RPC请求:

• MQTT
• HTTP
• CoAP

消息payload示例

1
2
3
4
5
6
7
{
  "method": "setGpio",
  "params": {
    "pin": "23",
    "value": 1
  }
}

在以下情况下消息将通过Failure链进行路由：

• 入站消息发起者不是Device实体
• 消息元数据中不存在请求ID
• 入站消息payload为空

有关RPC如何在Thingsboard中工作的更多详细信息请阅读RPC功能文章。

在下一面教程中你可以看到使用该节点的真实示例：

• RPC调用回复

RPC调用请求

将RPC请求发送到设备并将响应路由到下一个Rule节点消息发起者必须是Device实体因为只能向设备发起RPC请求。

节点配置具有Timeout字段用于指定等待设备响应的超时。

RPC请求的payload消息正确格式必须包含method 和params字段。

例：

1
2
3
4
5
6
7
{
  "method": "setGpio",
  "params": {
    "pin": "23",
    "value": 1
  }
}

如果Payload消息包含requestId字段则其值用于标识对设备的RPC请求否则将生成随机的requestId。

出站消息将具有与入站消息相同的发起者和元数据对于设备的响应将添加到消息Payload中。

在以下情况下消息将通过Failure链进行路由：

• 入站消息发起者不是Device实体
• 入站消息丢失了method或params字段
• 节点在配置超时期间不接收响应

否则消息将通过Success链路由

有关RPC如何在Thingsboard中应用请阅读RPC功能文章了解更多信息。

保存属性

接收入站消息payload的属性存储到数据库中并将它们与消息发起者标识的实体相关联，通过范围用于标识属性范围。

支持的范围类型:

• 客户端属性
• 共享属性
• 服务端属性

预期消息类型为POST_ATTRIBUTES_REQUEST。 如果消息类型不是POST_ATTRIBUTES_REQUEST消息将通过fFailure链路由.

当属性通过现有API(HTTP/MQTT/CoAP等)上传时如果消息类型payload满足要求，那么消息将被传递到Root Rule Chain的Input节点。

如果需要在规则链中触发属性存储则需要配置规则链将消息Payload转换为预期格式并将消息类型设置为 POST_ATTRIBUTES_REQUEST。可以使用脚本转换节点完成。

预期消息Payload的例子:

1
2
3
4
{
  "firmware_version": "1.0.1",
  "serial_number": "SN-001"
}

成功保存属性后原始消息将通过Success链传递到下一个节点否则将使用Failure链。

保存时间序列

将接入站消息的payload时间序列数据存储到数据库，并将它们与消息发起者标识的实体相关联通过配置TTL秒用于时间序列数据到期时间0表示数据永不过期。

预期消息类型为POST_TELEMETRY_REQUEST如果消息类型不是POST_TELEMETRY_REQUEST则将通过Failure链路由消息。

当timeseries数据通过现有的API(HTTPMQTT/CoAP等)发布时如果消息类型和payload满足要求，那么消息将被传递到Root Rule Chain链的Input节点。

在需要触发规则链内的timeseries数据存储时应配置规则链来转换消息playload将消息类型设置为POST_TELEMETRY_REQUEST。

可以使用脚本转换节点完成该操作。

消息元数据必须包含ts字段。

该字段可识别已发布的遥测技术几毫秒内的时间戳。

此外如果消息元数据包含TTL字段则使用该字段值识别timeseries数据期限否则请使用节点配置中的TTL。

预期消息Payload的例子:

1
2
3
4
5
6
{  
  "values": {
    "key1": "value1",
    "key2": "value2"
  }
}

成功保存timeseries数据之后原始消息将通过Success链传递到下一个节点否则使用Failure链。

保存到自定义表

节点将来自传入消息payload的数据存储到Cassandra DB数据库中存储到应该具有cs_tb__前缀的预定义定制表中以避免将数据插入到公共TB表中。

请注意该规则节点只能用于Cassandra DB

配置:

管理员应设置不带前缀的自定义表名称: cs_tb_。

管理员可以配置消息字段名称和表的列名称之间的映射如果映射键为$entity_id由消息发起者标识则将消息发起者id写入适当的列名（映射值）。

如果指定的消息字段不存在或不是JSON则出站消息将通过Failure链进行路由否则消息将通过Success链进行路由。

分配给客户

将消息发起者实体分配给Customer。

支持以下消息发起者类型: Asset,Device,Entity View,Dashboard。

通过客户名称模式查找目标客户然后将发起者实体分配给该客户。

如果不存在(Create new Customer if not exists)将创建新客户如果不存在将创建新客户设置为true。

配置:

• Customer name pattern - 可以设置直接的客户名称也可以使用，将使用消息元数据将其解析为真实的客户名称。
• Create new customer if not exists - 则创建新客户-如果选中则将创建不存在的新客户。
• Customers cache expiration time - 指定允许存储找到的客户记录的最大时间间隔（以秒为单位）0值表示记录永不过期。

在以下情况下消息将通过Failure链进行路由：

• 不支持发起者实体类型时。
• 目标客户不存在未选中创建客户如果不存在（Create customer if not exists）

在其他情况下消息将通过Success链进行路由。

取消分配给客户

从Customer取消分配消息发起者实体

支持以下消息发起者类型: Asset, Device, Entity View, Dashboard。

通过客户名称模式查找目标客户然后从该客户取消分配发起者实体。

配置:

• Customer name pattern - 可以设置直接的客户名称也可以使用模式，将使用消息元数据将其解析为真实的客户名称。
• Customers cache expiration time - 指定允许存储找到的客户记录的最大时间间隔（以秒为单位）0值表示记录永不过期。

在以下情况下消息将通过Failure链进行路由：

• 不支持发起者实体类型时。
• 目标客户不存在.

在其他情况下消息将通过Success链进行路由。

创建关系

按类型和方向创建从所选实体到消息发起者的关系。

支持以下消息发起者类型: Asset,Device,Entity View,Customer,Tenant,Dashboard。

通过元数据键模式查找目标实体然后在发起方实体和目标实体之间创建关系。

如果选择的实体类型为Asset,Device或Customer规则节点: 则如果不存在则创建新的Entity并选中复选框Create new Entity if not exists.

注意: 如果选择的实体类型为Asset或Device则需要设置两种模式:

• 实体名称模式；

• 实体类型模式。

否则仅应设置名称模式。

配置:

• Direction - 允许下列类型: From,To。
• Relation type - 与消息始发者实体的定向连接的类型可以从下拉列表中选择默认类型Contains和Manages。
• Name pattern and Type pattern - 可以设置直接实体名称/类型也可以使用模式使用消息元数据将其解析为真实实体名称/类型。
• Entities cache expiration time - 指定允许存储找到的目标实体记录的最大时间间隔（以秒为单位）0值表示记录永不过期。

在以下情况下消息将通过 Failure 链进行路由:

• 不支持发起者实体类型时。
• 目标实体不存在。

在其他情况下消息将通过Success链进行路由

注意: 自TB 2.3版以来规则节点具有以下功能:

• 根据方向和类型从传入消息的发起者中删除当前关系:

  

• 将入站消息的始发者更改为所选实体并将出站消息作为来自另一个实体的消息进行处理:

  

删除关系

按类型和方向删除所选实体与消息发起者之间的关系。

支持以下消息发起者类型: Asset,Device,Entity View,Customer,Tenant,Dashboard。

通过实体名称模式查找目标实体然后删除发起者实体与该实体之间的关系。

配置:

• Direction - 允许下列类型: From,To。
• Relation type - 与消息始发者实体的定向连接的类型可以从下拉列表中选择默认类型Contains和Manages。
• Name pattern and Type pattern - 可以设置直接实体名称/类型也可以使用模式，使用消息元数据将其解析为真实实体名称/类型。
• Entities cache expiration time - 指定允许存储找到的目标实体记录的最大时间间隔（以秒为单位）0值表示记录永不过期。

在以下情况下消息将通过 Failure 链进行路由:

• 不支持发起者实体类型时。
• 目标实体不存在。

在以下情况下消息将通过Success链进行路由。

注意: 自TB版本2.3起规则节点可以通过禁用规则节点配置中的以下复选框来根据方向和类型从传入消息的始发者删除与指定实体或与实体列表的关系:

GPS地理围栏事件

通过基于GPS的参数生成传入消息从入的消息数站据或元数据中提取纬度和经度并根据配置参数（地理围栏）返回不同的事件。

默认情况下规则节点从消息元数据中获取外围信息。

如果未选中从Fetch perimeter information from message metadata则应配置其他信息。

从消息元数据中获取边界信息

根据边界类型，有两种区域定义选项:

• 多边形

  传入消息的元数据必须包含具有名称perimeter和以下数据结构的密钥

1
[[lat1,lon1],[lat2,lon2], ... ,[latN,lonN]]

• 圆形

1
2
3
4
5
"centerLatitude": "value1", "centerLongitude": "value2", "range": "value3"

从节点配置中获取边界信息

"rangeUnit"键列表中的值按照METER, KILOMETER, FOOT, MILE, NAUTICAL_MILE (必须大写字母)。

从节点配置中获取周边信息

根据边界类型，有两种区域定义选项:

• 多边形

• 圆形

事件类型

地理围栏规则节点管理的事件有4种:

• Entered — -每当传入消息的纬度和经度首次属于所需的外围区域时报告;
• Left — 第一次报告来自传入消息的纬度和经度不属于所需的外围区域时;
• Inside 和 Outside 事件用于报告当前状态.

管理员可以配置持续时间阈值以报告内部事件或外部事件。

例如：每当最小内部时间设置为1分钟时消息发件人就被视为进入该区域后60秒之内最少的外部时间也定义了何时将消息发起者视为不在外围范围之内。

在以下情况下将使用Failure链:

• 传入消息在数据或元数据中没有配置的纬度(latitude)或经度(longitude)键；
• 缺少边界定义。

推送到云

将消息从edge推送到云此节点仅用于在edge上将消息从边缘推送到云。消息到达此节点后将被转换为云事件并保存到本地数据库。Node不会将消息直接推送到云，而是将事件存储在云队列中。

支持发起者类型：

• DEVICE
• ASSET
• ENTITY_VIEW
• DASHBOARD
• TENANT
• CUSTOMER
• EDGE

支持消息类型：

• POST_TELEMETRY_REQUEST
• POST_ATTRIBUTES_REQUEST
• ATTRIBUTES_UPDATED
• ATTRIBUTES_DELETED
• ALARM

如果成功存储edge事件到数据库消息将通过Success琏路由。

以下情况下消息将通过Failure链路由：

• 节点无法将边缘事件保存到数据库
• 不支持的发起者类型
• 不支持的消息类型

推送到edge

将消息从云推送到边缘消息发起方必须分配给特定的边缘或者消息发起方是EDGE实体本身，此节点仅用于在云实例上将消息从云推送到边缘消息到达此节点后将被转换为边缘事件并保存到数据库中Node不会将消息直接推送到边缘而是将事件存储在边缘队列中。

支持发起者类型：

• DEVICE
• ASSET
• ENTITY_VIEW
• DASHBOARD
• TENANT
• CUSTOMER
• EDGE

支持消息类型：

• POST_TELEMETRY_REQUEST
• POST_ATTRIBUTES_REQUEST
• ATTRIBUTES_UPDATED
• ATTRIBUTES_DELETED
• ALARM

如果成功存储边缘事件到数据库消息将通过Success琏路由。

以下情况下消息将通过Failure链路由：

• 节点无法将边缘事件保存到数据库
• 不支持的发起者类型
• 不支持的消息类型

Add To Group Node

ThingsBoard PE功能

仅限专业版支持PE Action Nodes功能。
基于ThingsBoard云服务或专业版平台实例。

Adds Message Originator Entity to Entity Group.

Following Message Originator types are allowed: Customer, Asset, Device.

Finds target Entity Group by group name pattern and then adds Originator Entity to this group. Will create new Entity Group if it doesn’t exist and Create new group if not exists is set to true.

Configuration:

• Group name pattern - can be set direct group name or pattern can be used, that will be resolved to the real group name using Message metadata.
• Create new group if not exists - if checked will create new entity group if it doesn’t exist.
• Groups cache expiration time - specifies maximum time interval is seconds allowed to store found entity group records. 0 value means that records will never expire.

Message will be routed via Failure chain in the following cases:

• When Originator entity type is not supported.
• Target entity group doesn’t exist and Create new group if not exists is unchecked.

In other cases Message will be routed via Success chain.

Remove From Group Node

ThingsBoard PE功能

仅限专业版支持PE Action Nodes功能。
基于ThingsBoard云服务或专业版平台实例。

Removes Message Originator Entity from Entity Group.

Following Message Originator types are allowed: Customer, Asset, Device.

Finds target Entity Group by group name pattern and then removes Originator Entity from this group.

Configuration:

• Group name pattern - can be set direct group name or pattern can be used, that will be resolved to the real group name using Message metadata.
• Groups cache expiration time - specifies maximum time interval is seconds allowed to store found entity group records. 0 value means that records will never expire.

Message will be routed via Failure chain in the following cases:

• When Originator entity type is not supported.
• Target entity group doesn’t exist.

In other cases Message will be routed via Success chain.

Generate Report Node

ThingsBoard PE功能

仅限专业版支持PE Action Nodes功能。
基于ThingsBoard云服务或专业版平台实例。

Generates report files by capturing target dashboard with specific configuration.

This node can be configured to use specific report configuration or take it from incoming message body.

Mode when report configuration is taken from message body usually is used when message is generated by Generate Report Scheduler Event.

Generate Report node invokes Reports Server to generate report file using specified dashboard.

Resulting report file is stored in DataBase using File Storage feature and reference to this file is stored in attachments field of output message metadata.

attachments metadata field can be used by other Rule Nodes to get actual file from DataBase. For instance To Email Node detects presence of this field and prepares email attachments used by Send Email Node to send email with attachments.

Configuration:

• Use system reports server - if set, Reports Server endpoint URL will be taken from system configuration (thingsboard.yml).
• Reports server endpoint URL - endpoint URL of Reports Server.
• Use report config from message - if set, report generation configuration will be taken from incoming message body.
• Base URL - base URL of ThingsBoard UI that should be accessible by Report Server.
• Dashboard - dashboard that will be used for report generation.
• Dashboard state parameter value - used to specify target dashboard state for report generation. Can be set automatically by clicking on right most button of the field and invoking Select dashboard state dialog.
• Timezone - timezone in which target dashboard will be presented in report.
• Use dashboard timewindow - if set, timewindow configured in the target dashboard will be used during report generation.
• Timewindow - specific dashboard timewindow that will be used during report generation.
• Report name pattern - file name pattern of generated report, can contain date-time pattern in form of %d{date-time pattern}. See SimpleDateFormat documentation for date-time pattern details.
• Report type - report file type, can be PDF | PNG | JPEG.
• Use current user credentials - if set, credentials of user created this report configuration will be used to open dashboard UI during report generation.
• Customer user credentials - target customer user whose credentials will be used to open dashboard UI during report generation.

Generate Test Report button is used for testing purposes. It invokes report generation process with provided configuration. Resulting report file will be automatically downloaded if the report generation will be successful.

Message will be routed via Failure chain in the following cases:

• When Use report config from message is set and incoming message does not contain valid report configuration JSON object.
• When Reports Server is unavailable at the specified endpoint URL.
• When Reports Server will fail generate report and return corresponding error message.

In other cases Message will be routed via Success chain.

Integration Downlink Node

ThingsBoard PE功能

仅限专业版支持PE Action Nodes功能。
基于ThingsBoard云服务或专业版平台实例。

Forwards Message to selected Integration as downlink message.

Message will be pushed to the selected integration downlink queue.

Configuration:

• Integration - target Integration for downlink message processing.

Failure chain is used if Message push to Integration will fail, otherwise Success chain.

REST Call Reply Node

ThingsBoard PE功能

仅限专业版支持PE Action Nodes功能。
基于ThingsBoard云服务或专业版平台实例。

Sends reply to REST API call that was originally sent to rule engine.

Expects messages with any message type. Forwards incoming message as a reply to REST API call sent to rule engine.

Configuration:

Change Owner Node

ThingsBoard PE功能

仅限专业版支持PE Action Nodes功能。
基于ThingsBoard云服务或专业版平台实例。

Changes Owner of the Originator entity to the selected Owner by type:

• Tenant

• Customer

Rule node finds target Owner by owner name pattern and then change the owner of the originator entity.

• Owner name pattern - can be set direct customer name or pattern can be used, that will be resolved to the real customer name using Message metadata.
• Create new owner if not exists - if checked will create new owner(customer) if it doesn’t exist.
• Owner cache expiration time - specifies maximum time interval is seconds allowed to store found owners(customers) records. 0 value means that records will never expire.

If an entity already belongs to this owner or entity owner is successfully changed - Message sent via Success chain, otherwise, Failure chain will be used.