Importovat uživatele z CSV
Pravidelný automatický import
Vytvořte naplánovaný úkol na serveru s obdobím opakování, např. 1 čas za den, který spustí následující příkaz:
%ProgramFiles%\ALVAO\AlvaoService\utilities\ImportUsersCsv.exe /csv <path to CSV file> /server <sql_server> /db <database_alvao> /add /remove
Jednorázový import
Pro jednorázový import portrétů na serveru, spusťte vytvořený úkol 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.
ImportUsersCSV utility
Tento nástroj importuje uživatele ze souboru CSV do Alvao. Můžete jej použít například k aktualizaci uživatelů v Alvao podle dat v systému HR atd.
Syntaxe příkazového řádku
ImportUsersCSV /csv*"path and name of CSV file"* { /con*"connection string"| /server"database server name"/db"database name"*} [ /key"key column"] [ /cols"column list"] [ /utcdate] [ /nohdrs] [ /add] [ /remove]
ImportUsersCSV /csv "<CSV file path>" { /con "<connection string>" | {/server "<database server name>" /db "<database name>"} } [/key "klíčový sloupec"] [/cols "seznam sloupců"] [/utcdate] [/nohdrs] [/add] [/remove] [/help]
Parametry příkazové řádky
| Parametr | Popis |
|---|---|
| /csv | Cesta a název souboru CSV, ze kterého se má importovat. |
| /con, /server, /db | Tyto parametry se používají k nastavení připojení k databázi Alvao. Je možné použít připojovací řetězec (např. /con "Zdroj dat" =. sqlexpress;Initial Catalog=test;Integrated Security = True;TrustServerCertificate=True"), nebo jednoduše zadejte specifický SQL server a DB (např. /server ".\sqlexpress" /db "test"). V případě, že používáte parametry /server a /db, je databázové připojení vytvořeno pomocí Integrované autentizace systému Windows. Pokud zadáte všechny tyto parametry, použije se pouze parametr /con, parametry /server a /db budou ignorovány. |
| /key | Sloupec klíčů se používá pro vyhledání existujícího uživatele v administraci. Pokud není zadán žádný parametr, klíčový sloupec je Přihlášení (musí existovat v CSV). |
| /cols | Umožňuje specifikovat význam a pořadí sloupců v CSV (CSV neobsahuje hlavičky). Pokud je 0 zadán v seznamu (nula), odpovídající sloupec z CSV nebude importován (ignorováno). Poznámka: Seznam na příkazovém řádku nesmí obsahovat stejný počet sloupců jako CSV (neuvedené sloupce budou přeskočeny - ignorováno). |
| /utcdate | Sloupce data jsou v čase UTC. Pokud přepínač není specifikován, časové údaje v CSV se posuzují v aktuálním časovém pásmu počítače (místní čas). |
| /nohdrs | Importovaný CSV neobsahuje záhlaví (první řádek) s popisem sloupců. |
| /add | Vytvořte nové uživatele v Alvao. Poznámka: Pokud tento přepínač není zadán, import nevytvoří nové uživatele, ale pouze aktualizuje stávající. |
| /remove | Odstraňte uživatele z Alvao, že v souboru CSV nenaleze. |
Podporované CSV sloupce
| Název sloupce v CSV (parametr /cols) | Příbuzný sloupec v tabulce tPerson | Poznámky | |
|---|---|---|---|
| ID | Jedinečné identifikační číslo osoby v CSV (např. identifikační kód ze systému, ze kterého je CSV vyvážen). | - | Pokud CSV obsahuje ManagerID nebo DelegateID, import vyžaduje tento sloupec, jinak skončí chybou. |
| Celé jméno | Jméno a příjmení osoby | sPerson | Nesmí se vyplnit - v tomto případě bude hodnota složena jako [**Příjmení **] (pokud je vyplněno). |
| Přihlášení | Uživatelské jméno | sPersonLogin (pokud je hodnota formuláře domain a je uživatelem AD, pak SamAccountName) | Uživatelské jméno lze zadat v následujících formulářích:
|
| sPersonEmail | |||
| Telefon | Telefon | sPersonPhone | |
| Mobilní | Mobilní | sPersonMobile | |
| Kancelář | Kancelář | sPersonOffice | |
| Oddělení | Oddělení | sPersonDepartment | |
| Název pozice | Pracovní pozice | sPersonWorkPosition | |
| Heslo | SHA1 hash hesla uživatele | sPersonPswd | |
| Je účet deaktivován | "Účet je zakázán" | bPersonAccountDisabled | Povolené hodnoty: 0,1 |
| Ostatní kontakty | Další kontakty | mPersonContact | |
| Poznámky | Poznámky | mPersonNotes | |
| Město | Město | sPersonCity | |
| ID manažera | ID manažera. ID osoby musí existovat v CSV. | - | Vyžaduje ID sloupec. |
| ID delegáta | Číslo ID delegáta. ID osoby musí existovat v CSV a osoby ve spojení musí mít stejnou společnost (společnost). | - | Vyžaduje ID sloupec. |
| Osobní číslo | Osobní číslo | sPersonPersonalNumber | |
| Datum nepřítomnosti v kanceláři | Nedostupné od data. Podporovány jsou společné formáty data a času. Příklad podporovaných formátů:
| Nepřítomnost v kanceláři od | |
| Datum návratu z nepřítomnosti v kanceláři | Neuvádějte datum a čas. Společné formáty data a času jsou podporovány (viz OutOfOfficeSinceDate). | Návrat z nepřítomnosti v kanceláři | |
| LocaleId | Uživatelsky preferovaný jazyk, to je "jazykový kód", např.:
| iPersonLocaleId | Celé číslo. Výchozí jazyk databáze se používá, pokud není zadáno číslo. |
| Společnost | Organizace | - | Hledat organizaci podle názvu. Pokud neexistuje, nová organizace je vytvořena podle názvu. |
| Křestní jméno | Křestní jméno | sFirstName | |
| Příjmení | Příjmení | sLastName | |
| Časové pásmo | Časová zóna - musí odpovídat ID časového pásma systému Windows - více here. | Časové pásmo | |
| AdGUID | GUID z Active Directory | sPersonAdGuid | |
| AdPath | Cesta v Aktivním adresáři | sPersonAdPath | |
| AdSID | AD SID v textové formě (S-1-5-21-55544...) | sPersonSID | |
| Je skrytý | "Skrýt v nabídce" | bHidden | Přípustné hodnoty: 0,1 |
| Je sdílený | Toto je "sdílený účet" | bPersonShared | |
| Země | Země | sPersonCountry | |
| Zkrácená země | Země (zkratka, 2 znaky) | sPersonCountryAbbr | |
| Kód země | Kód země | andPersonCountryCode | Číslo mobilního telefonu |
| Preferovaný jazyk | Preferovaný jazyk (zkratka, 2 znaky) | sPersonPreferredLanguage |
Atributy mohou být také namapovány do jakéhokoli existujícího vlastního pole z tabulky tPersonCust kromě polí typu, která používají seznam hodnot a typ uživatel. Název atributu musí být "@"+[tPersonCust] +[sloupec databáze], např. @tPersonCust.Title.
Doporučená struktura CSV souborů
Doporučujeme zahrnout následující sloupce do importovaných CSV souborů:
| Název sloupce v CSV (parametr /cols) | Důležitost | Poznámka |
|---|---|---|
ID | Jedinečné identifikační číslo osoby v CSV (např. identifikační kód ze systému, ze kterého je CSV vyvážen). | Pokud jsou sloupce ManagerID a DelegateID prázdné, není třeba je vyplňovat. |
Křestní jméno | Křestní jméno | Musíte vyplnit Jméno a **Příjmení **, nebo celé jméno. |
Příjmení | Příjmení | Jméno a Jméno musí být vyplněno. |
Celé jméno | Jméno a příjmení osoby | Nesmí se vyplnit - v tomto případě bude hodnota složena jako [**Příjmení **]. |
| Osobní číslo | Osobní číslo | |
| Přihlášení | Uživatelské jméno | Sloupec musí mít hodnoty. |
| Telefon | Telefon | |
| Mobilní | Mobilní | |
| Kancelář | Kancelář | |
| Oddělení | Oddělení | |
| Název pozice | Pracovní pozice | |
| Společnost | Organizace | |
| Je účet deaktivován | Účet je deaktivován | Povolené hodnoty: 0,1 |
| ID manažera | Identifikační číslo manažera. ID osoby musí existovat v CSV. | Vyžaduje ID sloupec. |
ID delegáta | ID delegáta. ID osoby musí existovat v CSV a osoby ve spojení musí mít stejnou společnost (společnost). | Vyžaduje ID sloupec. |
LocaleId | Uživatelsky preferovaný jazyk, to je "jazykový kód", např.:
| Celé číslo. |
Volitelné sloupce mohou být prázdné - buďte opatrní v tomto případě budou odstraněny odpovídající údaje pro osobu v Alvao (budou prázdné).
Ukázkový soubor CSV
ID;Jméno;Příjmení;Celé jméno;Osobní číslo;Přihlašovací jméno;Telefon;Mobilní telefon;E-mail;Kancelář;Oddělení;Pracovní pozice;Společnost;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.
Importovat CSV s doporučenou strukturou
CSV obsahuje záhlaví s názvy sloupců. Import provede úplnou synchronizaci, tzn. odstraní uživatele, které nenajde v CSV a vytvoří nové uživatele. Klíčový sloupec je Přihlášení.
Příkazová řádka:
ImportUsersCsv.exe /csv "c:\data\users.csv" /server server\sql2005 /db alvao /add /remove
Případy použití
HR systém generuje CSV s mnoha sloupci, chceme importovat pouze některá data do Alvao
Systém HR generuje CSV s pevnou strukturou. Tuto strukturu nelze změnit. Chceme vytvořit nové uživatele a zároveň odstranit uživatele, kteří nejsou v CSV (úplná synchronizace).
Příklad: CSV obsahuje 30 sloupců. Chceme importovat pouze "přihlašovací jméno" (první sloupec) a "first and last name" (4. sloupec). Ostatní sloupce nemají žádný význam. CSV neobsahuje záhlaví (názvy sloupců).
Použijeme příkazovou řádku:
ImportUsersCsv.exe /csv "c:\data\users.csv" /server server\sql2005 /db alvao /cols "Login,0,0,FullName" /nohdrs /add /remove
Dovoz uživatelů z AD a další aktualizace osob ze systému HR
Importovat uživatele z AD (noví uživatelé jsou vytvořeni a smazáni). Potřebujeme aktualizovat další data z HR systému - klíč je osobní číslo (nechceme vytvářet nové nebo odstraňovat uživatele na základě HR systému). Systém HR generuje do CSV názvy sloupců podle definice Alvao.
Příklad použití:
ImportAD.exe ...
ImportUsersCsv.exe /csv "c:\data\users.csv" /server server\sql2005 /db alvao /key PersonalNumber