eeacms/xmlconv

Eionet XML Conversion and QA 镜像文档

镜像概述

本镜像为Eionet（欧洲环境信息和观测网络）提供XML格式转换与质量保证（QA）工具，旨在支持环境领域数据处理流程，实现XML数据的标准化转换及合规性验证，确保数据符合Eionet指定的技术规范和数据交换要求。

核心功能与特性

主要功能

• XML格式转换：支持不同XML Schema之间的格式转换，适配Eionet数据交换场景中的多源数据整合需求。
• 质量保证检测：内置XML结构验证、数据完整性检查及合规性校验，确保输出数据符合Eionet技术规范。
• 批处理支持：支持多文件批量转换与验证，提升大规模数据处理效率。
• 日志记录：生成详细处理日志，包含转换结果、错误信息及验证报告，便于问题排查与流程审计。

技术特性

• 基于轻量级基础镜像构建，资源占用低，部署便捷。
• 支持自定义XML Schema文件导入，适配特定场景的数据规范要求。
• 提供标准化输出报告（JSON/XML格式），便于集成至数据管理系统。

使用场景与适用范围

适用场景

• 环境监测机构向Eionet提交数据前的格式转换与合规性校验。
• 跨系统环境数据整合流程中，不同XML格式的统一化处理。
• 数据仓库构建中，对历史环境数据的标准化清洗与验证。

目标用户

• Eionet成员机构的数据管理部门。
• 环境领域科研机构的数据处理团队。
• 需对接Eionet数据平台的第三方服务提供商。

使用方法与配置说明

基础使用（Docker Run）

单文件转换与验证

bash
docker run -v /local/input:/app/input \
           -v /local/output:/app/output \
           -e INPUT_FILE=input.xml \
           -e SCHEMA_PATH=/app/schemas/eionet_main.xsd \
           eionet-xml-conv-qa:latest

批量处理

bash
docker run -v /local/input_dir:/app/input \
           -v /local/output_dir:/app/output \
           -e BATCH_MODE=true \
           -e LOG_LEVEL=INFO \
           eionet-xml-conv-qa:latest

核心配置参数（环境变量）

数据卷挂载说明

• /app/input：本地输入数据目录，需挂载至容器内该路径，存放待处理的XML文件。
• /app/output：本地输出目录，容器将转换结果、验证报告及日志文件写入该路径。
• /app/schemas（可选）：自定义Schema文件目录，若需使用非默认Schema，可挂载该目录并通过SCHEMA_PATH指定文件路径。

输出说明

• 转换后文件：位于OUTPUT_DIR，命名格式为{原文件名}_converted.xml。
• 验证报告：位于OUTPUT_DIR/reports，命名格式为{原文件名}_report.json，包含验证结果、错误详情及合规性评分。
• 处理日志：位于OUTPUT_DIR/logs，命名格式为eionet_qa_{时间戳}.log。

示例：自定义Schema验证

1. 准备本地文件结构：

   /local/
   ├── input/
   │   └── data.xml
   ├── output/
   └── schemas/
       └── custom_schema.xsd
   

2. 执行容器命令：

   bash
   docker run -v /local/input:/app/input \
             -v /local/output:/app/output \
             -v /local/schemas:/app/schemas \
             -e INPUT_FILE=data.xml \
             -e SCHEMA_PATH=/app/schemas/custom_schema.xsd \
             -e VALIDATION_ONLY=true \
             eionet-xml-conv-qa:latest
   

3. 查看结果：验证报告将生成至/local/output/reports/data_report.json。