创建物联网事件定义#

IoTEventDefinition.Create

IoTEventDefinition.CreateTemplate

IoTEventDefinition.CreateFromTemplate

概述#

此操作用于创建物联网事件定义。也可以使用类似过程创建模板，也可以使用模板创建新对象。可以在主实体菜单中完成此选择。

设置#

除了满足事务前提条件外，不需要任何特定设置。

前提条件#

• 系统中当前不存在物联网事件定义。

步骤顺序#

步骤1：一般数据#

1. 提供物联网事件定义的名称。

   Warning

   此名称将在整个数据平台基础结构中标识事件。请使用有意义的名称供以后参考。 2. （可选）提供物联网事件定义的描述。 3. 选择物联网事件定义类型。“物联网事件定义类型”查找表中介绍了可用值。此值随后可用于按类别对事件类型进行分组。 4. 键入生存时间(TTL)（以天为单位）。这是一个可选参数，用于通知此事件将储存在数据平台中的天数。如果留空（默认），系统将无限期地储存此事件（推荐）。 5. 按“下一步”选择物联网事件定义的属性。

步骤2：属性#

此步骤将捕获物联网事件定义的实际结构。在这里，您将定义事件的各个属性。

1. 在左侧面板上，根据需要添加任意多个属性（按位于网格右上角的下拉列表中的可添加，按键可删除）。该按钮允许添加顶级属性，或者，如果属性数据类型为物联网架构，则可以添加主属性的子属性。

2. 对于每个属性，请指定：

   • 属性名称 – 此名称必须与事件JSON文档匹配。它将在内部用于标识每个属性
   • 易记名称 – 用于标识属性的替代名称
   • 描述 – 属性描述
   • 数组 – 将此属性标识为对象数组
   • 必需 – 标识属性是否为必填。如果为true，则此信息将用于验证所有到达事件
   • 索引 – 定义是否可以搜索和查询属性。此外，这将确定属性是否储存在Kafka事件标头和SQL Server Storage Consumer的EventAttribute表中（请参阅SQL Sink Consumer文档）
   • 数据类型 – 属性的数据类型。必需，是一个枚举。将映射到以下JSON类型（用括号引起）
   • 布尔值（整数）
   • 字符串（字符串）
   • 整数（整数）
   • 十进制（数字）
   • 日期时间（日期-时间）
   • 时间（时间）
   • 日期（日期）
   • URL (uri)
   • 文件（字符串）– 将储存文件ID
   • 物联网架构（对象）
   • 实体类型（对象）- 将引用实体类型对象。如果是版本化实体类型，则它将引用定义。此属性的内容将由扩充过程用于将MES信息映射到原始事件的文档
   • 默认值 – 指定属性的默认值。如果接收到的事件中不存在，则此值将由事件验证过程设置
   • 最小值 – 整数类型数据类型的最小值。如果此值小于定义的值，则该事件将被拒绝
   • 最小值 – 整数类型数据类型的最大值。如果超过此值，则事件将被拒绝
   • 最小长度 – 用于检查字符串类型属性的最小长度
   • 最大长度 – 用于检查字符串类型属性的最大长度
   • 模式 – 对于字符串类型标量类型、模式，例如：^[A-Za-z]*@gmail.com$。这必须是有效的Java正则表达式（请参见链接）
   • 最大文件大小 – 用于文件类型的标量类型，最大可接受文件大小
   • 最大文件比例 – 如果数据类型为文件（千字节、兆字节、千兆字节），则为最大文件大小比例
   • 已共享 - 适用于物联网架构数据类型。将物联网架构设置为共享，通知系统创建为物联网架构对象。这对于在事件之间共享JSON文档定义非常有用（例如位置定义）

按创建完成操作，将创建新的物联网事件定义。