ImportUtil
Popis funkce
Utilita slouží pro import objektů z CSV souborů do Asset Management. Utilita při importu využívá Šablony objektů z AM.
Struktura CSV souboru
CSV soubor musí mít jako oddělovač hodnot středník. Na prvním řádku musí být názvy sloupců:
Sloupec |
Popis |
Class nebo Druh |
Název druhu importovaného objektu. |
SwProfile |
Softwarový profil objektu počítače. Hodnoty zadané v
tomto sloupci musí odpovídat názvům existujících
softwarových profilů. Pokud je hodnota prázdná, nastaví se
softwarový profil počítače na hodnotu „Veškerý software je
povolen“.
|
NodeId |
Unikátní číslo každého objektu v AM (lze zobrazit na
záložce Podřazené objekty, nebo v okně Seznamy objektů). Pokud je
sloupec NodeId použit v parametru –keyfields
a ve sloupci NodeId není žádná hodnota, vytvoří se nový
objekt. Pokud objekt s konkrétním NodeId v databázi
neexistuje, hlásí se varování a objekt se neaktualizuje, ani
se nevytvoří nový objekt.
|
<název vlastnosti> |
Název libovolné vlastnosti objektu v Asset Management (např. „Datum nákupu“). |
Poznámka:
Kódování doporučujeme použít UTF-8.
Syntaxe příkazové řádky
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}
[-class druh objektu]
[-keyfields identifikační sloupec[,identifikační sloupec ...]]
[-parentnodeid NodeId]
[-import]
[-force]
Podrobný popis parametrů
Parametr |
Popis |
-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. |
-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 ověřování systému Windows. Zadáte-li
všechny tyto parametry, použije se pouze -conn
parametr, -server a -db
budou ignorovány. |
-datetimeformat |
Formát data v textových řetězcích (např. dd/MM/yyyy).
Pokud se parametr nezadá, formát se automaticky při převodu
rozpozná. Podrobný popis možných formátů lze nalézt v
MSDN. |
-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. |
-import |
Je-li použit, data se importují do databáze, jinak se
zkontroluje pouze platnost importu. |
-input |
Slouží pro zadání cesty a názvu vstupního CSV souboru
(např.
D:\import\import.csv) |
-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 nebo ve složce zadané parametrem -parentnodetid.
Poznámka:
Pokud je použit k identifikaci sloupec NodeId ( -keyfields
NodeId), tak nelze použít v parametru žádné další sloupce. Více viz
popis sloupce NodeId.
|
-parentnodeid |
Nové objekty vytvářet jako podřazené objekty pod objektem s ID: NodeId.
Poznámka:
Hodnotu NodeId zjistíte v AM Console na záložce
Podřazené objekty
zobrazením systémového sloupce NodeId, nebo v databázi v tabulce
tblNode.intNodeId.
|
-scrapped |
Je-li použit, při importu se hledá a aktualizuje i
majetek ve vyřazeném majetku. |
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
sloupcích vybraných pomocí parametru -keyfields. Pro
více informací o parametru -keyfields 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 s druhem
objektů typu 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 lokálním SQL Serveru. V AM
se vytvoří odpovídající nové objekty ve složce Načtené objekty.
ImportUtil.exe -input
import.csv -server .\sqlexpress
-db AlvaoSample -parentnodeid 92
-import
Příkaz importuje data ze souboru import.csv do databáze
AlvaoSample na lokálním SQL Serveru. V AM
se vytvoří odpovídající nové objekty pod objektem ve stromu s identifikátorem NodeId s hodnotou 92.
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 lokálním SQL Serveru. V AM
se aktualizují vlastnosti identifikovaných objektů, případně
neexistující objekty se vytvoří ve složce Načtené objekty.
ImportUtil.exe -input
update_db.csv -server .\sqlexpress
-db
AlvaoSample -import -keyfields
NodeId
Příkaz aktualizuje hodnoty vlastností objektů dle CSV souboru, jejichž NodeId
odpovídá hodnotám v CSV souboru.
Poznámka:
Pro vyzkoušení funkčnosti výše uvedených příkazů můžete použít
ukázkové CSV soubory
import.csv a
update_db.csv.
Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.