Wiki source code of Import uživatelů

Last modified by Josef Vencl on 2021/05/04 08:36
Show last authors
1 {{html}}
2 <iframe src="https://player.vimeo.com/video/407940770" width="800" height="500" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>
3 {{/html}}
4
5 __**Import uživatelů**__
6
7 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.
8
9
10 __Struktura importovacího souboru:__
11
12 * Soubor je typu XLS případně XLSX
13 * první řádek souboru je jeho hlavička, která definuje jaká data se budou nacházet v jakém sloupci
14 * každý sloupec hlavičky definuje jeden parametr uživatele
15 * 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.
16 * systémová jména hlavních parametrů jsou uvedena v ukázkovém importovacím souboru
17 * systémová jména vedlejších parametrů jednotlivých subtypů musí definovat správce systému, který vytváří daný subtyp a definuje jeho parametry
18 * import rozeznává téměř všechny hlavní parametry uživatele, vyjímku tvoří parametry //SuperUser//, //Created //a //ID//.
19 * jedniné dva parametry, které každý uživatel musí mít definované jsou subtyp a email
20 * 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.
21 * všchni uživatelé importovaní v jednom souboru musí být stejného subtypu
22 * 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.
23 * v ukázkovém importovacím souboru jsou modře vyznačeny povinné parametry, zeleně ostatní hlavní parametry a žlutě ukázkové vedlejší parametry
24
25 Pro import uživatele tedy:
26
27 * v **seznamu uživatelů** klikneme na tlačítko **XLS Import**
28 * 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
29 * klikneme na tlačítko **Vybrat soubor** a vybereme z počítače Excelový soubor pro import
30 * klikneme na tlačítko **Importovat**
31 * 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ě
32 * 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
33 * 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
34 * v horní části modálu je ukázano kolik celkově bylo (ne)uspěšně importováno uživatelů
35 * jakmile je import dokončen, seznam uživatelů je aktualizován
36
37 (% class="box warningmessage" %)
38 (((
39 Video se může lišit od aktuální verze Competentu v drobných grafických detailech, princip však zůstává stejný.
40 )))