TR50 方法

当 TR50 方法触发器事件由解决方案的另一部分调用时,将执行该事件。TR50 方法(包括其通知变量和完成变量)在网关的物模型中进行定义。物联网设备管理门户提供 TR50 方法事件触发器与解决方案调用部分之间的通信支持。TR50 方法事件触发器由以下对象调用:

物方法可以有选择地定义以下内容:

  • 通知变量,此类变量将从调用方传递至 TR50 方法触发器
  • 完成变量,此类变量将从 TR50 方法触发器传回调用方。

定义 TR50 方法事件触发器

要定义 TR50 方法事件触发器,请按照以下步骤操作:

  1. 从工作台左侧窗格中,展开要在其中定义 TR50 方法事件触发器的节点。
  2. 单击 Project(项目)图标以显示 Projects(项目)窗口
  3. 右键单击特定项目,显示弹出菜单后选择 New(新建)。
    如果已选择特定项目选项卡,还可选择 Projects(项目)窗口底部的 New(新建)按钮。
  4. 随即显示新 Trigger(触发器)窗口。
    为触发器命名。触发器名称最多可包含 64 个字符,包括字母、数字和下划线字符。允许有空格。
  5. Event(事件)选项卡中,选择 Trigger Event Type(触发器事件类型)向下箭头,展开 Thing(物)类别,然后选择 TR50 Method(TR50 方法)。

    Event(事件)选项卡将激活,包含容纳 TR50 方法事件的参数。
参数 描述
TR50 Connection(TR50 连接) 用于检索物模型 ID 信息的 TR50 连接。

 (可选)如果未指定,使用默认 TR50 连接。

Thing Definition ID(物模型 ID) 物模型 ID,定义见于物联网设备管理门户。工作台根据 TR50 Connection(TR50 连接)参数,从物联网设备管理门户检索物模型。
Thing Definition Method(物模型方法) 物模型方法,定义见于物联网设备管理门户。从 Thing Definition ID(物模型 ID)参数指定的物模型中检索相应的方法。

TR50 方法事件类型触发器事件变量

TR50 方法事件触发器可用的事件变量包括:

事件变量 数据类型 描述
Connection Name STRING 接收此事件的 TR50 连接名称。
From STRING 方法的“调用方”。可以是:
  • 从 Management Portal(管理门户)-> Thing page(物页面)-> Methods(方法)选项卡执行该方法时的用户 ID
  • 使用 API 从网关或外部应用程序执行该方法时的物键值。
Message ID STRING 可用于将 TR50 方法触发器执行与调用方进行关联的字符串。例如,使用管理门户 API 日志。
ThingKey STRING 为其定义物方法的物的物键值。
Input variables 已配置输入变量的数据类型 每个物方法通知变量都将作为 TR50 方法事件触发器中的输入事件变量。这些输入事件变量可用作触发器动作中的源变量。
Output variables 已配置输出变量的数据类型 每个物方法完成变量都将作为 TR50 方法事件触发器中的输出事件变量。这些输出事件变量可用作触发器动作中的目标变量。

物方法、TR50 方法触发器和执行方法动作定义注意事项

定义 TR50 方法触发器时,工作台通过从物联网设备管理门户检索信息来获取关于物方法的信息,特别是从定义要使用 TR50 连接的帐户。

常见的触发器开发模式如下:

  1. 使用管理门户来定义物方法。定义 TR50 方法触发器和调用执行方法动作时,工作台将为您访问此集中信息。物方法的定义包括:
    • 方法的名称
    • 输入变量(将由执行方法动作提供)
    • True 或 False 发送响应选项
    • 输出变量(当发送响应为 True 时,从 TR50 方法触发器返回到执行方法动作)。
      有关更多信息,请参见定义方法
  2. 在将要执行的网关上定义 TR50 方法触发器。定义 TR50 方法触发器时,将通过引用以下内容从物联网设备管理门户检索信息:
    • TR50 Connection(TR50 连接)用于确定从中检索物模型信息的帐户。
    • Thing Definition ID(物模型 ID)
    • Thing Definition Method(物模型方法)。
  3. 保存 TR50 方法触发器。
  4. 在需要“调用”或执行 TR50 方法触发器的网关上,定义触发器并添加 执行方法(执行方法)动作。
    定义执行方法动作时,将从物联网设备管理门户检索用于网关上(物)所有当前定义的物方法(位于相同物联网设备管理门户帐户)的信息。
  5. 选择所需的物方法,并完成任何输入和输出变量的分配。
  6. 保存触发器,其中将包括从指定帐户上的物联网设备管理门户检索到的所有物方法信息。
  7. 出于任何原因再次编辑触发器时,物联网设备管理门户将查询当前物方法信息。
  8. 如果物方法发生更改(例如:不同输入变量、发送响应选项从 False 变为 True、更改为输出变量),将需要编辑和更新在执行方法动作中使用物方法的所有其他触发器。
相关主题

执行方法

method.exec 动作

method.exec

触发器物键值和物模型

子触发器

按需