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:
/csv <cesta k souboru CSV> /server <sql_server> /db <databáze_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"

Utilita 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 "řetězec připojení" | /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é namapovat na jakékoli existující vlastní pole 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;Cooper;;PN1111;david.cooper;3256;;david.cooper@contoso.com;321;IT;CIO;;0;46;45;1029;Mr
45;Peter;Jenkins;;PN2222;peter.jenkins;3247;;peter.jenkins@contoso.com;323;IT;IT support manager;;1;;;1029;Mr
46;Veronica;Palmer;;PN3333;veronica.palmer;3244;;clements@contoso.com;111;IT;Project manager;;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.