Plik CSV

Aplikacja GAX używa plików z wartościami rozdzielonymi przecinkami (CSV) do importowania/eksportowania aktualizacji masowych dla agentów. Ta sekcja przedstawia format pliku CSV i kilka przykładów.

Format pliku

Plik źródłowy to plik tekstowy w formacie wartości rozdzielonych przecinkami (CSV).

Każdy wiersz pliku źródłowego reprezentuje pojedynczego użytkownika lub agenta. Ten sam użytkownik lub agent może pojawiać się w pliku źródłowym tylko jeden raz. Unikatowy identyfikator użytkownika w zakresie pliku źródłowego to pole Nazwa użytkownika.

Kolumny pliku stanowią właściwości użytkownika lub agenta. Pierwszy wiersz pliku zawiera nazwy kolumn, które identyfikują pola. Kolejność kolumn nie jest ważna. Przecinek jest wstawiany po każdym nagłówku kolumny lub po każdej wartości. Jeśli kolumna nie ma wartości, przecinek jest wstawiany bezpośrednio po poprzednim przecinku. Niewymaganą kolumnę można pominąć w pliku źródłowym w zależności od preferencji użytkownika i/lub przeznaczenia pliku.

Plik źródłowy zawiera następujące właściwości dla każdego użytkownika/agenta:

[+] Pokaż właściwości

Struktura importowanego pliku CSV

Nazwa	Typ	Obowiązkowe?	Opis
Działanie	ADD, UPDATE	Tak	Określa działanie do wykonania dla tych danych agenta — może to być utworzenie nowego agenta (ADD) lub zmodyfikowanie istniejącego agenta (UPDATE).
Imię	Ciąg	Tak	Imię użytkownika/agenta
Nazwisko	Ciąg	Tak	Nazwisko użytkownika/agenta
Identyfikator pracownika	Ciąg	Tak	Identyfikator pracownika dotyczący użytkownika/agenta
Nazwa użytkownika	Ciąg	Tak	Nazwa użytkownika dotycząca użytkownika/agenta
Hasło	Ciąg	Nie	Hasło używane z nazwą użytkownika
Zmiana hasła	Wartość logiczna (T lub N)	Nie	Czy użytkownik/agent musi zaktualizować swoje hasło przy następnym logowaniu?
Jest agentem	Wartość logiczna	Tak	Określa, czy rekord reprezentuje użytkownika lub agenta. Działanie skryptu różni się w zależności od tej wartości.
Identyfikator zewnętrzny	Ciąg	Nie	Identyfikator zewnętrzny
Adres e-mail	Ciąg	Nie	Adres e-mail użytkownika/agenta, zwykle taki sam jak nazwa użytkownika.
Rozszerzenie	ciąg liczbowy	Nie	Domyślne rozszerzenie agenta. Jeśli rozszerzenie jest obecne, zostaje wyzwolone tworzenie miejsca domyślnego.
Włączone	Wartość logiczna	Nie	Stan użytkownika — T=włączony, N=wyłączony
Folder	Ciąg	Tak	Folder i ścieżka do folderu głównego (Osoby), w którym zostanie utworzony użytkownik/agent. Na przykład Firma/Dział/Zespół

Kolumny relacji

Oprócz właściwości i folderów każdy wiersz może zawierać relacje użytkownika/agenta z innymi obiektami konfiguracji, takimi jak Przełączniki, Grupy agentów, Kwalifikacje i Grupy dostępu. Każde wystąpienie obiektu Przełącznik, Grupa agentów, Grupa dostępu lub Kwalifikacja będzie miało oddzielną kolumnę w pliku źródłowym. Jeśli na przykład istnieje 10 grup agentów, 1 przełącznik, 15 kwalifikacji i 4 grupy dostępu, w pliku źródłowym znajdzie się 30 dodatkowych kolumn, z których każda reprezentuje poszczególny obiekt konfiguracji. Wszystkie kolumny relacji są opcjonalne.

Każdy nagłówek kolumny relacji składa się z typu obiektu i nazwy obiektu, które tworzą unikatową nazwę kolumny. Oznacza to, że na przykład nie mogą istnieć dwie kwalifikacje o tej samej nazwie, ale obiekt Kwalifikacja może mieć taką samą nazwę jak jakiś obiekt Przełącznik.

Reguły nazw i wartości kolumn relacji przedstawiono w poniższej tabeli:

Kolumny relacji

Typ	Nazwa kolumny	Prawidłowe wartości
Przełącznik	Switch:<switch name>	T — tworzenie loginu agenta dla tego agenta na tym przełączniku N — usunięcie loginu agenta dla tego agenta z tego przełącznika <empty> — brak działania
Grupa agenta	AgentG:<agent group name>	T — dodanie tego agenta do tej grupy agentów N — usunięcie tego agenta z tej grupy agentów <empty> — brak działania
Grupa dostępu	AccessG:<access group name>	T — dodanie tego użytkownika/agenta do tej grupy dostępu N — usunięcie tego użytkownika/agenta z tej grupy dostępu <empty> — brak działania Ważne Domyślna grupa dostępu, która jest określona w oknie Preferencje systemu, nie ma zastosowania do masowych operacji przekazywania, ponieważ grupa dostępu dla agenta jest określana w pliku CSV.
Kwalifikacja	Skill:<skill name>	<number> — przypisanie tej kwalifikacji do agenta z tym poziomem kwalifikacji N — usunięcie kwalifikacji z tego agenta <empty> — brak działania

Podczas przekazywania pliku aplikacja GAX automatycznie dodaje nową kolumnę jako pierwszą kolumnę każdego rekordu i ustawia dla niej nagłówek akcji. Dla każdego rekordu zostaje przypisana jedna z następujących wartości:

• ADD — agent zostaje dodany.
• UPDATE — istniejący agent zostaje zmodyfikowany zgodnie ze zmodyfikowanymi właściwościami lub relacjami w pliku.

Przykład

Poniższe dane należy przekazać do aplikacji GAX w celu utworzenia trzech agentów:

[+] Pokaż dane

Imię	Nazwisko	Identyfikator pracownika	Nazwa użytkownika	Jest agentem	Identyfikator zewnętrzny	Rozszerzenie	Skill:Angielski	Switch: San Fran	Switch: Londyn	AgentG:Dobry	AccessG: Super	Działanie	Folder
Sarah	Lee	223344	sarahl@acme.com	N							T	ADD	Acme/Oddział/Zespół 1
Jan	Kowalski	223465	jank@acme.com	T		2233	1	T	N	T		ADD	Acme/Oddział/Zespół 2
Robert	Kucharski	244456	robertk@acme.com	T		2356	5	T		T		ADD	Acme/Oddział/Zespół 3

Zawartość pliku CSV z takimi danymi wygląda następująco:

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