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.
V CSV souboru je oddělovačem sloupců ';' a oddělovačem řádků konec
řádku. Na prvním řádku jsou názvy vlastností, které musí souhlasit s
názvy vlastností šablony importovaného objektu. Ve sloupci s názvem "class"
jsou zapsány druhy importovaných objektů v podobě názvu šablony. Každý
řádek potom představuje jeden importovaný objekt a jednotlivé sloupce
hodnoty jeho 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
"AlvaoSample"
Příkaz zkontroluje validitu formátu souboru "import.csv" v aktuálním
adresáři ve vztahu k databázi "AlvaoSample" na "lokálním SQL Serveru".
ImportUtil.exe -input "import.csv"
-server ".\sqlexpress" -db "AlvaoSample"
-import
Příkaz importuje data ze souboru "import.csv" do databáze
"AlvaoSample"
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
"AlvaoSample"
-import -keyfields "registrační
značka"
Příkaz aktualizuje objekty, které mají položku "registrační
značka"
shodnou s hodnotou v souboru "update_db.csv" v databázi
"AlvaoSample"
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.
|