Import uživatelů

Pro vložení většího počtu uživatelů do systému existuje možnost importu pomocí  XLS(X) souboru. V tomto souboru je možné definovat všechny hlavní i vedlejší parametry uživatele a specifikovat do jakých skupin má být uživatel iniciálně zařazen. Jediné omezení tohoto importu je možnost pouze jednoho subtypu uživatelů v jednom importovacím souboru. Subtyp uživatele totiž definuje jeho vedlejší parametry. Uživatelé více subtypů v jednom souboru by tedy jednak vyžadovali složitější logiku zpracovávání a jednak by vedli k menší přehlednosti a kompaktnosti vstupního souboru.

Struktura importovacího souboru:

• Soubor je typu XLS případně XLSX
• první řádek souboru je jeho hlavička, která definuje jaká data se budou nacházet v jakém sloupci
• každý sloupec hlavičky definuje jeden parametr uživatele
• parametr může být popsán libovoným textem popisujícím člověku jaká data se ve sloupci nachází - za tímto popisem musí ovšem následovat závorka a v ní uveden systémový název parametru. Například (firstName). Počítá se vždy poslední závorka, proto i lidský popis může závorky obsahovat.
• systémová jména hlavních parametrů jsou uvedena v ukázkovém importovacím souboru
• systémová jména vedlejších parametrů jednotlivých subtypů musí definovat správce systému, který vytváří daný subtyp a definuje jeho parametry
• import rozeznává téměř všechny hlavní parametry uživatele, vyjímku tvoří parametry SuperUser, Created a ID.
• jedniné dva parametry, které každý uživatel musí mít definované jsou subtyp a email
• parametry uživatele mohou být uvedeny v hlavičce v naprosto libovolném pořadí, jediným omezením je, že parametr Subtyp musí být uveden dříve než první vedlejší parametr uživatele.
• všchni uživatelé importovaní v jednom souboru musí být stejného subtypu
• uživatelské skupiny, do kterých je uživatel přiřazen, jsou odděleny čárkami a jejich počet není omezen. Jejich názvy můsí přesně odpovídat názvům skupin již existujících v systému.
• v ukázkovém importovacím souboru jsou modře vyznačeny povinné parametry, zeleně ostatní hlavní parametry a žlutě ukázkové vedlejší parametry

Pro import uživatele tedy:

• v seznamu uživatelů klikneme na tlačítko XLS Import
• otevře se nám modální okno kam máme nahrát importovací soubor - pokud nemáme žádný předešlý importovací soubor pro referenci, můžeme si stáhnout ukázkový soubor kliknutím na link "Zde si můžete stáhnout..." ve spodní části modálu
• klikneme na tlačítko Vybrat soubor a vybereme z počítače Excelový soubor pro import
• klikneme na tlačítko Importovat
• systém nahraje a projde importovací soubor - pokud není hlavička souboru v pořádku nahlásí uživateli chybu. V opačném případě začne importovat uživatele a ohlásí celkový výsledek v modálovém okně
• uživatelé, kteří byli v pořádku naimportováni jsou zobrazeni zeleně se všemi údaji tak jak je systém přečetl z importovacího souboru
• uživatelé, které se nepodařilo naimportovat jsou zobrazeni červeně společně s údaji, které systém dokázal přečíst než došel k chybě a následuje chyba, která znemožnila import uživatele
• v horní části modálu je ukázano kolik celkově bylo (ne)uspěšně importováno uživatelů
• jakmile je import dokončen, seznam uživatelů je aktualizován