Hitachi

JP1 Version 12 JP1/Service Support Configuration and Administration Guide


jssitemimportEx (imports extended Item information)

Organization of this page

Description

This command registers new Item information in the Item management database of JP1/Service Support. The command can also register the Item information that you output to CSV files by using the jssitemexportEx command in the JP1/Service Support database.

When you execute the jssitemimportEx command, the command checks whether the contents of all the extended Item information entries files in the specified input source folder are correct. If the contents of the files are correct, the command starts registering the Item information in the Item management database. If any of the extended Item information entries files contains improper data, the command does not register the Item information in the files.

Format

jssitemimportEX -i input-source-folder-name
                {-ALL | -s -id system-ID | -p -id process-work-board-ID}
                [-latest]

Required execution permission

Administrator permissions

Storage folder

JP1/SS-path\bin\

Arguments

-i input-source-folder-name

Use a character string consisting of 80 bytes or less to specify the name of the folder containing extended Item information entries files. Count half-width characters as 1-byte each and full-width characters as2-bytes each. You can use an absolute path or a relative path to specify the folder name. When you use a relative path, make sure that it will be 80 bytes or less after it is converted to an absolute path. Note that UNC paths cannot be specified.

The input source folder must have the same configuration as the output destination folder specified for the jssitemexportEx command. Also, make sure that the format of the file used as the input source of Item information (Item information CSV file, related information CSV file, or attached file#) is the same as described in the section of the jssitemexportEx command. You need to observe the file naming conventions for Item information CSV files and related information CSV files.

#

A file of extended Item information entries is a generic term for Item information CSV files, related information CSV files, and attached files.

For details about the format of the input source files and the configuration of the folder to which the jssitemexportEx command outputs the files, see jssitemexportEx (exports extended Item information) in Chapter 12. Commands. For further details about the format of Item information CSV files, related information CSV files and attached files, and naming conventions for the files, see File for extended Item information entries (Optional) in Chapter 13. Definition Files.

-ALL

Registers the Item information in all systems including the master system.

-s id system-ID

Registers the Item information in a selected system. For system-ID, use 1 to 64 half-width alphanumeric characters.

-p -id process-work-board-ID

Registers the Item information in a selected process work board. For process-work-board-ID, use 1 to 64 half-width alphanumeric characters.

-latest

Registers only the latest Item information (the data type is Most recent) specified by the -i option. The command does not register the information about escalation when the -latest option is specified.

Return values

Return value

Meaning

0

Normal end

1

The command failed while registering Item information.

2

The command failed before registering Item information.

Body items in an Item information CSV file

Some items in the body section of an Item information CSV file are mandatory. For details about the list and descriptions of items in an Item information CSV file, see File for extended Item information entries (Optional) in Chapter 13. Definition Files.

When you create an Item information CSV file (from which you can register Item information into the Item management database), you can omit the header section, the first line (attribute name) in the body section, and the footer section.

Body items in a related information CSV file

All the items in the body section of a related information CSV file are optional. The header section is also optional. For details about the list and description of items in a related information CSV file, see File for extended Item information entries (Optional) in Chapter 13. Definition Files.

Prerequisites for executing the command

Remarks

Example

The following example shows how to register the Item information from all systems in C:\tmp in the Item management database. The Item information (from all systems) was previously output to C:\tmp by using the jssitemexportEx command.

jssitemimportEx -i c:\tmp -all