Importovat

Popis funkce

Tato utilita se používá pro import objektů ze souborů CSV do Asset Management. 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 ALVAO Asset Management (např. "Datum nákupu").

Poznámka

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.

Poznámka

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 hodnotou klíče se vyskytující ve sloupcích vybraných parametrem -keyfields. Pro více informací o parametru -keyfields viz výše.
• 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.

Poznámka

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.