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 "key column"] [/cols "column list"] [/utcdate] [/nohdrs] [/add] [/remove] [/help]
Parametry příkazové řádky
| Parametr | L 343, 22.12.2009, s. 1). |
|---|---|
| /csv | Cesta a název souboru CSV, ze kterého má být proveden import. |
| /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, bude použit pouze /con, /server a /db ignorován. |
| /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) | Význam | Související 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. |
| FullName | Jméno a příjmení osoby | sOsoba | Nesmí se vyplnit - v tomto případě bude hodnota složena jako [**Příjmení **] (pokud je vyplněno). |
| Přihlásit se | 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:
|
| E-mailová adresa | E-mailová adresa | sPersonEmail | |
| Telefon | Telefon | SPersonPhone | |
| Mobil | Mobil | sPersonMobile | |
| Kancelář | Kancelář | SPersonOffice | |
| Oddělení | Oddělení | SPersonDepartment | |
| Jobtitulek | Pozice zakázky | sPersonWorkPosition | |
| Pswd | SHA1 hash hesla uživatele | sPersonPswd | |
| IsAccountzakázáno | "Účet je zakázán" | bPersonAccountZakázáno | Povolené hodnoty: 0,1 |
| Další Kontakty | Další kontakty | mPersonContact | |
| Poznámky | Poznámky | mPersonNotes | |
| Město | Město | spersonCity | |
| ID správce | ID správce obsahu. ID osoby musí existovat v CSV. | - | Vyžaduje ID sloupec. |
| DelegateID | Zmocnit číslo ID. 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 | spersonalČíslo | |
| OutOfOfficeSodDatum | Nedostupné od data. Podporovány jsou společné formáty data a času. Příklad podporovaných formátů:
| OutOfOfficeod | |
| Datum outOfOfficeUntilDate | Neuvádějte datum a čas. Společné formáty data a času jsou podporovány (viz OutOfOfficeSinceDate). | OutOfOfficeUntil | |
| 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. |
| Článek 2 | Organizace | - | Hledat organizaci podle názvu. Pokud neexistuje, nová organizace je vytvořena podle názvu. |
| Jméno | Jméno | sFirstName | |
| Příjmení | Příjmení | sLastName | |
| TimeZone | Časová zóna - musí odpovídat ID časového pásma systému Windows - více here. | TimeZone | |
| AdGUID | GUID z Active Directory | sPersonAdGuid | |
| AdPath | Cesta v Aktivním adresáři | Cesta sPersonAdPath | |
| AdSID | AD SID v textu (S-1-5-21-55544...) | SpersonSID | |
| IsHidden | "Skrýt v nabídce" | bHidden | Přípustné hodnoty: 0,1 |
| Sdílené | Toto je "sdílený účet" | Personálně sdílen é | |
| L 343, 22.12.2009, s. 1). | L 343, 22.12.2009, s. 1). | spersonCountry | |
| CountryAbbr | Země (zkratka, 2 znaky) | sPersonCountryAbbr | |
| CountryCode | CountryCode | andPersonCountryCode | Číslo buňky |
| Předvolený Lang | Upřednostňovaný 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) | Význam | 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. |
Jméno | 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. |
FullName | 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ásit se | Uživatelské jméno | Sloupec musí mít hodnoty. |
| Telefon | Telefon | |
| Mobil | Mobil | |
| E-mailová adresa | E-mailová adresa | |
| Kancelář | Kancelář | |
| Oddělení | Oddělení | |
| Jobtitulek | Pozice zakázky | |
| Článek 2 | Organizace | |
| IsAccountzakázáno | Účet je zakázán | Přípustné hodnoty: 0,1 |
| ID správce | Identifikační číslo manažera. ID osoby musí existovat v CSV. | Vyžaduje ID sloupec. |
DelegateID | Pověřená osoba. 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;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;
45;Peter;Jenkins;PN2222;peter.jenkins;3247;;;peter.jenkins@conto.com;323;IT;1;IT správce podpory;1;1029;pan
46;Veronica;Palmer;PN3333294;cle
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