FUXA项目中WebAPI设备标签配置指南

FUXA项目中WebAPI设备标签配置指南

FUXA Web-based Process Visualization (SCADA/HMI/Dashboard) software 项目地址: https://gitcode.com/gh_mirrors/fu/FUXA

概述

在工业自动化系统中，FUXA作为一个开源的SCADA/HMI解决方案，提供了与WebAPI接口集成的能力。本文将详细介绍如何在FUXA项目中配置WebAPI设备的标签(Tag)系统，帮助开发者实现数据采集和监控功能。

WebAPI数据格式要求

FUXA对WebAPI返回的数据格式有特定要求。API应返回一个JSON数组，其中每个对象代表一个数据点，包含以下字段：

• id: 数据点的唯一标识符(UUID格式)
• name: 数据点的名称
• value: 数据点的当前值
• type: 数据类型(支持number/boolean/string三种类型)

示例数据格式如下：

[
    {
        "id": "tempA",
        "name": "tempA",
        "value": 123,
        "type": "number"
    },
    {
        "id": "tempB",
        "name": "tempB",
        "value": 23.5,
        "type": "number"
    }
]

配置步骤详解

1. 设备添加

   • 在FUXA界面中添加新设备
   • 选择设备类型为"WebAPI"
   • 配置正确的API端点URL(如http://localhost:5050/api/test)

2. 数据接收验证

   • 成功添加设备后，系统会自动获取API返回的数据
   • 在设备详情页面可以查看接收到的原始数据

3. 标签配置关键步骤

   • 进入标签(Tag)配置界面
   • 对于数组类型的响应数据，需要明确选择每个数据点的ID和Value字段
   • 注意：不同于OPC-UA等协议，WebAPI的标签选择界面没有复选框设计，而是通过字段选择方式实现

常见问题解决方案

1. 无法选择标签的问题

   • 确保API返回的是有效的JSON数组
   • 检查每个数据对象是否包含必需的字段(id, name, value, type)
   • 对于数组数据，需要分别选择ID和Value字段，而不是期望整个对象被选中

2. 数据类型不匹配

   • 确认type字段的值严格匹配(number/boolean/string)
   • 确保value字段的值与type声明一致

3. 连接问题排查

   • 验证API端点可访问性
   • 检查跨域设置(CORS)是否允许FUXA访问

最佳实践建议

1. 为保持数据一致性，建议在API端实现稳定的ID生成机制
2. 对于大量数据点，考虑实现分页或增量更新机制
3. 在API设计中加入时间戳字段，便于数据同步和状态监控
4. 考虑实现数据变化推送机制，而非仅依赖轮询方式

通过以上配置和优化，开发者可以充分利用FUXA的WebAPI集成能力，构建高效可靠的工业数据采集和监控系统。

FUXA Web-based Process Visualization (SCADA/HMI/Dashboard) software 项目地址: https://gitcode.com/gh_mirrors/fu/FUXA