本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 开始使用 AWS 管理控制台
<a name="data-transformation-getting-started-console"></a>

## 步骤 1：导航到数据转换代理
<a name="data-transformation-getting-started-console-step1"></a>

1. 打开 [AWS HealthLake 控制台](https://console.aws.amazon.com/healthlake/)。

1. 在登录页面上，单击 “开始”，然后选择 “转换数据”。

1. 在左侧导航栏的 “数据转换代理” 部分下，选择 “配置文件” 以管理配置文件，或选择 “作业” 以运行转换。

## 步骤 2：创建转换配置文件
<a name="data-transformation-getting-started-console-step2"></a>

1. 在左侧导航栏中选择 “个人资料”，然后单击 “创建个人资料”。

1. 选择源格式：
   + C-CDA: 临床 XML 文档（医院记录、出院摘要、持续护理文件）。
   + CSV：表格导出（数据仓库摘录、EHR 平面文件、索赔数据）。

1. 选择如何初始化配置文件：
   + 适用于 C-CDA：从 AWS 入门配置文件（具有常见分区到资源映射的预建配置文件）开始。
   + 对于 CSV：提供指向包含代表性 CSV 文件的文件夹的 Amazon S3 路径。AI 代理会分析您的文件并生成基本配置文件。

1. 输入配置文件名称和可选描述。

1. 选择创建。

配置文件是在草稿状态（版本 0）下创建的：一个可以自由编辑的可变工作副本。

## 步骤 3：使用数据转换 AI 代理进行自定义（可选）
<a name="data-transformation-getting-started-console-step3"></a>

对于 C-CDA 个人资料：

1. 打开配置文件并进入编辑视图；数据转换 AI 代理面板显示在右侧。

1. 描述自然语言的变化（例如，“将患者资源的默认州设置为华盛顿州”）。

1. 代理编辑 Velocity 模板。

1. 选择 “测试” 选项卡，粘贴您的示例， C-CDA 然后单击 “运行测试” 以预览转换。

1. 迭代直到输出正确。

对于 CSV 配置文件：

1. 代理会分析您的示例文件并提出 YAML 映射：列到 FHIR 的映射、转 date/value 换、 PK/FK 关系和聚合规则。

1. 查看每个建议的映射：接受、拒绝或完善。

1. 要求以自然语言进行调整（例如，“将 RACE\_CD 列映射到 FHIR 扩展名”）。

1. 在测试选项卡中预览转换结果（左边是源代码，右边是 FHIR 输出）。

## 第 4 步：发布个人资料
<a name="data-transformation-getting-started-console-step4"></a>

1. 如果满意，请选择 “发布”。这将创建一个不可变的版本。

1. 您的草稿仍可编辑。批量作业始终使用最新发布的版本。

回滚：选择以前的版本并重新发布。这会根据之前的快照创建新版本：不会删除任何内容。

## 步骤 5：运行转换作业
<a name="data-transformation-getting-started-console-step5"></a>

1. 在左侧导航栏中的 “数据转换代理” 下，选择 “作业”。

1. 选择 “开始新作业”。

1. 填写 Job 详情：
   + Job 名称：描述性名称（出现在 CloudWatch 日志和指标中）。
   + 描述：可选。

1. 配置转换设置：
   + 数据源格式： C-CDA 或 CSV。
   + 转换配置文件：选择已发布的配置文件（仅显示版本 ≥ 1 的已发布配置文件）。
   + 输出模式：
     + 亚马逊 Amazon S3：将转换后的 FHIR 写入亚马逊 S3 地点（独立转换）。
     + AWS HealthLake：直接转换并采集到 HealthLake 数据存储中。如果选中，请选择目标 HealthLake 数据存储（必须处于 ACTIVE 状态）。
   + 来源：默认启用。生成 FHIR 来源资源，将输出追溯到源头。只有在不需要出处时才禁用。
   + 漂移检测：默认启用。生成显示未映射源元素的报告。

1. 配置源数据：
   + Amazon S3 源位置：包含您的源文件的 Amazon S3 文件夹（必须包含前缀，而不仅仅是存储桶名称）。
   + 数据访问角色：IAM 角色 HealthLake 假设读取您的源文件并写入输出。[设置](data-transformation-setting-up.md)有关信任和权限策略，请参阅。

1. 配置输出配置（如果）：
   + 输出 Amazon S3 URI：在哪里写入转换后的输出和任务日志。
   + AWS KMS key：加密静态输出的 AWS KMS 密钥（必填）。

1. 请选择创建任务。

## 步骤 6：查看结果
<a name="data-transformation-getting-started-console-step6"></a>

1. 作业详细信息页面显示实时进度：状态、已处理的文件（CSV 行数）、生成的 FHIR 资源和失败。

1. 完成后，导航到输出的 Amazon S3 位置。该服务使用作业 ID 在您的输出 URI 下创建一个任务范围的文件夹。在那个文件夹里：
   + converted/: FHIR NDJSON 输出文件（每个输入文件一个，例如-record.ndjson）。 converted/patient
   + ERROR/：失败输入的错误详情（例如，带有 inputFile 和 ErrorMessage 字段的 JSON 文件）。 ERROR/bad-file.json
   + Manifest.json：包含汇总指标的任务摘要（文件已扫描、已转换、失败、生成的资源）。
   + jobLevelDriftResult.json：作业的汇总偏差报告（如果启用了偏差检测）。
   + driftDetectionPerFileResults/： C-CDA 作业的每个文件偏差报告（如果启用了偏差检测），例如 driftDetectionPerFileResults/patient-Metrics.json record\_drift。