CSV 檔案

GAX 使用逗點分隔值 (CSV) 檔案來向專員進行大量更新匯入\匯出。此區段說明 CSV 檔案的格式並提供一些範例。

檔案格式

來源檔案是逗點分隔 (CSV) 格式的文字檔案。

在來源檔案中，每行代表單一使用者或專員。相同的使用者或專員只能在來源檔案中出現一次。來源檔案中使用者的唯一識別碼是使用者名稱欄位。

檔案的欄是使用者或專員的屬性。檔案的第一行是識別欄位的欄名稱。欄的順序不重要。每個欄標題或值後面都有插入一個逗號，或者如果欄中沒有值，直接插入上一個逗號後面。所有非強制欄都可以根據使用者偏好和/或檔案目的，從來源檔案中省略。

來源檔案包含每個使用者/專員的以下屬性：

[+] 顯示屬性

CSV 匯入檔案的結構

名稱	類型	強制性？	說明
動作	新增，更新	是	指定要對該專員資料進行的動作，即建立新專員 (新增) 或修改現有專員 (更新)。
名字	字串	是	使用者/專員的名字
姓氏	字串	是	使用者/專員的姓氏。
員工 ID	字串	是	使用者/專員的員工識別碼
使用者名稱	字串	是	使用者/專員的使用者名稱
密碼	字串	否	與使用者名稱一同使用的密碼
密碼變更	布林值 (Y 或 N)	否	使用者/專員是否需要在他或她下次登入時更新他或她的密碼？
是專員	布林值	是	確定記錄是否代表使用者或專員；腳本功能在他們之間有所不同。
外部 ID	字串	否	外部識別碼
電子郵件地址	字串	否	使用者/專員的電子郵件地址；通常與使用者名稱相同。
分機	數字字串	否	專員的預設分機。如果有分機，則觸發預設位置建立。
已啟用	布林值	否	使用者的狀態 —Y=已啟用，N=已停用
資料夾	字串	是	資料夾和要建立使用者/專員的根資料夾 (人員) 路徑；例如，公司/部門/團隊

相關欄

除了屬性和資料夾外，每行都可能包含使用者/專員與其他設定物件的關係，尤其是交換器、專員群組、技能和存取群組。每個交換器、專員群組、存取群組或技能物件實例在來源檔案中都將有一個別欄。例如，如果有 10 位專員群組、1 個交換器、15 個技能和 4 個存取群組，那麼來源檔案中就會有 30 個額外欄，每個欄代表每個設定物件。所有相關欄都是可選的。

相關欄的每個標題都包含物件類型和物件名稱，並組成唯一的欄名稱。所以，例如，不能有兩個名字相同的技能，但是一個技能物件和某個交換器物件的名字可以相同。

相關欄的命名和值規則如下表：

相關欄

類型	列名	有效值
交換器	交換器：<switch name>	Y - 為此交換器上的此專員建立專員登入 N - 為此交換器上的此專員移除專員登入 <empty> - 沒有動作
專員群組	專員組：<agent group name>	Y - 新增此專員到此專員群組 N - 從此專員群組中移除此專員 <empty> - 沒有動作
存取群組	存取組：<access group name>	Y - 新增該使用者/專員到該存取群組 N - 從該存取群組中移除該使用者/專員 <empty> - 沒有動作 重要 系統偏好設定中指定的預設存取群組在使用大量上傳時不適用，因為專員的存取群組在 CSV 檔案中指定。
技能	技能：<skill name>	<number> - 指派此技能給有此技能等級的此專員 N - 從此專員中移除此技能 <empty> - 沒有動作

在上傳檔案時，GAX 會在每個記錄一開始就自動新增新欄以及動作的欄標題。對於每個記錄，它都將指派以下值之一：

• 新增 - 專員已新增。
• 更新 - 現有專員根據檔案中的已修改屬性或關係修改。

範例

以下資料要上傳至 GAX 以建立三位專員：

[+] 顯示資料

名字	姓氏	員工 ID	使用者名稱	是專員	外部 ID	分機	技能：英語	交換器：舊金山	交換器：倫敦	專員組：好	存取組：超級	動作	資料夾
Sarah	Lee	223344	sarahl@acme.com	N							是	新增	Acme/分支/團隊 1
John	Doyle	223465	johnd@acme.com	是		2233	1	是	N	是		新增	Acme/分支/團隊 2
Robert	Cook	244456	bobc@acme.com	是		2356	5	是		是		新增	Acme/分支/團隊 3

此資料的 CSV 檔案的內容看起來像這樣：

Sarah,Lee,223344,sarahl@acme.com,N,,,,,,,Y,ADD,Acme/Branch/Team 1
John,Doyle,223465,johnd@acme.com,Y,,2233,1,Y,N,Y,,ADD,Acme/Branch/Team 2
Robert,Cook,244456,bobc@acme.com,Y,,2356,5,Y,,Y,,ADD,Acme/Branch/Team 3