固件升级¶

固件升级元素是一项任务，通过发送 HTTP 请求在 EnOS 创建用于批量升级固件的 OTA 任务。

由于该任务需要待升级固件的相关信息，你可以在先前的任务里创建一个表单，以便从用户处收集所需信息。

备注

可使用包含 OTA 固件升级状态表单元素的用户任务来查看升级状态。如果需要根据升级状态判断下游路径，需将固件升级边界事件附加到该用户任务。

属性¶

下表描述了该任务的属性。

属性	描述
名称	指定可供参考的名称。
固件描述	指定固件升级任务的名称。可使用 UEL 表达式从表单中提取对应的信息。
固件	指定固件 ID。可使用 UEL 表达式从固件下拉选择表单元素的变量中提取对应的信息。
升级策略	指定升级策略（snapshot，incremental）。可使用 UEL 表达式从静态下拉选择表单元素的变量中提取对应的信息。
升级范围	指定待升级设备的范围（total，partial）。可使用 UEL 表达式从静态下拉选择表单元素的变量中提取对应的信息。
待升级版本	指定待升级固件版本。可使用 UEL 表达式从固件版本下拉选择表单元素的变量中提取对应的信息。
待升级设备	指定待升级设备的键。可使用 UEL 表达式从设备下拉选择表单元素的变量中提取对应的信息。
升级推送开始时间	指定推送升级请求的时间窗口的开始时间。可使用 UEL 表达式从表单中提取对应的信息。
升级推送结束时间	指定推送升级请求的时间窗口的结束时间。可使用 UEL 表达式从表单中提取对应的信息。
允许设备请求升级	指定是否允许设备主动请求升级。可使用 UEL 表达式从表单中提取对应的信息。
升级说明	指定固件升级任务的说明。可使用 UEL 表达式从表单中提取对应的信息。
结果变量名	指定标识存储响应参数所用 JSON 变量的唯一名称。创建的任务 ID 将存储在参数 `data.jobId` 中。
状态码变量名	指定标识存储响应状态码所用变量的唯一名称。状态码 0 表示任务成功。

备注

如果要在后续的流程元素中显示或处理任务结果，则需要指定变量名称。

结果¶

以下代码显示了任务成功时返回的结果示例。

{
   "code":0,
   "msg":"OK",
   "requestId":"2d0c9305-0877-43fb-9c93-bf1e89fd9546",
   "data":{
      "jobId":"5f18fbbe4f051a001b222f5d"
   }
}

如果已指定了变量名，则所有参数都将存储在结果变量中，而 code 参数还将存储在状态码变量中。可使用点符号获取参数值。例如，如果结果变量名为“result”，可使用 ${result.data.jobId} 提取创建的任务 ID。

有关在 EnOS 创建批量升级固件任务的更多信息以及每个属性的详细信息，参见：