ExportUtil
Popis funkce
Aplikace slouží k exportu objektů ze systému ALVAO Asset Management do standardního souboru CSV. Exportuje pouze majetek aktivní evidence, tj. s vyloučením "vyřazeného majetku", "koše" a dalších objektů systému
Syntaxe příkazových řádků
ExportUtil /csv "cesta a název souboru CSV" {/con "řetězec připojení" | /server "název databázového serveru" /db "název databáze"} /cols"seznam sloupců"[/NotEmpty"název sloupce"] [/TemplateFolder "název složky"][/where {[@třída] | [@název] | [@cesta] | [<název vlastnosti objektu>]}<operátor><hodnota>]
Podrobný popis parametrů
Parametr |
Popis |
/csv |
Cesta a název souboru CSV, do kterého budou uloženy informace o objektu. |
/con /server /db |
Tyto parametry slouží k nastavení připojení k databázi Alvao. Je možné použít řetězec připojení (např. /con "Zdroj dat=.\sqlexpress;Počáteční katalog=test;Integrované zabezpečení = True;TrustServerCertificate=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í k databázi se provede pomocí integrovaného ověřování systému Windows. Pokud zadáte všechny tyto parametry, použije se pouze parametr /con, /server a /dbbudou ignorovány. |
/cols |
Definice sloupců, které budou exportovány do výstupního souboru. Viz níže. |
/NotEmpty |
Tento parametr je určen pro zpětnou kompatibilitu a v budoucích verzích bude odstraněn. Doporučujeme místo něj používat parametr /where. Ten exportuje pouze objekty, u nichž hodnota konkrétní vlastnosti objektu není prázdná.
Poznámka: Název vlastnosti může být zapsán bez diakritiky. |
/TemplateFolder |
Tento parametr slouží ke zpětné kompatibilitě a v budoucích verzích bude odstraněn. Doporučujeme místo něj používat parametr /where. Ten exportuje pouze určité typy objektů ležících v šablonách objektů v určité složce. Parametrem je název složky.
Poznámka: Název složky může být zapsán bez diakritiky. |
/where |
Slouží k filtrování exportovaných objektů podle typu, názvu, cesty ve stromu a hodnot vlastností. Za přepínačem následuje logický výraz filtru v uvozovkách. Budou exportovány všechny objekty, pro které je výraz splněn.
Ve výrazu můžete použít následující proměnné: . - [@class] - druh objektu
- [@name] - název objektu ve stromu
- [@path] - cesta ve stromu, znak "/" se používá jako oddělovač úrovní
. - [<název vlastnosti objektu>] - hodnota určité vlastnosti objektu, například [Sériové číslo].
Poznámka: názvy vlastností lze zadat bez diakritiky. Konstanty
- N'<textová konstanta>' - text v unicode, například N'Petr Novák'.
- '<textová konstanta>' - text v ASCII (bez diakritiky), například 'Sériové číslo'.
- <číselná konstanta> - např. 12.
Operátory
- = [@class]=N'Computer/server' - rovná se, např
- !=, <> - nerovná se, např. [@class]<>N'Computer/server'
- IN - hodnota se rovná jedné ze zadaných hodnot, např. [@class]IN (N'Computer/server', N'Computer/virtual')
- LIKE - porovnávání řetězců s možností použití jednoduchých regulárních výrazů. Např. druh objektu začínající na 'Computer/': [@class] LIKE N'Computer/%')
- NOT - negace operátorů IN nebo LIKE, např. [@class] NOT LIKE N'Computer/%')
- IS NULL - hodnota je NULL - např. objekt nemá vlastnost Sériové číslo: [Sériové číslo] IS NULL.
Části výrazu můžete spojovat pomocí operátorů AND a OR.
Poznámka:
Formát výrazu odpovídá výrazu WHERE v jazyce SQL
|
Popis podporovaných sloupců
Sloupce nastavené v parametru /cols jsou odděleny čárkou. Doporučujeme uzavřít celou hodnotu parametru do uvozovek.
Sloupce |
Důležitost |
Příklad hodnoty |
@id |
Jedinečný identifikátor (číslo INT) objektu v databázi Asset Management (NodeId). |
1245 |
@name |
Název objektu ve stromu objektů. |
HP LP2475w, LCD, 24" |
@class |
Druh objektu. |
Monitor |
@path |
Cesta k objektu ve stromu objektů. |
Organizace/Brno/Petr Novák |
@adguid |
Identifikátor GUID objektu z Active Directory (obsahuje hodnotu, pokud byl objekt vytvořen nebo spárován pomocí importu AD). |
{f50c0d0f-fede-4aaa-9509-7632e48251cc} |
[vlastnost objektu] |
Jakákoli vlastnost objektu. Vlastnosti musí být zapsány v hranatých závorkách.
Poznámka: Název vlastnosti může být s diakritikou nebo bez ní. |
SN1234 |
Příklad hodnoty parametru: "@id,@name,@path,@class,[serial number],[inventory number],[name in network]"
Scénáře
Exportovat objekty, které mají hodnotu ve vlastnosti "Inventární číslo".
ExportUtil.exe /csv "c:\data\objects.csv" /server server\sql2005 /db alvao /cols "@id,@name,@path,@class,[serial number],[inventory number],[name in siti]" /where "[inventory number]!=''"
Exportovat všechny objekty, jejichž šablona objektu se nachází ve složce "IT assets" v šablonách objektů
ExportUtil.exe /csv "c:\data\objects.csv" /server server\sql2005 /db alvao /cols "@id,@name,@path,@class,[serial number],[inventory number],[name in siti]" /where "[@class] IN (SELECT txtClass FROM vNodeClass WHERE txtPath LIKE N'Object Templates/Inventory IT%')"
Exportovat všechny mobilní telefony
ExportUtil.exe /csv "c:\data\objects.csv" /server server\sql2005 /db alvao /cols "@id,@name,@path,@class,[serial number],[inventory number],[inventory number],[name in network]" /where "[@class]=N'Mobile phone'"
Exportovat všechny mobilní telefony iPhone 7
ExportUtil.exe /csv "c:\data\objects.csv" /server server\sql2005 /db alvao /cols "@id,@name,@path,@class,[serial number],[inventory number],[name in network]" /where "[@class]=N'Mobile phone' AND [Model]=N'iPhone 7'"
Export všech mobilních telefonů v pobočce Brno
ExportUtil.exe /csv "c:\data\objects.csv" /server server\sql2005 /db alvao /cols "@id,@name,@path,@class,[serial number],[inventory number],[name in network]" /where "[@class]=N'Mobile phone' AND [@path] LIKE N'Organization/Brno/%'"
Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.