jssitemimport (imports Item information)
- Organization of this page
Description
This command registers new Item information in the Item management database of JP1/IM - Service Support.
Format
jssitemimport -i Item-information-entries-file-name -r registrant-ID [-f] [-m code-mapping-file-name]
Required execution permission
Administrator permissions
Storage folder
IM-SS-path\bin\
Arguments
-i Item-information-entries-file-name
Use a character string consisting of 255 bytes or less to specify the name of an Item information entries file. Count two bytes for full-width characters in the file name. You can use an absolute path or a relative path to specify the file name. When you use a relative path, make sure that it will be 255 bytes or less after it is converted to an absolute path. For the file name, you cannot specify a character string beginning with a hyphen (-). For details about Item information entries files, see File for Item information entries (Optional) in Chapter 12. Definition Files.
-r registrant-ID
Use 64 or less half-width alphanumeric characters to specify the user ID of the person who registers the Items.
An error occurs in the following cases:
-
No user with the specified ID exists.
-
The user with the specified ID does not have the permission to register Items in the target process work board.
-f
Continues processing even if some of the data in the Item information entries file is incorrect. If you specify the -f option, the command continues processing even if the information about an Item in the Item information entries file is improper and proceeds to register the information about the next Item.
If you do not specify the -f option and the command fails to register the information about a single Item in the Item information entries file, the processing is canceled and all Item information will not be registered.
-m code-mapping-file-name
Use a character string consisting of 255 bytes or less to specify the name of the code mapping file when you use a user-defined code mapping file. Count two bytes for full-width characters in the file name. You can use an absolute path or a relative path to specify the file name. When you use a relative path, make sure that it will be 255 bytes or less after it is converted to an absolute path.For details about code mapping files, see Code mapping file (jp1imss_itemimport_codemap.conf) in Chapter 12. Definition Files.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end |
Prerequisites for executing the command
-
For details about which services need to be active or inactive when this command is executed, see Status of services when commands are executed in Chapter 11. Commands.
-
While the jssitemimport command is being executed, do not execute other JP1/IM - Service Support commands.
-
For the jssitemimport command options, specify only the elements that appear in the windows. Although all the elements you specify in the Item information entries file are registered in the Item management database, you cannot check them unless they appear in the windows.
Remarks
-
If you cancel the jssitemimport command while it is being executed, none of the Item information you specify in the Item information entries file will be registered in the Item management database.
-
If you cancel the jssitemimport command by using Ctrl+C while the command is being executed, the Item information specified in the Item information entries file might not be registered in the Item management database. For this reason, do not cancel the command during execution by using Ctrl+C. If you happen to do so, wait for a while and then re-execute the command.
-
If you specify an empty Item information entries file, the command will end normally without importing any Item information into the Item management database.
-
If the user or the role specified for the ID of the person in charge of an Item or the ID of the person in charge of reply does not exist, a KNAB22002-W error message or a KNAB26013-E error message will appear. If so, check and, if necessary, revise the Item information entries file. For details about Item information entries files, see File for Item information entries (Optional) in Chapter 12. Definition Files.
-
The update date and time specified in the Item information entries file are not registered in the JP1/IM - Service Support database. Instead, the date and time when the jssitemimport command is executed are registered in the JP1/IM - Service Support database.
-
If you specify 103 or more elements in the Item information entries file, only the first 102 elements are registered in the Item management database. Elements 53 to 102 are optional. If you omit any of elements 53 to 102, empty elements are registered in the Item management database.
-
If the number of elements specified in the Item information entries file is less than 52, a KNAB26103-E error message will appear.
-
If the Item information entries file contains large quantities of Item information, the work area in the Item management database might run short or the log files of the Item management database might run short. If that occurs, a KNAB24002-E error message with detailed code -722 or -1703 will appear. Reduce the number of elements of Items in the Item information entries file, and then re-execute the jssitemimport command.
The guideline for the total number of elements of Items you can enter in the Item information entries file is as follows depending on the size of the Item management database.
-
For the size-S database: Approximately 2,000 elements
-
For the size-M database: Approximately 5,000 elements
-
For the size-L database: Approximately 5,000 elements
-
For the size-LL database: Approximately 5,000 elements
-
For the size-XL database: Approximately 5,000 elements
-
-
When you use the jssitemimport command, you can register an Item without specifying the mandatory elements that you must enter when you register an Item or when the status of an Item is Close.
-
Make sure that the input file you specify is created with a character encoding that is compatible with the system locale of the machine on which JP1/IM - Service Support is installed. The character encodings that can be used are as follows:
-
In a Japanese environment: MS932
-
In an English environment: ISO-8859-1
-
In a Chinese environment: GB18030
-
Example
The following example shows how to register Item information in the Item management database by using an Item information entries file (c:\Item\Itemimport.csv).
jssitemimport -i c:\Item\Itemimport.csv -r user0001