开源项目 `healthcare-data-harmonization` 使用教程

开源项目 healthcare-data-harmonization 使用教程

healthcare-data-harmonization This is an engine that converts data of one structure to another, based on a configuration file which describes how. There is an accompanying syntax to make writing mappings easier and more robust. 项目地址: https://gitcode.com/gh_mirrors/he/healthcare-data-harmonization

1. 项目的目录结构及介绍

healthcare-data-harmonization/
├── doc/
│   ├── README.md
│   └── ...
├── gradle/
│   └── wrapper/
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── mappings/
│   └── ...
├── plugins/
│   └── ...
├── proto/
│   └── ...
├── quickrun/
│   └── ...
├── runtime/
│   └── ...
├── testutil/
│   └── ...
├── tools/
│   └── ...
├── transpiler/
│   └── ...
├── wstl1/
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
├── build.gradle
├── cloudbuild.yaml
├── gradle.properties
└── settings.gradle

目录结构介绍

• doc/: 包含项目的文档文件，如 README.md 等。
• gradle/wrapper/: 包含 Gradle Wrapper 的相关文件，用于确保项目使用特定版本的 Gradle。
• mappings/: 包含数据映射的配置文件。
• plugins/: 包含项目的插件文件。
• proto/: 包含项目的中间表示（Intermediate Representation）文件。
• quickrun/: 包含快速运行项目的相关文件。
• runtime/: 包含项目的执行引擎文件。
• testutil/: 包含单元测试的辅助工具文件。
• tools/: 包含项目的各种工具文件。
• transpiler/: 包含语法到中间表示的转换器文件。
• wstl1/: 包含 Whistle 1 的遗留文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目的主 README 文件。
• build.gradle: Gradle 构建文件。
• cloudbuild.yaml: Google Cloud Build 配置文件。
• gradle.properties: Gradle 属性配置文件。
• settings.gradle: Gradle 设置文件。

2. 项目的启动文件介绍

项目的启动文件主要集中在 runtime/ 目录下，该目录包含了执行引擎的核心代码。启动项目时，通常需要执行以下步骤：

1. 克隆项目仓库:

   git clone https://github.com/GoogleCloudPlatform/healthcare-data-harmonization.git
   cd healthcare-data-harmonization
   

2. 构建项目:

   gradle build
   

3. 运行测试:

   gradle test
   

4. 启动项目: 具体的启动命令和配置文件路径可以在 runtime/ 目录下的相关文件中找到。

3. 项目的配置文件介绍

项目的配置文件主要集中在 mappings/ 目录下，该目录包含了数据映射的配置文件。配置文件通常使用 Whistle 语言编写，用于描述如何将一种数据结构转换为另一种数据结构。

配置文件示例

// mappings/example_mapping.wstl
source: {
    field1: "value1",
    field2: "value2"
}

target: {
    newField1: source.field1,
    newField2: source.field2
}

配置文件介绍

• source: 定义源数据的结构。
• target: 定义目标数据的结构。
• 映射规则: 使用 Whistle 语言描述如何从源数据映射到目标数据。

通过这些配置文件，用户可以自定义数据转换的规则，实现不同数据结构之间的转换。

healthcare-data-harmonization This is an engine that converts data of one structure to another, based on a configuration file which describes how. There is an accompanying syntax to make writing mappings easier and more robust. 项目地址: https://gitcode.com/gh_mirrors/he/healthcare-data-harmonization