Archivo CSV

GAX utiliza archivos separados por coma (CSV) para importar/exportar las actualizaciones masivas de agentes. En esta sección, se describe el formato del archivo CSV y brinda alguno ejemplos.

Formato de archivo

El archivo fuente es de texto con formato separado por coma (CSV).

En el archivo fuente cada línea representa un solo usuario o agente. El mismo usuario o agente puede aparecer en el archivo fuente solo una vez. Este identificador único del usuario en el ámbito del archivo fuente es el campo Nombre de usuario.

Las columnas del archivo son las propiedades de un usuario o agente. El primer renglón del archivo tiene los nombres de las columnas para identificar los campos. El orden de las columnas no es importante. Se inserta una coma después de cada encabezado de columna o valor; si la columna no tiene un valor, inmediatamente después de la coma anterior. Las columnas que no son obligatorias se pueden omitir en el archivo fuente, esto depende de las preferencias del usuario o el propósito del archivo.

El archivo fuente contiene las siguientes propiedades para cada usuario/agente:

[+] Mostrar propiedades

Estructura del archivo CSV importado

Nombre	Tipo	¿Obligatorio?	Descripción
Acción	AGREGAR, ACTUALIZAR	Sí	Especifica la acción a tomar con estos datos de agente, ya sea crear un agente nuevo (AGREGAR) o modificar uno existente (ACTUALIZAR).
Nombre	Cadena	Sí	El nombre del Usuario/Agente
Apellido	Cadena	Sí	El apellido del Usuario/Agente
Id de empleado	Cadena	Sí	El identificador de empleado del Usuario/Agente
Nombre de usuario	Cadena	Sí	El nombre de usuario del usuario/agente
Contraseña	Cadena	No	La contraseña que se usará con ese nombre de usuario
Cambio de contraseña	Booleana (S o N)	No	¿El Usuario/Agente necesita actualizar su contraseña la siguiente vez que inicie sesión?
Es agente	Booleana	Sí	Determina si el registro representa un usuario o un agente, la funcionalidad de los scripts difiere entre ellos.
Id externo	Cadena	No	Un identificador externo
Dirección correo electrónico	Cadena	No	El e-mail del usuario o agente; por lo general, es el mismo que el nombre del usuario.
Extensión	cadena numérica	No	La extensión predeterminada del agente. Si hay una extensión presente, se activa la creación predeterminada del puesto.
Habilitado	Booleana	No	El estado del usuario—S=habilitado, N=deshabilitado
Carpeta	Cadena	Sí	Carpeta y ruta a la carpeta raíz (Personas) en donde se creará el Usuario/Agente; por ejemplo, Empresa/Departamento/Equipo

Columnas relacionales

Además de las propiedades y carpetas, cad renglón puede contener relaciones entre el Usuario/Agente con otros objetos de configuración, particularmente centrales telefónicas, grupos de agentes, habilidades y grupos de acceso. Cada instancia de objeto de una central telefónica, Grupo de Agentes, grupos de acceso o habilidades tendrá una columna separada en el archivo fuente. Por ejemplo, si hay 10 grupos de agentes, 1 central telefónica, 15 habilidades y 4 grupos de acceso, habrá 30 columnas adicionales en el archivo fuente, cada una representando un objeto de configuración. Todas las columnas relacionales son opcionales.

Cada encabezado de una columna relacional consta del nombre y tipo de objeto, lo que forman un nombre único de columna. Así es que no puede haber, por ejemplo, dos habilidades con el mismo nombre, aunque el objeto de habilidad puede tener el mismo nombre que algún objeto de central telefónica.

Las reglas de nombres y valores de las columnas relacionales se describen en la tabla siguiente:

Columnas relacionales

Tipo	Nombre de columna	Valores válidos
Central telefónica	Central telefónica:<switch name>	S: Crea un login de agente para este agente en la central telefónica N: Quita el login de agente para este agente de su central telefónica <empty>: No se realiza ninguna acción
Grupo de Agentes	AgentG:<agent group name>	S: Agrega este agente a este grupo de agentes N: Quita este agente de este grupo de agentes <empty>: No se realiza ninguna acción
Grupo de acceso	AccessG:<access group name>	S: Agrega este usuario o agente a este grupo de acceso N: Quita este usuario o agente de este grupo de acceso <empty>: No se realiza ninguna acción Importante El grupo de acceso predeterminado especificado en las preferencias del sistema no aplica cuando se usan cargas masivas, ya que el grupo de acceso del agente se especifica en el archivo CSV.
Habilidad	Habilidad:<skill name>	<number>: Asigna esta habilidad a este agente con este nivel de habilidad N: Quita esta habilidad de este agente <empty>: No se realiza ninguna acción

Al cargar el archivo, GAX agrega una columna automáticamente al principio de cada registro y con un encabezado de la columna de Acción. Para cada registro asigna alguno de los siguientes valores:

• AGREGAR - Se agrega el agente
• ACTUALIZAR - Se modifica el agente existente de acuerdo con las propiedades o relaciones modificadas en el archivo.

Ejemplo

Para crear tres agentes, los siguientes datos se cargarán en GAX :

[+] Mostrar datos

Nombre	Apellido	Id de empleado	Nombre de usuario	Es agente	Id externo	Extensión	Habilidad:inglés	Central telefónica: San Francisco	Central telefónica: Londres	AgentG:Bueno	AccessG: Súper	Acción	Carpeta
Sarah	Lee	223344	sarahl@acme.com	N							S	AGREGAR	Acme/Branch/Equipo 1
John	Doyle	223465	johnd@acme.com	S		2233	1	S	N	S		AGREGAR	Acme/Branch/Equipo 2
Robert	Cook	244456	bobc@acme.com	S		2356	5	S		S		AGREGAR	Acme/Branch/Equipo 3

El contenido del archivo CSV para esto datos se vería así:

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