!Banner

概述

一个用于根据Table Schema验证CSV内容的Web应用程序。支持通过多种渠道进行验证：

• Web用户界面：供用户手动使用。
• REST API：用于机器对机器集成。
• SOAP API：用于机器对机器集成及GITB TDL一致性测试用例。

此镜像作为特定验证器实例的通用基础，需提供应用配置。该配置包括：

• 要使用的验证工件（一个或多个Table Schema定义）。
• 自定义验证器的配置（例如界面风格、验证类型和选项）。

此外，您也可使用此镜像创建通用验证器，其具有最小默认设置，要求验证 schema 与待验证输入一同提供。

本镜像由欧盟委员会DIGIT部门及旗下互操作性测试平台（为参与跨境公共服务交付的项目提供一致性测试服务）维护。更多信息见此处。

使用方法

此镜像可作为构建特定验证器（基于您自己的配置）的基础，或直接用作通用验证器（要求验证工件与待验证内容一同提供，如现有服务）。

选项1：创建特定验证器

创建特定验证器可通过两种方式：构建包含配置的自定义镜像，或向基于基础镜像构建的容器传递配置。无论哪种方式，验证器应用均内部暴露于8080端口。

镜像版本可选择latest标签（获取快速更新）或特定标记的发布里程碑（确保稳定性优先）。

方法1：使用自定义镜像

假设从包含所有配置资源的文件夹构建（资源位于子文件夹resources），示例Dockerfile如下：

dockerfile
FROM isaitb/csv-validator:latest
COPY resources /validator/resources/
ENV validator.resourceRoot /validator/resources/

方法2：直接使用基础镜像

此方法需使用卷（命名卷或卷）。使用卷创建容器的命令如下：

bash
docker run -d --name my-validator -p 8080:8080 \
             -v /validator/resources:/validator/resources/ \
             -e validator.resourceRoot=/validator/resources/  \
             isaitb/csv-validator

选项2：创建通用验证器

通用验证器实例无预定义配置，包含默认最小配置，要求schema与待验证输入一同提供。创建通用验证器实例只需直接使用当前镜像，无需提供任何配置：

bash
docker run -d --name my-validator -p 8080:8080 isaitb/csv-validator

文档

有关使用此镜像设置、配置和管理验证器的完整详情，请参阅测试平台的CSV验证指南。

源代码

CSV验证器作为开源软件发布于GitHub。

变更历史

最新快照和各里程碑版本的变更列表见文档的变更日志。

许可证

本工具采用欧盟公共许可证（EUPL）1.2版授权。

本软件包含的第三方库的许可证和归属信息见此处。

***声明

本工具作者不对其使用或结果解释承担任何责任。在数据方面，本工具不会收集、处理任何可关联到用户或工作站的数据，也不会保留任何使用状态或统计信息。

联系方式

如需反馈或提问，请通过以下渠道联系：

• 在验证器的GitHub仓库创建issue。
• 发送邮件至***。

相关资源

如果您对本镜像感兴趣，可能也会对我们针对其他语法的类似验证器感兴趣：

• XML验证器（isaitb/xml-validator）：使用XML Schema和Schematron验证XML数据。
• SHACL验证器（isaitb/shacl-validator）：使用SHACL验证RDF数据。
• JSON验证器（isaitb/json-validator）：使用JSON Schema验证JSON数据。