9.2 npaclexport command (export access permission groups)
Description
This command exports information about the saved access permission groups.
Use this command to export only the information about access permission groups. For example, the npaclexport command is useful if you want to change only the access permission groups when you add users who can reference Operational Contents.
If you want to export information about Operational Contents, see 9.8 npexport command (export Operational Contents).
Note that this command must be executed while the system is running after setup has been completed. Open the command prompt as an administrator.
Format
npaclexportΔ[-iΔpath-of-access-permission-group-name-input-file]Δ[-lΔpath-of-access-permission-group-export-list-file]Δpath-of-export-destination-file
For the path of the export file, specify an absolute path or a relative path consisting of a maximum of 200 characters. The file is output in ZIP format.
Use backslashes (\) for the delimiters. If a path contains a single-byte space, enclose the entire path in double quotation marks ("). In addition to these symbols, the only other symbols permitted in directory paths are single-byte colons (:) and single-byte periods (.) that indicate relative paths.
Options
- -i path-of-access-permission-group-name-input-file
-
Specifies the absolute path or the relative path of the access permission group name input file.
When this option is specified, only the access permission groups whose names are listed in the specified file are exported. If this option is omitted, all access permission groups are exported.
- -l path-of-access-permission-group-export-list-file
-
Specifies the absolute path or the relative path of the access permission group export list file.
When this option is specified, a list of exported access permission groups is output as a text file.
Format of an access permission group name input file
Specify the access permission group names delimited by the end-of-line code. Create the access permission group name input file as a text file. If it is not a text file, an error message (KDCZ10147-E) will be displayed during command execution.
To specify the standard access permissions, specify either the Japanese name or the English name for the standard access permissions.
A character string without any spaces (single-byte or double-byte spaces) before and after each line is imported as an access permission group name. If an access permission group name becomes an empty character string as a result of deleting spaces before and after the line, that line is not imported.
If an EOF code is detected on a line, the character string up to the EOF code is imported as an access permission group name.
Note that comment lines cannot be added (by, for example, using hash marks (#)).
Format of an access permission group export list file
Header information is output at the beginning of the file and then messages are output in the following format:
[result-type]<T>[access-permission-group-name] <T>[access-permission-group-ID]<CR><LF>
<T>: Tab character
<CR><LF>: Termination character (0x0D, 0x0A)
The following table provides the details of the messages.
Item |
Description |
---|---|
Result |
Outputs the execution result of the npaclexport command:
|
Access Permission Group Name |
Outputs the names of the exported access permission groups. |
Access Permission Group ID |
Outputs the IDs of the exported access permission groups. |
The following shows an output example of an access permission group export list file:
Notes:
-
If a file with the same name as the file specified as the output destination already exists in the same directory, an error occurs, in which case the file cannot be exported. Specify a nonexistent file.
-
Do not specify a network drive in a file path.
-
If the amount of disk space available at the export destination is not sufficient for the Operational Contents to be exported, this command terminates abnormally.
Note also that the command uses the folder specified in the TMP or TEMP environment variable as the work folder during execution. Therefore, before you execute the command, make sure that there is enough free disk space for the folder specified in the TMP or TEMP environment variable.
-
Do not use this command when you are using JP1/Base for user authentication, because there are no access permission groups.
Return value
Return value |
Description |
---|---|
0 |
The command terminated normally or terminated with a warning. |
1 |
The command terminated abnormally. |
2 |
A lock error occurred on the command. |
9 |
An execution permission error occurred. |
Example
- Example 1
-
This example exports access permission groups under the following conditions:
-
The path of the export file is C:\work\repository.zip.
-
All access permission groups are to be exported.
> Navigation-Platform-installation-directory\bin\npaclexport C:\work\repository.zip
-
- Example 2
-
This example exports access permission groups under the following conditions:
-
The path of the export file is C:\work\repository.zip.
-
The path of the access permission group name input file is C:\work\accessName.txt.
-
The access permission groups specified in the access permission group name input file are to be exported.
> Navigation-Platform-installation-directory\bin\npaclexport -i C:\work\accessName.txt C:\work\repository.zip
-
- Example 3
-
This example exports access permission groups under the following conditions:
-
The path of the export file is C:\work\repository.zip.
-
The path of the access permission group export list file is C:\work\list.csv.
-
All access permission groups are to be exported.
> Navigation-Platform-installation-directory\bin\npaclexport -l C:\work\list.csv C:\work\repository.zip
-