本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 開始使用 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 文件 （醫院記錄、出院摘要、continuity-of-care文件）。
   + CSV：表格式匯出 （資料倉儲擷取、EHR 一般檔案、宣告資料）。

1. 選擇如何初始化設定檔：
   + 對於 C-CDA：從 AWS 入門設定檔 （具有常見section-to-resource映射的預先建置設定檔） 開始。
   + 對於 CSV：提供包含代表性 CSV 檔案的資料夾的 Amazon S3 路徑。AI 代理器會分析您的檔案並產生基本設定檔。

1. 輸入設定檔名稱和選用描述。

1. 選擇建立。

設定檔會以草稿狀態 （版本 0) 建立：您可以自由編輯的可變工作副本。

## 步驟 3：使用資料轉換 AI 代理器自訂 （選用）
<a name="data-transformation-getting-started-console-step3"></a>

對於 C-CDA 設定檔：

1. 開啟設定檔並前往編輯檢視；資料轉換 AI 代理程式面板會顯示在右側。

1. 描述自然語言的變更 （例如，「將預設狀態設定為 Washington for Patient 資源」)。

1. 代理程式會編輯 Velocity 範本。

1. 選取測試索引標籤，貼上您的範例 C-CDA，然後按一下執行測試以預覽轉換。

1. 反覆運算，直到輸出正確為止。

對於 CSV 設定檔：

1. 代理程式會分析您的範例檔案，並提議 YAML 映射：column-to-FHIR 映射、日期/值轉譯、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. 填寫任務詳細資訊：
   + 任務名稱：描述性名稱 （出現在 CloudWatch 日誌和指標中）。
   + 描述：選用。

1. 設定轉換設定：
   + 資料來源格式：C-CDA 或 CSV。
   + 轉換設定檔：選擇已發佈的設定檔 （僅顯示版本 ≥ 1 的已發佈設定檔）。
   + 輸出模式：
     + Amazon Amazon S3：將轉換後的 FHIR 寫入 Amazon S3 位置 （獨立轉換）。
     + AWS HealthLake：將 和 直接轉換為 HealthLake 資料存放區。如果選取，請選擇目標 HealthLake 資料存放區 （必須處於 ACTIVE 狀態）。
   + Provenance：預設為啟用。產生 FHIR Provenance 資源，將輸出追蹤回來源。只有在不需要來源時才停用。
   + 偏離偵測：預設為啟用。產生顯示未映射來源元素的報告。

1. 設定來源資料：
   + Amazon S3 來源位置：包含來源檔案的 Amazon S3 資料夾 （必須包含字首，而不只是儲存貯體名稱）。
   + 資料存取角色：HealthLake 擔任的 IAM 角色會讀取您的來源檔案和寫入輸出。如需信任和許可政策[設定](data-transformation-setting-up.md)，請參閱 。

1. 設定輸出組態 （如果）：
   + 輸出 Amazon S3 URI：寫入轉換後的輸出和任務日誌的位置。
   + AWS KMS 金鑰：加密靜態輸出的 AWS KMS 金鑰 （必要）。

1. 選擇建立任務。

## 步驟 6：檢閱結果
<a name="data-transformation-getting-started-console-step6"></a>

1. 任務詳細資訊頁面會顯示即時進度：狀態、處理的檔案 (CSV 的資料列）、產生的 FHIR 資源和失敗。

1. 完成後，導覽至輸出的 Amazon S3 位置。服務會使用任務 ID，在您的輸出 URI 下建立任務範圍資料夾。在該資料夾中：
   + converted/：FHIR NDJSON 輸出檔案 （每個輸入檔案一個，例如 converted/patient-record.ndjson)。
   + ERROR/：失敗輸入的錯誤詳細資訊 （具有 inputFile 和 errorMessage 欄位的 JSON 檔案，例如 ERROR/bad-file.json)。
   + Manifest.json：具有彙總指標的任務摘要 （掃描、轉換、失敗、產生資源的檔案）。
   + jobLevelDriftResult.json:任務的彙總偏離報告 （如果啟用偏離偵測）。
   + driftDetectionPerFileResults/：C-CDA 任務的每個檔案偏離報告 （如果已啟用偏離偵測），例如 driftDetectionPerFileResults/patient-record\_driftMetrics.json。