建立一個有效的受訪者檔案，包含必要欄位及選填欄位，並遵守字元長度及格式規則。
本文章節
檔案欄位
以下為受訪者檔案的所有選填及必填欄位，檔案必須為 Excel 的（逗號分隔）CSV 格式：
| 欄位標題（不區分大小寫） | 是否必填 | 驗證規則 | 重要說明 |
|---|---|---|---|
| External_ID External ID ExternalID |
是 | 最大長度 = 100 |
此欄位用以判斷您上傳的資料是新受訪者還是更新現有受訪者。External_ID 應為能長期唯一識別用戶的值（例如：員工編號）。 系統會自動移除 External_ID 的所有前置零。 |
| First_Name First Name FirstName |
是 | 最大長度 = 50 | |
| Last_Name Last Name LastName |
是 | 最大長度 = 50 | |
| Email Email Address EmailAddress |
若以電郵發送或缺少調查代碼則必填 | 有效電郵格式，最大長度 = 100 | |
| Survey_Code Survey Code SurveyCode |
若以調查代碼發放或缺少電郵則必填 | 最大長度 = 50 | 每位受訪者必須唯一。 |
| Country Country Code Country_Code Country Region Country_Region Country Code Region |
是 | 任何包含 Country、Country Code，或與 Region 組合（以空格、底線或無分隔）之欄位標題皆有效。使用 Region 時，前方必須有 Country 或 Country Code。 | |
| Language_Code Language Code LanguageCode |
否 | 若此欄無資料或代碼無效，調查邀請及提醒預設為美式英語（U.S. English）。 | |
| Manager_External_ID Manager External ID ManagerExternalID |
否 | 此欄位必須與檔案中或客戶端已存在的 External_ID 相符。 | |
| Survey | 否 | 是 / 否 / True / False | 受訪者是否有資格參加調查。若留空，預設為「是」。 |
| <reporting group or variable name> | 否 | 最大長度 = 50 |
附加資訊
包含新受訪者的檔案
檔案必須包含所有必填欄位，且每個必填欄位都必須有值。若任何必填欄位留空，將導致上傳失敗。若檔案未包含 Language Code 欄，Gallup Access 將新個案的值設為 en-US，且保持現有個案的值不變。若檔案包含 Language Code 欄但該儲存格為空，Gallup Access 亦將值設為 en-US。
僅包含現有受訪者的檔案
檔案不需要包含必填欄位。若包含，每個欄位必須有值，否則上傳會失敗。Gallup Access 將根據相關業務規則，替換與個案現有值不同的欄位值。
選填欄位
對於現有個案，若儲存格為空，Gallup Access 將清除該個案目前的欄位值；若儲存格有新值，則替換之。
範例檔案
| external_ID | first_name | last_name | country_code | |
|---|---|---|---|---|
| AB123 | Sam | Pritchard | Sam.pritchard@testco.com | USA |
| AC455 | Melanie | Lund | Melanie.lund@testco.com | USA |
| FF909 | Tony | Brown | Tony.brown@testco.com | USA |
| GL873 | Chris | Marks | Chris.marks@testco.com | USA |
| XY900 | Stew | Wild | Stew.wild@testco.com | USA |
| TN331 | Lou | Davis | Lou.davis@testco.com | USA |