waste4think/ngsi-connector

Waste4Think NGSI Connector API

镜像概述

Waste4Think NGSI Connector API是Waste4Think项目后端实现的核心组件，作为FIWARE平台的NGSIv2 REST API绑定，提供从文件操作Fiware Orion实体的接口，支持数据完整性校验与批量处理。

核心功能

• 从CSV/JSON文件批量创建实体，支持自定义规则验证数据结构
• 从文件批量更新实体（全量或部分更新）
• 代理Fiware Orion所有GET查询操作，用于验证数据创建结果
• 生成操作报告，包含成功/失败实体数量及详细状态（ID、类型、状态）

使用场景

• 批量导入实体数据到Fiware Orion实例
• 批量更新现有实体的属性信息
• 查询Fiware Orion中的实体数据
• 确保导入数据的格式正确性与完整性

配置说明

配置文件config.js关键参数：

javascript
const config = {}; 
config.orion_url = "http://localhost:1026/"; // Fiware Orion实例地址
config.api_port = "3002"; // 连接器运行端口
config.ext = [ ".csv", ".json" ]; // 允许的文件扩展名
config.https = true; // 是否启用HTTPS
config.returnEntities = 20; // 查询返回实体的默认数量（最大1000）
module.exports = config;

Docker部署示例

基础运行（默认配置）

bash
docker run -p 3002:3002 --name ngsi-connector docker.xuanyuan.run/waste4think/ngsi-connector

自定义配置（挂载config.js）

bash
docker run -p 3002:3002 -v /path/to/your/config.js:/opt/nconnector/config.js --name ngsi-connector docker.xuanyuan.run/waste4think/ngsi-connector