17.11  ioutils importtemplate (importing a template)

When importing asset information, you can use a template that defines field mappings. This section describes the ioutils importtemplate command to be used to import the template.

Functionality

This command imports previously exported templates. The files you can import are only previously exported templates. You can provide a template name to register. If you do not specify a name, a template is registered with the name from a previous export.

If you have multiple JP1/IT Desktop Management 2 systems configured, this command enables a template created on one management server to be reused on another management server.

Execute this command on a management server.

Format

ioutils importtemplate -import import-file-name[ -name template-name][ -s]

Argument

-import import-file-name

Specify the absolute path (within 259 bytes) of the XML file to import.

-name template-name

Specify a template name to import. If this argument is omitted, the template name from a previous export will be used.

-s

Overwrites the file even if a template with the same file name already exists. If this argument is not specified and a template with the same file name already exists, an overwrite confirmation message appears. In this case, the system cancels the input or overwrites the file according to the administrator's reply.

Storage location

JP1/IT Desktop Management 2-installation-folder\mgr\bin\

You can execute this command without specifying the storage location for the executable file, by using the command prompt provided by JP1/IT Desktop Management 2.

Notes

• Execute this command when the management server setup is completed and the management server is running.

• This command cannot be simultaneously executed by multiple users.

• This command cannot be executed simultaneously with any of the following commands:

  • exportdb

  • importdb

  • ioassetsfieldutil export

  • ioassetsfieldutil import

  • ioutils exportasset

  • ioutils exportassetassoc

  • ioutils exportdevice

  • ioutils exportdevicedetail

  • ioutils exportfield

  • ioutils exportfilter

  • ioutils exportoplog

  • ioutils exportpolicy

  • ioutils exporttemplate

  • ioutils exportupdategroup

  • ioutils exportupdatelist

  • ioutils importasset

  • ioutils importassetassoc

  • ioutils importexlog

  • ioutils importfield

  • ioutils importfilter

  • ioutils importpolicy

  • ioutils importupdategroup

  • ioutils importupdatelist

  • reorgdb

  • startservice

  • stopservice

  • updatesupportinfo

  • deletenwgroup

  • deletepackage

  • distributelicense

Return value

The following table shows the return values of the ioutils importtemplate command.

Return value	Description
0	The command finished normally.
11	The format for specifying the command arguments is invalid.
12	The specified folder is invalid, the disk does not have sufficient capacity, or the folder does not exist.
31	Another command is being executed.
51	You do not have the permissions to execute this command.
54	The management server has not been set up.
74	An invalid template name is specified.
80	The format of the file being imported is invalid.
101	Command execution failed because there is not enough memory, or due to some other reason.
120	A database access error occurred.
150	Command execution was interrupted due to some other error.

Example

The following example shows use of this command to import a previously exported template file called assetexport.xml in C:\temp\, as a hardware asset information template named "hardware asset information template1".

ioutils importtemplate -import C:\temp\assetexport.xml -name "hardware asset information template1" -s

Related Topics:

• 17.1 Executing commands

To Page Top