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.