firely/validator

.NET FHIR 验证器镜像文档

镜像概述和主要用途

该镜像为官方提供的.NET FHIR验证器，基于.NET框架构建，旨在验证FHIR（Fast Healthcare Interoperability Resources）资源的结构与内容是否符合指定的FHIR规范版本。它提供了全面的合规性检查能力，支持***健康领域中FHIR资源的开发、集成和质量管理，是确保FHIR数据互操作性的核心工具。

核心功能和特性

• 多版本支持：兼容FHIR各主要版本，包括DSTU2 (1.0.2)、STU3 (3.0.1)、R4 (4.0.1)、R4B (4.3.0)及R5 (5.0.0)。
• 全面验证能力：支持结构验证（基于FHIR架构定义）、业务规则验证（规范约束检查）、引用验证（资源间引用有效性）及扩展验证（自定义扩展合规性）。
• 灵活输出格式：可生成详细验证报告，支持文本、JSON或XML格式，包含错误、警告、信息级别提示及具体位置信息。
• 命令行接口：提供简洁的命令行参数，支持单文件/批量目录验证、自定义实现指南（IG）加载及结果过滤。
• 轻量级设计：基于.NET Runtime构建，启动快速，适合集成到CI/CD流程或自动化脚本中。

使用场景和适用范围

• ***健康开发者：在FHIR资源开发阶段验证资源合规性，确保符合目标版本规范。
• ***机构：对内部/外部交换的FHIR数据进行质量检查，保障数据互操作性。
• FHIR系统集成商：构建FHIR服务器、客户端或数据转换工具时，集成验证功能确保资源处理准确性。
• 数据管理场景：数据导入FHIR系统前批量验证资源，避免不合规数据进入生产环境。

使用方法和配置说明

获取镜像

通过微软容器注册表（MCR）获取官方镜像：

bash
docker pull ***-mcr.xuanyuan.run/dotnet/fhir-validator:latest

基本使用示例

1. 验证单个FHIR资源文件（JSON格式）

验证本地patient.json（R4版本）并输出JSON格式报告：

bash
docker run --rm -v $(pwd):/data ***-mcr.xuanyuan.run/dotnet/fhir-validator:latest validate \
  --input /data/patient.json \
  --version R4 \
  --output /data/validation-report.json \
  --format json

2. 批量验证目录资源

递归验证/local/fhir-resources目录下所有资源，输出摘要报告：

bash
docker run --rm -v /local/fhir-resources:/data ***-mcr.xuanyuan.run/dotnet/fhir-validator:latest validate \
  --input /data \
  --version R4 \
  --recurse \
  --summary \
  --output /data/batch-summary.txt

常用配置参数

注意事项

• 确保待验证文件格式（JSON/XML）与--version指定的FHIR版本兼容。
• 自定义IG需为有效FHIR IG包格式（如.tgz或目录），并通过--ig正确指定路径。
• 批量验证大型文件时建议增加内存限制（如--memory=4g）。