# 匯入客戶 ## **概述** 客戶匯入功能讓你能一次性批量匯入客戶資料於系統。例如你原來在 Excel 表中的資料，或者從其他系統導出的資料，可通過此功能快速的轉移到 FIRST LINE。 ## **範本管理** 名單匯入功能可透過點擊「應用程式」中的「客戶」分類中的「客戶匯入」進入匯入管理頁面。匯入管理頁面包含「匯入範本」、「匯入紀錄」和一個「新增匯入」按鈕。 * **匯入範本：** 在進行匯入之前，需要為匯入檔案新增一個對應的範本，設定檔案中的欄位內容。初次設定後，之後的匯入將更加便捷，同時保持高度的擴展性和協同操作。 * **匯入紀錄：** 每一次匯入都會被詳細記錄，包括開始時間、結束時間、成功數等，甚至原始檔案都會被保存，以方便您管理名單的來龍去脈。 * **新增匯入按鈕：** 點擊後將進入設定畫面，下方將進一步詳細介紹相關內容。

## **新增範本** ### 基本資料 1. **範本名稱**：必填欄位，用於辨別所使用的匯入範本，你可根據名單來源、欄位內容進行命名，如 XX銀行名單、網路購物會員名單等，方便操作人員識別。 2. **描述**：額外補充範本資料，此欄位也會顯示於範本列表，方便用於識別。 ### 比對條件你可以在「比對條件」中新增判斷是否為重複客戶的條件。當系統根據這些條件找到相同客戶時，將會進行更新。例如，如果將「比對條件」設為「客戶編號」，在下次匯入時，會比對新資料中的「客戶編號」，如果發現相同編號的客戶，則會自動更新其資料。為確保匯入資料的正確性與可控性，「比對條件」設計具備以下邏輯與限制： #### 1. 比對條件邏輯 * 可自定一或多個欄位作為「唯一識別依據」。 * **所有條件需同時滿足**，才會視為同一筆客戶資料並執行更新。 * **任一條件不符，或缺值、格式不一致等，將視為新客戶**，將新增資料。 #### 2. 常見錯誤來源 * 多重比對條件但實際匯入資料不一致（如地址略有不同、標點符號不同），會導致無法比對成功。 * 指定欄位（如「客戶編號」）在匯入資料中缺值或留空，視為比對失敗。 #### 3. 多筆符合的處理 * 若比對條件導致命中多筆現有資料（例如重複的「姓氏＋編號」），將不針對現有符合客戶更新，而會採用項目一的條件不符情境，避免不確定性問題。 #### 4. 不設定比對條件 * 將一律視為新增客戶資料，無論是否與既有資料雷同。

### 範本編輯您可以透過範本編輯頁面右側的預設欄位，進行「點擊」或是「拖曳」的操作，將欄位加入至左側的範本中，以新增對應的欄位。 **如果客戶自訂欄位中有必填欄位，請務必連同新增至範本內，否則將被檢核規則阻擋**。確保您的範本包含了所有必填欄位，以順利進行名單匯入。

## 開始匯入 ### 確認匯入檔案符合欄位與格式在進行名單匯入之前，請確認您的匯入檔案（CSV）的欄位是否與您所設定的匯入範本相符。**此外，請確保您的匯入檔案是使用UTF-8編碼，以確保正確匯入資料。**若匯入檔案的編碼不正確，系統可能無法正確辨識檔案內容。

### 選擇匯入檔案的匯入範本設定完成後，請找到您本次要使用的範本，在右側點選「開始匯入」，開啟匯入視窗。在上傳檔案時，如果原始資料中包含表頭，請勾選進階設定，以避免將表頭內容視為資料進行匯入。這樣可以確保匯入的正確性。

### 開始匯入當您點選「進行匯入」後，頁面上方將顯示進度條，顯示匯入的狀態。同時，您可以切換到「匯入紀錄」分頁，查看每筆資料的上傳紀錄，包括成功與否以及匯入筆數等資訊。如果以後有需要，您還可以從該筆紀錄後方點選「下載匯入檔案」，以獲取當時該筆匯入的原始資料，方便進行管理和保存。

## 常見錯誤項目 ### 沒有匯入成功或欄位錯誤當無法成功匯入時，可以點擊進入「匯入紀錄」，查看每一筆被拒絕匯入的原因。若發現大量筆數無法匯入，請檢查以下可能原因： 1. **匯入檔案與範本不一致：** 確保您匯入的檔案欄位與所設定的匯入範本相符。例如，如果範本的第一欄是「會員編號」，則檔案的第一欄也應該是「會員編號」。欄位有遺漏或不一致可能導致整個資料錯誤。 2. **必填欄位遺漏：** 如果有必填欄位未在匯入檔案中提供數據，系統會拒絕匯入。確保所有必填欄位都有正確的數據。 3. **欄位格式錯誤：** 如果匯入的資料包含日期等欄位，確保其對應格式正確。系統可能會拒絕格式不正確的資料。

### 常見拒絕項目 #### **The xxxxxx field is required.** 表示該欄位為必填項目，但在匯入的欄位或檔案中沒有包含此欄位的資訊。為了成功匯入，您需要確保檔案中包含了所有必填的欄位，以符合資料的要求。 #### **The xxxxxxx is duplicated.** 表示有唯一值對應欄位重複。若要成功匯入，請再檢查比對條件中是否設定對應欄位，例如，如果匯入檔案中有「身分證字號」欄位，請確認比對條件是否也設定了「身分證字號」欄位，以確保系統可以辨識並處理重複的身份證字號資訊。 #### **The xxxxxx is not a valid date.** 表示輸入的欄位資料不符合日期格式的要求，合法的日期格式應該像是 1987-11-22 或 1967-10-05。請確保日期欄位的數據符合正確的日期格式，系統雖然針對多數常見的格式進行處理，例如 1998/10/02 等形式，但仍建議使用以 YYYY-MM-DD 格式，使系統能夠正確處理這些資訊。