ImportUtil

Popis funkce

Funkce slouží k importu nových objektů do složky "Načtené objekty" a aktualizaci existujících objektů v ALVAO Asset Managment(AM) z CSV souboru, kde oddělovačem sloupců je ';' a oddělovačem řádků je konec řádku . Na prvním řádku jsou názvy vlastností.

Funkce při importu využívá Šablony objektů z AM.

Syntaxe funkce

ImportUtil -input "název vstupního CSV souboru" {-conn "připojovací řetězec" | -server "jméno databázového serveru" -db "jméno databáze"} [-import] [-force] [-class "druh objektu"] [-keyfields "identifikační sloupec[,identifikační sloupec ...]"]

Podrobný popis parametrů

Parametr	Popis
-input	Slouží pro zadání cesty a názvu vstupního CSV souboru (např. "D:\import\import.csv")
-conn -server -db	Těmito parametry se nastavuje připojení k databázi ALVAO. Je možné použít připojovací řetězec (např. -conn "Data source=.\sqlexpress;Initial Catalog=test;Integrated Security = 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í do databáze se provede pomocí integrovaného přihlašování Windows. Zadáte-li všechny tyto parametry, použije se pouze -conn parametr, -server a -db budou ignorovány.
-import	Je-li použit, data se importují do databáze, jinak se zkontroluje pouze platnost importu
-class	Pomocí tohoto parametru je možné určit druh objektu ve vstupních datech (např. -class "Monitor"). Parametr je povinný, pokud zdrojový soubor neobsahuje sloupec "Druh", nebo "Class". Obsahuje-li vstupní soubor sloupec "Druh" a je zadán parametr -class "druh objektu", jsou do importu zahrnuty pouze řádky, které mají shodnou položku ve sloupci "Druh" s "druh objektu".
-keyfields	Parametr sloužící pro identifikaci a aktualizaci existujících objektů. Zadané sloupce společně tvoří jednoznačný identifikátor (např. -keyfields "Sériové číslo, Model"). Neodpovídá-li identifikátor žádné položce v databázi, je vytvořen nový objekt ve složce Načtené objekty
-force	Je-li použit, data se importují do databáze, i když se vyskytla chyba v některé z položek. Bez něj jakákoliv chyba způsobí, že se neimportuje žádný záznam.

Poznámka:

Následuje výčet chyb, které jsou ignorovány při použití parametru -force a nezpůsobí selhání celého importu.
Chyby započítané ve výsledku jako přeskočené záznamy(skipped):
    Výskyt více objektů s klíčovou hodnotu ve sloupci(ích) vybraného pomocí parametru -kyefields. Pro více informací o parametru -kyefields vizte výše.
    Neexistující šablona v databázi k objektu v souboru. Pro více informací si prohlédněte parametr -class výše.
    Duplicitní záznamy ve vstupním souboru.
Chyby započítané ve výsledku jako neúspěšně zpracované záznamy(failed):
    Chyba při vytváření objektu podle šablony objektu včetně šablony pro počítačovou sestavu, která je využívána při vytváření objektu druhu "Počítač".
    Chyba při aktualizaci objektu v databázi.

Příklady použití

ImportUtil.exe -input "import.csv" -server ".\sqlexpress" -db "test"

Příkaz zkontroluje validitu formátu souboru "import.csv" v aktuálním adresáři ve vztahu k databázi "test" na "lokálním SQL Serveru".

ImportUtil.exe -input "import.csv" -server ".\sqlexpress" -db "test" -import

Příkaz importuje data ze souboru "import.csv" do databáze "test" na "lokalním SQL Serveru". V AM se vytvoří odpovídající nové objekty ve složce Načtené objekty.

ImportUtil.exe -input "update_db.csv" -server ".\sqlexpress" -db "test" -import -keyfields "Sériové číslo"

Příkaz aktualizuje objekty, které mají položku "Sériové číslo" shodnou s hodnotou v souboru "update_db.csv" v databázi "test" na "lokalním SQL Serveru". V AM se aktualizují vlastnosti indentifikovaných objektů, případně neexistující objekty se vytvoří ve složce Načtené objekty.

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.