> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 訓練

> 撰寫訓練內容與測驗，指派給員工群組，依期間追蹤完成情形，並由每週摘要提醒仍欠缺課程的人員。

**訓練**用來追蹤您的人員必須修習的課程，以及他們是否已經完成。講師撰寫每項訓練的內容與測驗；主管將訓練指派給員工群組，並可手動記錄完成情形；員工完成訓練，且只要仍有未完成的項目，就會收到每週提醒。

## 概覽

| 概念 | 說明 |
| - | - |
| **訓練** | 一門課程：書面內容加上選用的測驗。 |
| **指派** | 將一項訓練連結到一個或多個員工群組。 |
| **完成** | 記錄某位員工在某一期間完成了某項指派。 |
| **期間** | 週期性訓練必須完成的時間範圍：一季、一年，或一次性訓練則無期間。 |

### 位置與使用權限

訓練屬於資源的一部分：**資源 → 人員 → 訓練**是目錄，**指派**則顯示誰欠缺什麼。

| 動作 | 檢查的權限 |
| - | - |
| 檢視訓練、管理指派、標記完成 | `resources` |
| 編輯訓練的欄位 | `people` |

### 範例

您建立一項「精密量測」訓練，類型為**「強制」**，頻率為**「每年」**，並指派給「品質檢驗員」群組。該群組的每位成員在當年度都是**「待處理」**，直到完成為止，且只要尚未完成，每週日都會收到提醒。

## 建立訓練

1. 開啟**新增訓練**表單。輸入**名稱**，並可選擇性填寫**授予能力**。
2. 在**屬性**面板中設定其餘欄位。每項變更一做出就會儲存。
3. 在詳細資料頁撰寫內容並新增測驗題目。
4. 選擇頁面標題列中的**發布**，讓訓練變為啟用中。

Alforse screenshot**訓練詳細資料頁：左側是題目清單，中間是書面內容編輯器，右側是屬性面板**

題目在左，內容在中，屬性在右。

### 訓練欄位

| 欄位 | 值 | 說明 |
| - | - | - |
| `name`（必填） | 文字 | 訓練的標題。 |
| `type` | 強制、選填 | 是否必須完成。它決定清單中的標章，而對強制訓練而言，表示所有被指派者都必須完成。 |
| `frequency` | 一次、每季、每年 | 必須重複的頻率。**「一次」**只需完成一次。**「每季」**與**「每年」**為週期性：完成情形依期間追蹤，並在每個新期間重新開始。 |
| `status` | 草稿、啟用中、已封存 | 訓練本身的生命週期，從頁面標題列變更（見下文）。 |
| `content` | 富文字，以 JSON 儲存 | 員工在作答前閱讀的書面教材。 |
| `grantsAbilityId` | 一項能力 | 完成訓練後授予或更新的能力。 |
| `estimatedDuration` | 自由文字 | 訓練所需時間的大略說明。 |
| `tags` | 自由文字 | 用於篩選目錄的標籤。 |

### 訓練狀態

這是訓練本身的狀態。請勿與員工的完成狀態混淆，後者說明於[下文](#completion-status)。

| 狀態 | 說明 |
| - | - |
| **草稿** | 撰寫中；尚不適合指派。 |
| **啟用中** | 已發布並使用中。指派與提醒只對啟用中的訓練有作用。 |
| **已封存** | 已停用。保留作為記錄，不再指派。 |

可用屬性中的**狀態**選擇器變更，或在訓練為草稿時，選擇標題列中的**發布**。

NOTE

**在草稿中編輯，在啟用中完成**

只有當訓練為\*\*「草稿」**時才能編輯內容與題目，而員工只能開啟並完成**「啟用中」\*\*的訓練。若要修改已發布的訓練，請先將它改回草稿。

## 內容與測驗

### 書面內容

您在訓練詳細資料頁的編輯器中撰寫內容，並會隨著輸入自動儲存。員工在回答題目之前會先閱讀這些內容。

### 測驗題目

訓練可以包含測驗。每個題目只屬於一項訓練，在順序中有其位置，且為必答或選答。您在詳細資料頁新增題目，並可重新排序。

題目共有五種類型：

| 類型 | 員工的作答方式 | 答案存放於 |
| - | - | - |
| **單選**（MultipleChoice） | 從清單中選出唯一的正確答案 | `options`、`correctAnswers` |
| **多選**（MultipleAnswers） | 從清單中選出所有正確答案（一個或多個） | `options`、`correctAnswers` |
| **對／錯**（TrueFalse） | 回答對或錯 | `correctBoolean` |
| **配對組合**（MatchingPairs） | 將左側項目與右側項目配對 | `matchingPairs`（JSON 配對） |
| **數值**（Numerical） | 輸入數字，依 `correctNumber` 在 `tolerance` 容差範圍內評分 | `correctNumber`、`tolerance` |

## 指派訓練

您將訓練指派給**群組**，而不是個別員工。一筆指派把一項訓練連結到一份群組清單，這些群組中的每位員工都欠缺該訓練。

NOTE

**群組成員資格決定報名**

指派儲存的是群組 ID，而不是員工 ID。每當 Alforse 計算誰欠缺該訓練時，會將群組展開為其成員，因此把某人加入群組就會自動讓他報名，不需要重新指派。

### 管理指派

* **開啟名冊。** 點選清單中的指派。名冊會顯示每位成員、其目前狀態、已完成者的完成日期，以及**「標記為完成」**按鈕。
* **變更群組。** 在列選單中選擇**編輯指派**。
* **通知。** 指派訓練時，會通知新納入範圍的員工（請見[通知](https://docs.alforse.com/zh-Hant/docs/reference/notifications.md)）。

## 追蹤完成情形

### 完成記錄

Alforse 針對每位員工、每筆指派、每個期間記錄一次完成，並附上完成時間與記錄者。對週期性訓練，該記錄還會儲存一個 `period` 字串，避免同一位員工在同一期間被記錄兩次。

### 期間

期間是週期性訓練得以運作的關鍵。Alforse 依訓練的頻率推導出目前的期間：

| 頻率 | 期間 | 效果 |
| - | - | - |
| **一次** | 無（`NULL`） | 一次完成永遠有效。 |
| **每季** | 例如 `Q1-2026` 的字串 | 在某一季完成，不計入下一季。 |
| **每年** | 例如 `2026` 的字串 | 每年年初重新開始。 |

### 完成狀態

員工的狀態不會被儲存；Alforse 會依目前期間是否存在完成記錄，以及員工的到職日計算。它會是以下四個值之一：

| 狀態 | 說明 |
| - | - |
| **待處理** | 已指派、在目前期間、尚未完成。這是起始狀態。 |
| **已完成** | 該員工與該期間存在完成記錄。 |
| **逾期** | 某個週期性期間已結束，而員工尚未完成。 |
| **不需要** | 員工在該期間結束後才到職，因此從未適用於他們。 |

HEADS UP

**新進人員不會對過去的期間逾期**

對週期性訓練，Alforse 會將員工的到職日與每個期間比較。在某個期間結束後才加入的人，該期間會顯示\*\*「不需要」**而非**「逾期」\*\*，因此新進人員的記錄一開始不會充滿逾期的訓練。

### 手動標記完成

主管在指派名冊上用**「標記為完成」**記錄完成情形。完成記錄會記入目前期間。已經是**「已完成」**或**「不需要」**的員工沒有這個按鈕，因為沒有需要記錄的內容。

## 每週提醒

每週日 21:00 UTC，排程工作會尋找未完成的訓練。它會收集**「待處理」**與**「逾期」**的指派，並向每位受影響的員工傳送一封摘要。

| 屬性 | 值 |
| - | - |
| 事件 | `TrainingReminder`（`training-reminder`） |
| 主題 | `Training` |
| 電子郵件標題 | **「Training reminder」** |
| 按鈕 | **「View training」** |

這是 Alforse 中唯一的週期性通知事件，因此設有上限。

NOTE

**每個期間最多五次提醒**

在目前期間內，某項未完成訓練的提醒電子郵件成功送達五封之後，Alforse 就會停止傳送該提醒。對每季與每年的訓練，次數是依期間計算的，所以新期間開始時會重新計數。當有人說提醒「不再寄來」，這個上限通常就是原因。

有兩個一次性事件用來通知新的指派：**「Training assigned to you」**（`training-assignment`）與**「New training available」**（`resource-training-assignment`）。傳送方式與偏好設定請見[通知](https://docs.alforse.com/zh-Hant/docs/reference/notifications.md)。

## 透過訓練授予能力

**能力**記錄員工具備某項製程的資格。排程器與生產現場會用能力來決定誰可以執行該製程。

若要讓訓練授予能力，請在其屬性中設定**授予能力**。完成訓練後，該能力就會加到員工身上。訓練只是其中一種途徑：主管也可以在該人員的能力頁面手動新增能力。

## 相關內容

**人員**

員工，以及他們的能力與訓練記錄。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/people.md)

**通知**

訓練指派與提醒的傳送方式。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.