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

# 檢視轉換任務歷史記錄
<a name="transformation-job-history"></a>

Amazon Q 提供完整的 Java 轉換任務歷史記錄概觀，可讓您追蹤和檢閱 IDE 與命令列中的轉換任務。

轉換任務歷史記錄包含下列任務的相關資訊：
+ **日期** - 轉換任務何時執行
+ **專案名稱** - 已轉換的專案名稱
+ **狀態** - 轉換任務的目前狀態
+ **持續時間** - 轉換完成所花的時間
+ **任務 ID** - 轉換任務的唯一識別符
+ **差異修補程式** - 顯示所有程式碼變更的最終差異修補程式檔案的連結或路徑
+ **摘要** - 包含所做變更詳細資訊的轉換摘要檔案的連結或路徑

**注意**  
只有此功能發行後執行的轉換才會在任務歷史記錄中提供。如需功能發行日期，請參閱 [《Amazon Q Developer 使用者指南》文件歷史記錄](doc-history.md)。

## 在 IDE 中檢視任務歷史記錄
<a name="ide-job-history"></a>

**注意**  
目前這項功能只在 Visual Studio Code 中提供。

Visual Studio Code 中的 Transformation Hub 提供了完整的 Java 轉換任務歷史記錄檢視。

Transformation Hub 中的表格列出過去 30 天內最近的 10 個轉換任務。從表格中，您可以存取轉換成品和重新整理任務，以追蹤進度並取得缺少的成品。

### 擷取轉換成品
<a name="retrieve-artifacts"></a>

您可以從任務歷史記錄表存取轉換成品，例如差異修補程式和摘要檔案。選擇適當的連結，以在 IDE 中開啟差異或摘要。

成品儲存在本機 `.aws/transform` 目錄中，因此您也可以存取先前從過去任務下載的轉換成品。

### 重新整理任務狀態
<a name="refresh-jobs"></a>

您可以從任務歷史記錄表重新整理任務狀態。重新整理失敗的任務，以便從伺服器端取得可能尚未到達您伺服器的更新狀態 (例如，在 Amazon Q 能夠繼續執行失敗的任務時)。您也可以重新整理已完成的任務，以下載可能尚未出現的成品。

### 如何針對 IDE 中執行的任務儲存任務歷史記錄
<a name="ide-history-storage"></a>

對於 Visual Studio Code，所有轉換任務資訊和成品都會儲存在本機的 `.aws/transform` 目錄中。儲存空間組織方式如下：

```
.aws/transform/
├── [project-name-1]/
│   ├── [job-id-1]/
│   │   ├── diff.patch
│   │   ├── [summary-1]/
│   │   │   └── summary.md
│   │   │   └── buildCommandOutput.log
│   └── [job-id-2]/
│       ├── diff.patch
│       ├── [summary-2]/
│       │   └── summary.md
│       │   └── buildCommandOutput.log
└── [project-name-2]/
    └── [job-id-3]/
        ├── diff.patch
        ├── [summary-3]/
        │   └── summary.md
        │   └── buildCommandOutput.log
```

## 在命令列上檢視任務歷史記錄
<a name="cli-job-history"></a>

對於命令列上的轉換，**qct history** 命令可讓您使用自訂選項存取轉換任務歷史記錄。

對於 CLI，轉換任務歷史記錄資訊會儲存在本機的 `.aws/qcodetransform/history/` 目錄中。

### 使用 qct 歷史記錄命令
<a name="cli-history-command"></a>

檢視轉換任務歷史記錄的基本命令為：

```
qct history
```

根據預設，此命令會顯示最近的 10 個轉換任務，以及任何暫停或進行中的任務。

您也可以使用 **--limit** 旗標指定要顯示的任務歷史記錄項目數。例如，若要顯示 20 個任務，請執行：

```
qct history --limit 20
```