Importovat
Popis funkce
Tato utilita se používá pro import objektů ze souborů CSV do Správa majetku. Nástroj používá Šablony objektů od AM během importu. Tento nástroj je k dispozici pouze pro uživatele s premise
Struktura souboru CSV
Soubor CSV musí mít čárku jako oddělovač hodnot. První řádek musí obsahovat názvy sloupců:
Sloupec | Popis |
---|---|
Class or Type | Název typu importovaného objektu. |
Profil | Profil softwaru počítačového objektu. Hodnoty zadané v tomto sloupci musí odpovídat názvům existujících softwarových profilů. Pokud je hodnota prázdná, software počítače je nastaven na "Veškerý software je povolen". |
NodeId | Jedinečný počet každého objektu v AM (může být zobrazen na kartě Child Objects nebo v okně seznamů objektů). Je-li sloupec NodeId použit v parametru -keyfields a ve sloupci NodeId není žádná hodnota, byl vytvořen nový objekt. Jestliže objekt se specifickým NodeId neexistuje v databázi, je vydáno varování a předmět není aktualizován nebo je vytvořen nový objekt. |
<property name> | Název libovolné vlastnosti objektu v Správa aktiv (např. "Datum nákupu"). |
Doporučujeme použít kódování UTF-8 (je vyžadováno pořadí bajtů).
Syntaxe příkazového řádku
ImportUtil -inputnázev souboru CSV souboru { -connconnection string| -servernázev databázového serveru**-db**název databáze} [ -classtyp objektu] [ -separator_oddělovač sloupců používaný v souboru CSV _] [ -keyfieldsIdentifikační sloupec[, dentální sloupec .]] [ -parentnodeidNodeId] [ -import] [ **-force **]
Popis parametrů
Parametr | Popis |
---|---|
-třída | Pomocí tohoto parametru můžete zadat typ objektu v vstupní data (např. -class Monitor). This parameter is mandatory if the source file does not contain a Type or Class column. If the input file contains the Type column and the -class Class parameter is specified object type, only rows that have a matching entry in the Type column with object type are included in the import. |
-conn -server -db | These parameters are used to set the connection to the Alvao database. It is possible to use a connection string (e.g. -conn Data source=.\sqlexpress;Initial Catalog=test;Integrated Security = True;TrustServerCertificate=True), or simply specify a specific SQL server and DB (e.g. -server .\sqlexpress -db test). In case you use the -server parameters and -db, the database connection is made using Windows Integrated Authentication. If you specify all these parameters, only -conn is used parameter, -server and -db will be ignored. |
-datetimeformat | Date format in text strings (e.g. dd/MM/yyyy). If the parameter is not specified, the format setting is based on your environment's language setting. A detailed description of the possible formats can be found in MSDN. |
-separator | Using this parameter, you can specify the column separator used in the imported CSV file. E.g., -separator "," |
-force | If used, the data is imported into the database even if there is an error in one of the entries. Without it, any error will cause no record to be imported. |
-import | If used, the data is imported into the database, otherwise only the validity of the import is checked. |
-input | Used for specifying the path and name of the input CSV file (e.g. em D:\import\import.csv) |
-keyfields | Parameter used to identify and update existing objects. The specified columns together form a unique identifier (e.g. -keyfields Serial number, Model). If the identifier does not correspond to any item in the database, a new object is created in the Read Objects folder or in the folder specified by the -parentnodetid parameter. Poznámka If the NodeId column (-keyfields) is used to identify NodeId), no other columns can be used in the parameter. See the description of the NodeId column for more information. |
-parentnodeid | Create new objects as child objects under the object with ID: NodeId. Poznámka You can find out the NodeId value in the AM Console on the Assigned Objects tab. by displaying the system NodeId column, or in the database in the tblNode.intNodeId table. |
-scrapped | If used, the assets in the scrapped asset are also searched for and updated on import. |
Následující je seznam chyb, které jsou při použití parametru -sila ignorovány a nezpůsobují selhání celého importu.
Chyby počítané ve výsledku jako přeskočené záznamy:
- Více objektů s hodnotou klíče vyskytující se ve sloupcích vybraných parametrem -keypole. Další informace o parametru -klíčová pole naleznete v výše.
- Neexistující šablona v databázi pro objekt v souboru. Další informace naleznete výše uvedený parametr třídy -.
- Duplikovat záznamy ve vstupním souboru.
Znaky počítané ve výsledku jako neúspěšné záznamy:
- Došlo k chybě při vytváření objektu podle šablony objektu. včetně šablony pro počítačovou zprávu, která se používá při vytváření objektu s typem počítačového objektu.
- Chyba při aktualizaci objektu v databázi.
Příklady použití
ImportUtil.exe -inputimport.csv -server .\sqlexpress**-db_AlvaoSample_-oddělovač **","
Tento příkaz kontroluje platnost formátu souboru import.csv v aktuálním adresáři proti databázi AlvaoSample na místním SQL Server.
ImportUtil.exe -inputimport.csv -server .\sqlexpress**-db_AlvaoSample_-import**
Tento příkaz importuje data ze souboru import.csv do databáze strong. AlvaoSample na místním SQL serveru. V AM Číst objekty adresáři budou vytvořeny odpovídající nové objekty.
ImportUtil.exe -input*. import.csv* -server .\sqlexpress**-db_AlvaoSample-parentnodeid92_-import**
Tento příkaz importuje data ze souboru import.csv do databáze strong. AlvaoSample na místním SQL serveru. V AM jsou odpovídající nové objekty vytvořeny pod objektem ve stromu s uzlem Id s hodnotou 92.
ImportUtil.exe -input*. aktualizovat_db.csv* -server .\sqlexpress**-db_AlvaoSample_-import** -keyfields*registrační značka
*
Tento příkaz aktualizuje objekty, které mají registrační značku položku, která odpovídá hodnotě v souboru update_db.csv v em>strongrong database. AlvaoSample na místním SQL serveru. In AM properties of identified objects are updated, or non-existent objects are created in the Read Objects folder.
ImportUtil.exe -inputupdate_db.csv -server .\sqlexpress**-db_AlvaoSample_-import** -keyfieldsNodeId
Příkaz aktualizuje hodnoty vlastností objektů podle souboru CSV , jehož NodeId odpovídá hodnotám v souboru CSV.
Chcete-li otestovat funkčnost výše uvedených příkazů, můžete použít ukázkové soubory CSV import.csv a update-db.csv.