Importovat
Popis funkce
Tato utilita se používá pro import objektů ze souborů CSV do Správa majetku. Nástroj používá Šablony objektů od AM během importu. Tento nástroj je k dispozici pouze pro místní uživatele.
Struktura souboru CSV
Soubor CSV musí mít čárku jako oddělovač hodnot. První řádek musí obsahovat názvy sloupců:
| Sloupec | Popis |
|---|---|
| Třída nebo typ | Název typu importovaného objektu. |
| SwProfile | Softwarový profil počítačového objektu. Hodnoty zadané v tomto sloupci musí odpovídat názvům existujících softwarových profilů. Pokud je hodnota prázdná, je profil softwaru počítače nastaven na "Všechen software je povolen". |
| NodeId | Jedinečné číslo každého objektu v AM (lze zobrazit na kartě Podřazené objekty nebo v okně Seznamy objektů). Pokud je v parametru -keyfields použit sloupec NodeId a ve sloupci NodeId není žádná hodnota, vytvoří se nový objekt. Pokud objekt s určitým NodeId v databázi neexistuje, je vydáno varování a objekt není aktualizován nebo je vytvořen nový objekt. |
| <název vlastnosti> | Název libovolné vlastnosti objektu ve správě aktiv (např. "Datum nákupu"). |
Doporučujeme použít kódování UTF-8 (je vyžadována značka pořadí bajtů).
Syntaxe příkazového řádku
ImportUtil -input "name_of_input_CSV_file" {-conn "connection_string" | -server "name_of_database_server" -db "name_of_database"} [-class "object_type"] [ -separator "column_separator_used_in_CSV_file"] [-keyfields "identification_column[,identification_column ...]]* [-parentnodeid "NodeId"] [-import] [-force]
Parametry
| Parametr | Popis |
|---|---|
| -třída | Pomocí tohoto parametru můžete určit typ objektu ve vstupních datech (např. třída Monitor). Tento parametr je povinný, pokud zdrojový soubor neobsahuje sloupec Typ nebo Třída. Pokud vstupní soubor obsahuje sloupec Typ a v parametru třída Třída je zadán typ objektu, jsou do importu zahrnuty pouze řádky, které mají ve sloupci Typ odpovídající položku s typem objektu. |
| -conn -server -db | Tyto parametry slouží k nastavení připojení k databázi Alvao. Je možné použít řetězec připojení (např. -conn Data source=.\sqlexpress;Initial Catalog=test;Integrated Security = True;TrustServerCertificate=True) nebo jednoduše zadat konkrétní SQL server a DB (např. -server .\sqlexpress -db test). Pokud použijete parametry -server a -db, připojení k databázi se uskuteční pomocí integrovaného ověřování systému Windows. Pokud zadáte všechny tyto parametry, použije se pouze parametr -conn, -server a -db budou ignorovány. |
| -datetimeformat | Formát data v textových řetězcích (např. dd/MM/rrrr). Pokud není parametr zadán, nastavení formátu vychází z nastavení jazyka prostředí. Podrobný popis možných formátů najdete v MSDN. |
| -oddělovač | Pomocí tohoto parametru můžete určit oddělovač sloupců použitý v importovaném souboru CSV. Např. -separator "," |
| -force | Pokud se použije, data se do databáze importují i v případě, že je v některém z údajů chyba. Bez něj se při jakékoli chybě neimportuje žádný záznam. |
| -import | Pokud je použito, data se importují do databáze, jinak se kontroluje pouze platnost importu. |
| -vstup | Slouží k zadání cesty a názvu vstupního souboru CSV (např. em D:\import\import.csv). |
| -klíčová pole | Parametr sloužící k identifikaci a aktualizaci existujících objektů. Zadané sloupce společně tvoří jedinečný identifikátor (např. klíčová pole Sériové číslo, Model). Pokud identifikátor neodpovídá žádné položce v databázi, vytvoří se nový objekt ve složce Read Objects nebo ve složce určené parametrem -parentnodetid. Poznámka Pokud je k identifikaci NodeId použit sloupec NodeId (-keyfields), nelze v parametru použít žádné jiné sloupce. Další informace naleznete v popisu sloupce NodeId. |
| -parentnodeid | Vytvoření nových objektů jako podřízených objektů pod objektem s ID: NodeId. |
| -scrapped | Pokud je použito, jsou při importu vyhledány a aktualizovány také aktiva ve vyřazeném aktivu. |
Následuje seznam chyb, které jsou při použití parametru -force ignorovány a nezpůsobí selhání celého importu.
Chyby se do výsledku započítávají jako přeskočené záznamy:
- Více objektů s klíčovou hodnotou vyskytující se ve sloupcích vybraných parametrem -keyfields. Další informace o parametru -keyfields naleznete výše na adrese .
- Neexistující šablona v databázi pro objekt v souboru. Další informace naleznete ve výše uvedeném parametru -class.
- Duplicitní záznamy ve vstupním souboru.
Znaky započítané do výsledku jako neúspěšné záznamy:
- Chyba při vytváření objektu podle šablony objektu, včetně šablony pro sestavu počítače, která se používá při vytváření objektu s typem objektu Počítač.
- Chyba při aktualizaci objektu v databázi.
Příklady použití
ImportUtil.exe -input import.csv -server .\sqlexpress -db AlvaoSample -separator ","
Tento příkaz zkontroluje platnost formátu souboru import.csv v aktuálním adresáři oproti databázi AlvaoSample na místním serveru SQL.
ImportUtil.exe -input import.csv -server .\sqlexpress -db AlvaoSample -import
Tento příkaz importuje data ze souboru import.csv do databáze strong. AlvaoSample na lokálním serveru SQL. Ve složce AM Read Objects se vytvoří příslušné nové objekty.
ImportUtil.exe -input import.csv -server .\sqlexpress -db AlvaoSample -parentnodeid 92 -import
Tento příkaz importuje data ze souboru import.csv do databáze strong. AlvaoSample na lokálním serveru SQL. V AM se příslušné nové objekty vytvoří pod objektem ve stromu s NodeId s hodnotou 92.
ImportUtil.exe -input. update\db.csv -server .\sqlexpress -db AlvaoSample -import -keyfields "registration mark"
Tento příkaz aktualizuje objekty, které mají položku registrační značka odpovídající hodnotě v souboru update_db.csv v databázi em>strong. AlvaoSample na lokálním serveru SQL. Ve složce AM se aktualizují vlastnosti identifikovaných objektů nebo se vytvoří neexistující objekty ve složce Read Objects.
ImportUtil.exe -input update\db.csv -server .\sqlexpress -db AlvaoSample -import -keyfields NodeId
Příkaz aktualizuje hodnoty vlastností objektů podle souboru CSV, jejichž NodeId odpovídá hodnotám v souboru CSV.
K otestování funkčnosti výše uvedených příkazů můžete použít ukázkové soubory CSV import.csv a update-db.csv.