Skip Navigation LinksALVAO 11.1ALVAO Asset ManagementImport/export datImportUtil Skip Navigation Links.


ImportUtil

Popis funkce

Tento nástroj slouží k importu objektů ze souborů CSV do Asset Managementu. Nástroj při importu používá šablony objektů z AM.

Struktura souboru CSV

Soubor CSV musí mít jako oddělovač hodnot středník. První řádek musí obsahovat názvy sloupců:

Sloupec Popis
Třída nebo druh Název typu importovaného objektu.
SwProfile Softwarový profil počítačového objektu. Hodnoty uvedené v tomto sloupci musí odpovídat názvům existujících softwarových profilů. Pokud je hodnota prázdná, je softwarový profil 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 konkrétní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").
Poznámka:

Doporučujeme používat kódování UTF-8 (byte order mark je vyžadováno).

Syntaxe příkazového řádku

ImportUtil -input název vstupního souboru CSV{-conn připojovací řetězec | -server název databázového serveru -db název databáze}[-class typ objektu][-separator oddělovač sloupců použitých v souboru CSV][-keyfields identifikační sloupec[,identifikační sloupec ...]][-parentnodeid NodeId][-import][-force]

Popis parametrů

Parametr Popis
-class Pomocí tohoto parametru můžete určit typ objektu ve vstupních datech (např. -class Monitor).
Tento parametr je povinný, pokud zdrojový soubor neobsahuje sloupec Type nebo Class. Pokud vstupní soubor obsahuje sloupec Type a je zadán parametr -class Class object kind (Druh objektu), budou do importu zahrnuty pouze řádky, které mají ve sloupci Type odpovídající položku s druhem objektu.
-conn
-server
-db
Tyto parametry slouží k nastavení připojení k databázi Alvao. Je možné použít připojovací řetězec (např. -conn Zdroj dat=.\sqlexpress;Initial Catalog=test;Integrated Security = True;TrustServerCertificate=True) nebo jednoduše zadat konkrétní SQL server a DB (např. -server .\sqlexpress -db test).
V případě použití parametrů -server a -db se připojení k databázi provede pomocí integrovaného ověřování systému Windows. Pokud zadáte všechny tyto parametry, použije se pouze parametr -conn, -server a -dbbudou ignorovány.
-datetimeformat Formát data v textových řetězcích (např. dd/MM/rrrr). Není-li parametr zadán, formát se při převodu zjistí automaticky. Podrobný popis možných formátů naleznete v MSDN.
-oddělovač Pomocí tohoto parametru můžete určit oddělovač sloupců použitý v importovaném souboru CSV. Např. parametr -separator ",".
-force Pokud je použit, data se do databáze importují i v případě, že je v některé z položek chyba. Bez něj jakákoli chyba způsobí, že se žádný záznam neimportuje.
-import Je-li použit, data se do databáze importují, jinak se kontroluje pouze platnost importu.
-input 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ř. -keyfields 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 zadané parametrem -parentnodetid
Poznámka:
Pokud je k identifikaci použit sloupec NodeId (-keyfields), nelze v parametru použít žádné jiné sloupce. Další informace naleznete v popisu sloupce NodeId
-parentnodeid Vytvoří nové objekty jako podřízené objekty pod objektem s ID: NodeId
Poznámka:
Hodnotu NodeId můžete zjistit v AM Console na kartě Přiřazené objekty. zobrazením systémového sloupce NodeId nebo v databázi v tabulce tblNode.intNodeId
-vyřazeno Pokud je použita, jsou při importu vyhledána a aktualizována také aktiva v aktivu scrapped.
Pozn
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 vyskytující se ve sloupcích vybraných parametrem -keyfields. Další informace o parametru -keyfields naleznete výše.
  • Neexistující šablona v databázi pro objekt v souboru. Další informace naleznete výše v parametru -class.
  • Duplicitní záznamy ve vstupním souboru.

Znaky započítané do výsledku jako chybné 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 druhem objektu Počítač.
  • Chyba při aktualizaci objektu v databázi.

Příklady použití

ImportUtil.exe -input import.csv -server.\sqlexpress-dbAlvaoSample -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 SQL Serveru

ImportUtil.exe -input import.csv -server.\sqlexpress-db AlvaoSample -import

Tento příkaz importuje data ze souboru import.csv do silné databáze AlvaoSample na místním SQL Serveru. 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 silné databáze AlvaoSample na místním serveru SQL. V AMse vytvoří příslušné nové objekty pod objektem ve stromu s NodeId s hodnotou 92

ImportUtil.exe -input . update_db.csv -server.\sqlexpress-dbAlvaoSample -import -keyfields registrační značka

Tento příkaz aktualizuje objekty, které mají položku registrační značky odpovídající hodnotě v souboru update_db.csv v databázi em>strong. AlvaoSample na místním serveru SQL Server. V AMse aktualizují vlastnosti identifikovaných objektů nebo se vytvoří neexistující objekty ve složce Read Objects

ImportUtil.exe -input update_db.csv -server.\sqlexpress-dbAlvaoSample -import -keyfields NodeId

Příkaz aktualizuje hodnoty vlastností objektů podle souboru CSV, jejichž NodeId odpovídá hodnotám v souboru CSV.

Poznámka
Pro vyzkoušení funkčnosti výše uvedených příkazů můžete použít ukázkové soubory CSV import.csv a update_db.csv.

 

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