CSV 文件

GAX 使用 commma-separated value (CSV) 文件来向“座席”进行批量更新导入\导出。该节描述了 CSV 文件的格式并提供一些示例。

文件格式

源文件是 comma-separated (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> - 没有操作 Important “系统首选项”中指定的“默认访问组”在使用批量上传时不适用，因为“座席”的“访问组”在 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