Import uživatelů z CSV
Pravidelný automatický import
Vytvořte na serveru naplánovanou úlohu s periodou opakování např. 1× denně, která spustí následující příkaz:
\AlvaoService\utilities\ImportUsersCsv.exe /csv <cesta k souboru CSV> /server <sql_server> /db <database_alvao> /add /remove
Jednorázový import
Pro jednorázový import portrétů na serveru spusťte vytvořenou naplánovanou úlohu jednou nebo zkopírujte aplikaci ImportUsersCsv ze serveru do počítače a spusťte ji z příkazového řádku. Aplikace je nainstalována společně se službou ALVAO ve složce "%ProgramFiles%\ALVAO\AlvaoService\utilities"
Nástroj ImportUsersCSV
Tato utilita importuje uživatele ze souboru CSV do systému Alvao. Můžete ji použít například k aktualizaci uživatelů v systému Alvao podle údajů v personálním systému apod.
Syntaxe příkazových řádků
ImportUsersCSV /csv "cesta a název souboru CSV" {/con "připojovací řetězec" | /server "název databázového serveru" /db "název databáze"}[/key "klíčový sloupec"][/cols "seznam sloupců"][/utcdate][/nohdrs][/add][/remove][/help]
Podrobný popis parametrů
| Parametr |
Popis |
| /csv |
Cesta a název souboru CSV, ze kterého se má provést import. |
/con
/server
/db |
Tyto parametry slouží k nastavení připojení k databázi Alvao. Je možné použít řetězec připojení (např. /con "Zdroj dat=.\sqlexpress;Počáteční katalog=test;Integrované zabezpečení = True;TrustServerCertificate=True") nebo jednoduše zadat konkrétní SQL server a DB (např. /server ".\sqlexpress" /db "test").
V případě, že použijete parametry /server a /db, připojení k databázi se provede pomocí integrovaného ověřování systému Windows. Pokud zadáte všechny tyto parametry, použije se pouze parametr /con, /server a /dbbudou ignorovány. |
| /key |
Sloupec key slouží k vyhledání existujícího uživatele v administraci. Pokud není zadán žádný parametr, sloupec klíče je Login (musí existovat v CSV). |
| /cols |
Umožňuje určit význam a pořadí sloupců v CSV (CSV neobsahuje hlavičky). Pokud je v seznamu zadána 0 (nula), příslušný sloupec z CSV nebude importován (bude ignorován).
Poznámka: Seznam na příkazovém řádku nemusí obsahovat stejný počet sloupců jako CSV (neuvedené sloupce budou přeskočeny - ignorovány) |
| /utcdate |
Sloupce s datem jsou v čase UTC. Není-li přepínač zadán, budou časové údaje v CSV považovány za aktuální časové pásmo počítače (místní čas). |
| /nohdrs |
Importovaný CSV neobsahuje záhlaví (první řádek) s popisem sloupců. |
| /add |
Vytvoření nových uživatelů v systému Alvao
Poznámka: Pokud není tento přepínač zadán, import nevytvoří nové uživatele, ale pouze aktualizuje stávající. |
| /remove |
Odstraní z Alvao uživatele, které nenajde v souboru CSV. |
Popis všech podporovaných sloupců
Název sloupce v CSV
(v příkazovém řádku - /cols) |
Důležitost |
Související sloupec v tPerson |
Poznámka |
| ID |
Jedinečné identifikační číslo osoby v CSV (např. ID ze systému, ze kterého je CSV exportován). |
- |
Pokud CSV obsahuje ManagerID nebo DelegateID, import tento sloupec vyžaduje, jinak skončí s chybou. |
| FullName |
Jméno a příjmení osoby |
withPerson |
Nesmí být vyplněn - v tomto případě bude hodnota složena jako[FirstName LastName] (pokud je vyplněno). |
| Login |
UserName |
withPersonLogin (pokud je hodnota ve tvaru domain a jedná se o uživatele AD, pak SamAccountName) |
Uživatelské jméno lze zadat v následujících tvarech
- login@domena (UPN)
- login
- domain/login
|
| E-mail |
E-mail |
withPersonEmail |
|
| Telefon |
Telefon |
withPersonPhone |
|
| Mobilní |
Mobilní |
withPersonMobile |
|
| Kancelář |
Kancelář |
withPersonOffice |
|
| Oddělení |
Oddělení |
withPersonDepartment |
|
| JobTitle |
Pracovní pozice |
withPersonWorkPosition |
|
| Pswd |
SHA1 hash hesla uživatele |
sPersonPswd |
|
| IsAccountDisabled |
"Účet je zakázán" |
bPersonAccountDisabled |
Povolené hodnoty: 0,1 |
| OtherContacts |
Ostatní kontakty |
mPersonContact |
|
| Poznámky |
Poznámky |
mPersonNotes |
|
| Město |
Město |
withPersonCity |
|
| ManagerID |
ID manažera. ID osoby musí v CSV existovat. |
- |
Vyžaduje sloupec ID. |
| DelegateID |
Číslo ID delegáta. ID osoby musí existovat v CSV a související osoby musí mít stejnou společnost(Company). |
- |
Vyžaduje sloupec ID. |
| PersonalNumber |
Číslo osoby |
withPersonPersonalNumber |
|
| OutOfOfficeSinceDate |
Od data nedostupné. Jsou podporovány běžné formáty data a času.
Příklad podporovaných formátů:
- 2012-11-21
- 2012-10-9 15:24:48
- 2010-08-15 14:18:44
- 2010-07-14 |
OutOfOfficeSince |
|
| OutOfOfficeUntilDate |
Neuvádějte datum a čas. Jsou podporovány běžné formáty data a času (viz OutOfOfficeSinceDate). |
OutOfOfficeUntil |
|
| LocaleId |
Jazyk preferovaný uživatelem, jedná se o "kód jazyka", např:
- Čeština: 1029
- Angličtina: 1029: 1033
- Polština: 1033: 1045
- Německo: 1031 |
iPersonLocaleId |
Dobré číslo. |
| Společnost |
Organizace |
- |
Vyhledání organizace podle názvu. Pokud neexistuje, vytvoří se nová organizace podle názvu. |
| Křestní jméno |
FirstName |
withFirstName |
|
| LastName |
LastName |
withLastName |
|
| TimeZone |
TimeZone - musí odpovídat ID časové zóny Windows - více zde. |
TimeZone |
|
| AdGUID |
GUID z Active Directory |
withPersonAdGuid |
|
| AdPath |
Cesta v ActiveDirectory |
withPersonAdPath |
|
| AdSID |
AD SID v textovém tvaru (S-1-5-21-55544...) |
withPersonSID |
|
| IsHidden |
"Skrýt v nabídkách" |
bHidden |
Přípustné hodnoty: 0,1 |
| IsShared |
Jedná se o "sdílený účet" |
bPersonShared |
|
| Země |
Země |
withPersonCountry |
|
| CountryAbbr |
Země (zkratka, 2 znaky) |
withPersonCountryAbbr |
|
| CountryCode |
CountryCode |
andPersonCountryCode |
Číslo buňky |
| PreferredLang |
Preferovaný jazyk (zkratka, 2 znaky) |
withPersonPreferredLanguage |
|
Poznámka:
Atributy lze také mapovat na jakékoli existující vlastní položky z tabulky tPersonCust, s výjimkou položek typu int, které používají seznam hodnot, a typu
user. Název atributu musí být
"@"+[tPersonCust] +[název sloupce databáze], např.
@tPersonCust.Title.
Doporučená struktura souboru CSV
Doporučuje se, aby importovaný soubor CSV obsahoval následující sloupce:
Název sloupce v CSV
(v příkazovém řádku - /cols) |
Důležitost |
Poznámka |
| ID |
Jedinečné identifikační číslo osoby v CSV (např. ID ze systému, ze kterého je CSV exportováno). |
Pokud jsou sloupce ManagerID a DelegateID prázdné, není třeba je vyplňovat. |
| Křestní jméno |
FirstName |
Musí být vyplněno FirstName a LastName, případně FullName. |
| LastName |
Příjmení |
Musí být vyplněno FirstName a FirstName. LastName, případně FullName. |
| FullName |
Jméno a příjmení osoby |
Nesmí být vyplněno - v tomto případě bude hodnota složena jako[FirstName LastName]. |
| PersonalNumber |
PersonalNumber |
|
| Přihlášení |
Jméno uživatele |
Sloupec musí obsahovat hodnoty. |
| Telefon |
Telefon |
|
| Mobilní |
Mobilní |
|
| E-mail |
E-mail |
|
| Kancelář |
Kancelář |
|
| Oddělení |
Oddělení |
|
| JobTitle |
Pracovní pozice |
|
| Společnost |
Organizace |
|
| IsAccountDisabled |
"Účet je zakázán" |
Přípustné hodnoty: 0,1 |
| ManagerID |
Identifikační číslo manažera. ID osoby musí v CSV existovat. |
Vyžaduje sloupec ID. |
| DelegateID |
ID delegáta. ID osoby musí existovat v CSV a související osoby musí mít stejnou společnost(Company). |
Vyžaduje sloupec ID. |
| LocaleId |
Jazyk preferovaný uživatelem, jedná se o "kód jazyka", např:
- Čeština: 1029
- Angličtina: 1029: 1033
- Polština: 1033: 1045
- Německo: 1031 |
Celé číslo. |
Poznámka:
Nepovinné sloupce mohou být prázdné - v takovém případě pozor na to, že odpovídající údaje o osobě v Alvao budou odstraněny (budou prázdné)
Ukázkový soubor CSV
ID;FirstName;LastName;FullName;PersonalNumber;Login;Phone;Mobile;Email;Office;Department;JobTitle;Company;IsAccountDisabled;ManagerID;DelegateID;LocaleId;@tPersonCust.Title
44;David;Ostrý;;PN1111;ostry;3256;+420987654321;ostry@demo.cz;321;Marketing;Manager;;0;46;45;1029;Mr
45;Petr;Novák;;PN2222;novak;3247;+420111222333;novak@demo.cz;323;Promotions;Manager;;1;;;1029;Mr
46;Veronika;Clements;;PN3333;clements;3244;+420121353255;clements@demo.cz;111;Marketing;Head of Department;;0;;44;1033;Mrs
Import CSV s doporučenou strukturou
CSV obsahuje záhlaví s názvy sloupců. Import provede úplnou synchronizaci, tj. odstraní uživatele, které v CSV nenajde, a vytvoří nové uživatele. Klíčovým sloupcem je Login. Příkazový řádek pro import
ImportUsersCsv.exe /csv "c:\data\users.csv" /server server\sql2005 /db alvao /add /remove
Případy použití
Personální systém generuje CSV s mnoha sloupci, do Alvao chceme importovat pouze některá data
HR systém generuje CSV s pevnou strukturou. Tuto strukturu nelze měnit. Chceme vytvořit nové uživatele a zároveň odstranit uživatele, kteří v CSV nejsou (úplná synchronizace). Příklad: CSV obsahuje 30 sloupců. Chceme importovat pouze "přihlašovací jméno" (první sloupec) a "jméno a příjmení" (4. sloupec). Ostatní sloupce nemají žádný význam. CSV neobsahuje hlavičky (názvy sloupců). Použijeme příkazový řádek:
ImportUsersCsv.exe /csv "c:\data\users.csv" /server server\sql2005 /db alvao /cols "Login,0,0,FullName" /nohdrs /add /remove
Import uživatelů z AD a dodatečná aktualizace osob z personálního systému
Import uživatelů z AD (vytvářejí se noví uživatelé a odstraňují se). Potřebujeme aktualizovat další údaje z HR systému - klíčové je číslo osoby (nechceme vytvářet nové uživatele ani je odstraňovat na základě HR systému). HR systém generuje názvy sloupců do CSV podle definice Alvao.
Příklad použití
ImportAD.exe ...
ImportUsersCsv.exe /csv "c:\data\users.csv" /server server\sql2005 /db alvao /key PersonalNumber
Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.