Arquivo CSV
O GAX usa arquivos de valores separados por vírgula (CSV) para importar/exportar atualizações em massa de Agentes. Esta seção descreve o formato do arquivo CSV e fornece alguns exemplos.
Formato de Arquivo
O arquivo de origem é um arquivo de texto em formato separado por vírgula (CSV).
No arquivo de origem, cada linha representa um único usuário ou agente. Um mesmo usuário ou agente pode ser exibido no arquivo de origem somente uma vez. O identificador exclusivo do usuário no escopo do arquivo de origem é o campo Nome de Usuário.
As colunas do arquivo são as propriedades de um usuário ou agente. A primeira linha no arquivo tem nomes de colunas para identificar os campos. A ordem das colunas não é importante. Uma vírgula é inserida após cada cabeçalho de coluna ou valor ou, se a coluna não tiver um valor, imediatamente após a vírgula anterior. Qualquer coluna não obrigatória pode ser omitida do arquivo de origem, dependendo das preferências do usuário e/ou do propósito do arquivo
O arquivo de origem contém as seguintes propriedades de cada usuário/agente:
[+] Mostrar propriedades
| Nome
|
Tipo
|
Obrigatório?
|
Descrição
|
Estrutura do Arquivo de Importação CSV
| Ação
|
ADICIONAR, ATUALIZAR
|
Sim
|
Especifica a ação a ser tomada com estes dados de agente, ou seja, criar um novo agente (ADICIONAR) ou modificar um agente existente (ATUALIZAR).
|
| Primeiro Nome
|
Cadeia de caracteres
|
Sim
|
O primeiro nome do Usuário/Agente
|
| Sobrenome
|
Cadeia de caracteres
|
Sim
|
O sobrenome do Usuário/Agente
|
| ID de Funcionário
|
Cadeia de caracteres
|
Sim
|
O identificador de funcionário do Usuário/Agente
|
| Nome de Usuário
|
Cadeia de caracteres
|
Sim
|
O nome de usuário do Usuário/Agente
|
| Senha
|
Cadeia de caracteres
|
Não
|
A senha a ser usada com Nome de Usuário
|
| Alteração de senha
|
Booleano (S ou N)
|
Não
|
O Usuário/Agente precisa atualizar a sua senha quando fizer login novamente?
|
| É Agente
|
Booleano
|
Sim
|
Determina se o registro representa um usuário ou um agente; a funcionalidade de script é diferente entre eles.
|
| ID Externo
|
Cadeia de caracteres
|
Não
|
Um identificador externo
|
| Endereço de e-mail
|
Cadeia de caracteres
|
Não
|
Endereço de e-mail do Usuário/Agente; normalmente, é semelhante ao Nome de Usuário.
|
| Extensão
|
cadeia de caracteres numéricos
|
Não
|
A extensão padrão do Agente. Se uma extensão estiver presente, a criação de Lugar padrão é acionada.
|
| Habilitado
|
Booleano
|
Não
|
O estado do usuário—Y=habilitado, N=desabilitado
|
| Pasta
|
Cadeia de caracteres
|
Sim
|
Pasta e caminho até a pasta raiz (Pessoas) onde o Usuário/Agente será criado; por exemplo, Empresa/Departamento/Equipe
|
Colunas Relacionadas
Além de propriedades e pastas, cada linha pode conter relações entre o Usuário/Agente e outros objetos de configuração, em especial Switches, Grupos de Agentes, Habilidades e Grupos de Acesso. Cada instância de um objeto de Switch, Grupo de Agentes, Grupo de Acesso ou Habilidade terá uma coluna independente no arquivo de origem. Por exemplo, se houver 10 Grupos de Agentes, 1 Switch, 15 Habilidades e 4 Grupos de Acesso, haverá 30 colunas adicionais no arquivo de origem, cada uma representando um objeto de configuração. Todas as colunas relacionadas são opcionais.
Cada cabeçalho das colunas relacionadas consiste do tipo de objeto e do nome do objeto, o que forma um nome de coluna único. Dessa forma, por exemplo, não pode haver duas Habilidades com o mesmo nome, mas um objeto de Habilidade pode ter o mesmo nome de algum objeto de Switch.
As regras de nomenclatura e valor das colunas relacionadas são fornecidas na seguinte tabela:
| Tipo
|
Nome da Coluna
|
Valores Válidos
|
Colunas Relacionadas
| Switch
|
Switch:<switch name>
|
S – Criar um Login de Agente para este Agente neste Switch
N – Remover o Login de Agente deste Agente neste Switch
<empty> - Nenhuma ação
|
| Grupo de Agentes
|
AgentG:<agent group name>
|
S – Adicionar este Agente a este Grupo de Agentes
N – Remover este Agente deste Grupo de Agentes
<empty> - Nenhuma ação
|
| Grupo de Acesso
|
AccessG:<access group name>
|
S – Adicionar este Usuário/Agente a este Grupo de Acesso
N – Remover este Usuário/Agente deste Grupo de Acesso
<empty> - Nenhuma ação
Importante O Grupo de Acesso Padrão especificado nas Preferências do Sistema não se aplica ao usar carregamentos em massa, já que o Grupo de Acesso do Agente está especificado no arquivo CSV. |
| Habilidade
|
Habilidade:<skill name>
|
<number> - Atribuir esta Habilidade a este Agente com este Nível de Habilidade
N – Remover esta Habilidade deste Agente
<empty> - Nenhuma ação
|
Ao carregar o arquivo, o GAX adicionará automaticamente uma nova coluna no início de cada registro com um cabeçalho de coluna de Ação. Para cada registro, ele atribui um dos seguintes valores:
- ADICIONAR - O Agente é adicionado.
- ATUALIZAR - O Agente existente é modificado de acordo com as propriedades modificadas ou relacionadas no arquivo.
Exemplo
Os seguintes dados precisam ser carregados no GAX para criar três Agentes:
[+] Exibir dados
| Primeiro Nome
|
Sobrenome
|
ID de Funcionário
|
Nome de Usuário
|
É Agente
|
ID Externo
|
Extensão
|
Skill:English
|
Switch: San Fran
|
Switch: Londres
|
AgentG:Good
|
AccessG: Super
|
Ação
|
Pasta
|
| Sarah
|
Lee
|
223344
|
sarahl@acme.com
|
N
|
|
|
|
|
|
|
S
|
ADICIONAR
|
Acme/Branch/Team 1
|
| John
|
Doyle
|
223465
|
johnd@acme.com
|
S
|
|
2233
|
1
|
S
|
N
|
S
|
|
ADICIONAR
|
Acme/Branch/Team 2
|
| Robert
|
Cook
|
244456
|
bobc@acme.com
|
S
|
|
2356
|
5
|
S
|
|
S
|
|
ADICIONAR
|
Acme/Branch/Team 3
|
O conteúdo do arquivo CSV para estes dados tem esta aparência:
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
