1.6.6 importservicetemplate (importing one or more service templates)
Description
This command adds one or more service templates to JP1/AO. Adding service templates to JP1/AO is called importing of service templates.
You can execute the command with a single service template package or a zip file in which multiple service template packages are archived to import the specified service template package into JP1/AO.
Syntax
importservicetemplate /file service-template-package-or-zip-file-in-which-multiple-service-template-packages-are-archived /user user-ID {/password password | /passwordfile password-file-path}
Arguments
- /file service-template-package-or-zip-file-in-which-multiple-service-template-packages-are-archived
This option specifies the absolute or relative path to the service template package to be imported or zip file in which multiple service template packages are archived.
- /user user-ID
This option specifies the user ID for JP1/AO.
The number of possible characters is in the range from 1 to 256 characters.
The possible characters are half-width alphanumeric characters, !, #, $, %, &, ', (, ), *, +, -, ., =, @, \, ^, _, and |.
This option is not case sensitive.
- /password password
This option specifies the password of the user indicated by the user option.
You must specify either this option or the passwordfile option. If both options are specified, or if neither are specified, then you will get an error.
The number of possible characters is in the range from 1 to 256 characters.
The possible characters are the same as those for the user option.
- /passwordfile password-file-path
This option specifies the absolute or relative path to the file that stores the password of the user specified in the user option.
You must specify either this option or the password option. If both options are specified, or if neither are specified, then you will get an error.
Located in
- In Windows:
JP1/AO-installation-folder\bin
- In Linux:
/opt/jp1ao/bin
JP1/AO-installation-folder\bin
Execute permission
Execute the command as a user with both the Admin or Develop role and Administrator or root permissions for the OS. If a user without Administrator or root permissions executes the command, a message appears asking the user to elevate the permission level.
Remarks
-
When the command imports a zip file in which multiple service template packages are archived, the command continues processing even if some of the service template packages cannot be imported. Messages inform you of the service template packages that could not be imported. If such messages are displayed, check the messages, correct the causes of the failures, and then re-import the relevant service template packages.
-
If an External Resource Provider with the same UUID as the External Resource Provider defined in the service template to be imported already exists, the existing External Resource Provider is overwritten with the content of the External Resource Provider defined in the service template when the template is imported.
Return code
The following table lists the return codes from the command.
Return code |
Description |
---|---|
0 |
The command succeeded. |
1 |
The argument is invalid. |
2 |
The command execution has been interrupted. |
3 |
The service status is invalid. |
4 |
One of the other commands is running. |
5 |
Communication failed. |
6 |
Authentication failed. |
7 |
An invalid path is specified. |
9 |
The specified path does not exist. |
14 |
You do not have permission to execute the command. |
180 |
Importing the service template failed. |
255 |
The command terminated abnormally. |
Example
The following examples show how to use the command for each case.
To import, in Windows, the specified service template package (C:\temp\aaa.st) into JP1/AO:
importservicetemplate /file C:\temp\aaa.st /user user1 /password pass1
To import, in Windows, a zip file (C:\temp\bbb.zip) in which the specified multiple service template packages are archived into JP1/AO:
importservicetemplate /file C:\temp\bbb.zip /user user1 /password pass1