File CSV
GAX utilizza file con valori separati da virgola (CSV) per l’importazione/esportazione degli aggiornamenti in blocco degli Agenti. Questa sezione descrive il formato del file CSV e fornisce alcuni esempi.
Formato file
Il file sorgente è un file di testo in formato CSV, con valori separati da virgola.
Ciascuna riga del file sorgente indica un singolo utente o agente. Un utente o un agente può essere presente solo una volta nel file sorgente. L'identificatore univoco dell'utente nel file sorgente è il campo Nome utente.
Le colonne del file indicano le proprietà di un utente o di un agente. La prima riga del file contiene i nomi delle colonne per identificare i campi. L'ordine delle colonne non è importante. Alla fine di ogni intestazione o valore delle colonne è presente una virgola, oppure, se nella colonna non è inserito un valore, la virgola è inserita subito dopo la virgola precedente. In base alle preferenze dell’utente e/o all’utilizzo del file sorgente, è possibile ignorare le colonne non obbligatorie.
Il file sorgente contiene le seguenti proprietà per ciascun utente/agente:
[+] Mostra proprietà
| Nome
|
Tipo
|
Obbligatorio?
|
Descrizione
|
Struttura del file di importazione CSV
| Azione
|
AGGIUNGI, AGGIORNA
|
Sì
|
Specifica l’azione da effettuare con determinati dati dell’agente: creare un nuovo agente (AGGIUNGI) o modificare l’agente esistente (AGGIORNA).
|
| Nome
|
Stringa
|
Sì
|
Il nome dell’utente/agente
|
| Cognome
|
Stringa
|
Sì
|
Il cognome dell’utente/agente
|
| ID dipendente
|
Stringa
|
Sì
|
L’identificatore dipendente dell’utente/agente
|
| Nome utente
|
Stringa
|
Sì
|
Il nome utente dell’utente/agente
|
| Password
|
Stringa
|
No
|
La password da utilizzare con il nome utente
|
| Modifica della password
|
Booleano (S o N)
|
No
|
L’utente/agente deve aggiornare la propria password durante il successivo accesso?
|
| È agente
|
Booleano
|
Sì
|
Indica se il record rappresenta un utente o un agente, la funzionalità di script è diversa.
|
| ID esterno
|
Stringa
|
No
|
Un identificatore esterno
|
| Indirizzo e-mail
|
Stringa
|
No
|
Indirizzo e-mail dell’utente/agente; in genere corrisponde al nome utente.
|
| Estensione
|
stringa numerica
|
No
|
L’estensione predefinita dell’agente. Se è presente un'estensione, la creazione della posizione predefinita viene attivata.
|
| Attivato
|
Booleano
|
No
|
Lo stato dell’utente —S=abilitato, N=disabilitato
|
| Cartella
|
Stringa
|
Sì
|
Cartella e percorso della cartella principale (Persone) dove verrà creato l’utente/agente; ad esempio, Società/Reparto/Team
|
Colonne relazionali
Oltre alla proprietà e cartelle, ciascuna riga può contenere le relazioni tra l’utente/agente con altri oggetti di configurazione, in particolare Commutatori, Gruppi di agenti, Competenze e gruppi di accesso. Tutte le istanze di un oggetto Commutatore, Gruppo di agenti, Gruppo di accesso o Competenza saranno inserite in una colonna separata del file sorgente. Ad esempio, se sono presenti 10 gruppi di agenti, 1 commutatore, 15 competenze e 4 gruppi di accesso, nel file sorgente saranno presenti 30 colonne aggiuntive, una per ciascun oggetto di configurazione. Tutte le colonne relazionali sono facoltative.
Ogni intestazione di una colonna relazionale include il tipo e il nome dell'oggetto, che formano un unico nome di colonna. Ad esempio, non possono essere presenti due competenze con lo stesso nome, ma un oggetto competenza può avere lo stesso nome di un oggetto commutatore.
Le convenzioni relative a nomi e valori delle colonne relazionali sono indicate nella seguente tabella:
| Tipo
|
Nome colonna
|
Valori validi
|
Colonne relazionali
| Commutatore
|
Commutatore:<switch name>
|
S – Consente di creare un accesso agente per un dato agente sul commutatore
N – Consente di rimuovere l’accesso agente per un dato agente sul commutatore
<empty> – Nessuna azione
|
| Gruppo agenti
|
AgentG:<agent group name>
|
S – Consente di aggiungere un dato agente al gruppo di agenti
N – Consente di rimuovere un dato agente dal gruppo di agenti
<empty> – Nessuna azione
|
| Gruppo di accesso
|
AccessG:<access group name>
|
S – Consente di aggiungere l’agente/utente al gruppo di accesso
N – Consente di rimuovere l’agente/utente dal gruppo di accesso
<empty> – Nessuna azione
Importante Il Gruppo di accesso predefinito specificato nelle preferenze di sistema non viene applicato quando si effettuano caricamenti in blocco, poiché il gruppo di accesso dell’agente è indicato nel file CSV. |
| Competenza
|
Competenza:<skill name>
|
<number> – Consente di assegnare la competenza a un dato agente con il livello di competenza specificato
N – Consente di rimuovere la competenza dall’agente
<empty> – Nessuna azione
|
Quando si carica il file, GAX aggiunge automaticamente una nuova colonna all’inizio di ogni record, con un’intestazione di colonna Azione. Per ciascun record, assegna uno dei seguenti valori:
- AGGIUNGI - L'agente viene aggiunto.
- AGGIORNA - L'agente esistente viene modificato in base alle proprietà modificate o alle relazioni nel file.
Esempio
I seguenti dati devono essere caricati su GAX per creare tre agenti:
[+] Mostra dati
| Nome
|
Cognome
|
ID dipendente
|
Nome utente
|
È agente
|
ID esterno
|
Estensione
|
Competenza: inglese
|
Commutatore: San Fran
|
Commutatore: Londra
|
AgentG:Good
|
AccessG: Super
|
Azione
|
Cartella
|
| Sarah
|
Lee
|
223344
|
sarahl@acme.com
|
N
|
|
|
|
|
|
|
S
|
AGGIUNGI
|
Acme/Filiale/Team 1
|
| John
|
Doyle
|
223465
|
johnd@acme.com
|
S
|
|
2233
|
1
|
S
|
N
|
S
|
|
AGGIUNGI
|
Acme/Filiale/Team 2
|
| Robert
|
Cook
|
244456
|
bobc@acme.com
|
S
|
|
2356
|
5
|
S
|
|
S
|
|
AGGIUNGI
|
Acme/Filiale/Team 3
|
Il contenuto del file CSV per questi dati si presenta come segue:
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
