CSV 파일

GAX에서는 상담원에 대한 일괄 업데이트 가져오기 및 내보내기에 대해 CSV(쉼표로 구분된 값) 파일을 사용합니다. 이 섹션에서는 CSV 파일의 형식에 대해 설명하고 몇 가지 예를 제공합니다.

파일 형식

소스 파일은 CSV(쉼표로 구분된 값) 형식을 갖는 텍스트 파일입니다.

소스 파일에서 각 줄은 단일 사용자 또는 상담원을 나타냅니다. 소스 파일에 동일한 사용자나 상담원은 한 번만 나타날 수 있습니다. 소스 파일 범위에 있는 사용자의 고유 식별자는 사용자 이름 필드입니다.

파일의 열은 사용자 또는 상담원의 속성입니다. 파일의 첫 번째 행에는 필드를 식별하기 위한 열 이름이 포함되어 있습니다. 열 순서는 중요하지 않습니다. 각 열 머리글이나 값 다음에 또는 열에 값이 없으면 이전 쉼표 바로 다음에 쉼표가 삽입됩니다. 사용자 기본 설정 및/또는 파일 용도에 따라 소스 파일에서 비필수 열을 생략할 수 있습니다.

소스 파일에는 각 사용자/상담원에 대한 다음 속성이 포함됩니다.

[+] 속성 표시

CSV 가져오기 파일의 구조

이름	유형	필수 여부	설명
작업	ADD, UPDATE	예	이 상담원 데이터에 대해 수행할 작업, 즉 새 상담원 생성(ADD) 또는 기존 상담원 수정(UPDATE)을 지정합니다.
이름	문자열	예	사용자/상담원의 이름
성	문자열	예	사용자/상담원의 성
직원 ID	문자열	예	사용자/상담원의 직원 식별자
사용자 이름	문자열	예	사용자/상담원의 사용자 이름
암호	문자열	아니요	사용자 이름과 함께 사용할 암호
암호 변경	부울(Y 또는 N)	아니요	사용자/상담원이 다음 로그온 시 암호를 업데이트해야 합니까?
상담원인지 여부	부울	예	레코드가 사용자를 나타내는지 상담원을 나타내는지를 확인합니다. 스크립트 기능은 두 가지 경우에 따라 다릅니다.
외부 ID	문자열	아니요	외부 식별자
이메일 주소	문자열	아니요	사용자/상담원의 이메일 주소. 일반적으로 사용자 이름과 같습니다.
확장	숫자 문자열	아니요	상담원의 기본 확장. 확장이 있으면 기본 상담석 생성이 트리거됩니다.
활성	부울	아니요	사용자의 상태—Y=활성화, N=비활성화
폴더	문자열	예	사용자/상담원이 생성될 루트 폴더(Persons)의 폴더 및 경로(예: Company/Department/Team)

관계형 열

속성 및 폴더 외에, 각 행에는 사용자/상담원과 다른 구성 개체, 특히 스위치, 상담원 그룹, 스킬 및 액세스 그룹 간 관계가 포함될 수 있습니다. 스위치, 상담원 그룹, 액세스 그룹 또는 스킬 개체의 모든 인스턴스는 소스 파일에 별도 열이 있습니다. 예를 들어 상담원 그룹 10개, 스위치 1개, 스킬 15개, 액세스 그룹 4개가 있는 경우 각각이 각 구성 개체를 나타내는 30개의 추가 열이 소스 파일에 생성됩니다. 모든 관계형 열은 선택 사항입니다.

관계형 열의 각 머리글은 고유한 열 이름을 형성하는 개체 유형 및 개체 이름으로 구성됩니다. 따라서 가령 이름이 같은 스킬은 2개 있을 수 없으나 스킬 개체는 일부 스위치 개체와 같은 이름을 가질 수 있습니다.

관계형 열의 명명 및 값 규칙은 다음 표에 나와 있습니다.

관계형 열

유형	열 이름	유효 값
스위치	스위치:<switch name>	Y – 이 스위치에 이 상담원에 대한 상담원 로그인 생성 N – 이 스위치에서 이 상담원에 대한 상담원 로그인 제거 <empty> - 작업 없음
상담원 그룹	AgentG:<agent group name>	Y – 이 상담원 그룹에 이 상담원 추가 N – 이 상담원 그룹에서 이 상담원 제거 <empty> - 작업 없음
액세스 그룹	AccessG:<access group name>	Y – 이 액세스 그룹에 이 사용자/상담원 추가 N – 이 액세스 그룹에서 이 사용자/상담원 제거 <empty> - 작업 없음 중요 상담원에 대한 액세스 그룹이 CSV 파일에 지정되어 있으므로 일괄 업로드를 사용할 때는 시스템 기본 설정에 지정된 기본 액세스 그룹이 적용되지 않습니다.
스킬	스킬:<skill name>	<number> - 이 스킬 수준에서 이 상담원에 이 스킬 할당 N – 이 상담원에서 이 스킬 제거 <empty> - 작업 없음

파일을 업로드하면 GAX에서 모든 레코드의 첫번째 열에 작업의 열 머리글이 포함된 새 열을 자동으로 추가합니다. 각 레코드에 대해 다음 값 중 하나가 할당됩니다.

• ADD - 상담원이 추가됩니다.
• UPDATE - 파일의 수정된 속성 또는 관계에 따라 기존 상담원이 수정됩니다.

예

3명의 상담원을 생성하기 위해 다음 데이터가 GAX에 업로드되어야 합니다.

[+] 데이터 표시

이름	성	직원 ID	사용자 이름	상담원인지 여부	외부 ID	확장	Skill:English	스위치: San Fran	스위치: London	AgentG:Good	AccessG: Super	작업	폴더
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

이 데이터에 대한 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