jssaclexport (exports access-permission information)
- Organization of this page
Description
This command outputs the access-permission information and information about the initial person in charge of status set for each process work board to a CSV file.
Format
jssaclexport -o access-permission-information-file-name {-ALL | -s -id system-ID | -p -id process-work-board-ID} [-f]
Required execution permission
Administrator permissions
Storage folder
JP1/SS-path\bin\
Arguments
-o access-permission-information-file-name
For access-permission-information-file-name, use 255 bytes or less to specify the name of the file to which access permission information and information about the initial person in charge of status is to be output. Count half-width characters as 1-byte each and full-width characters as 2-bytes each. 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 is 255 bytes or less after it is converted to an absolute path. Note that you cannot specify a character string that begins with a hyphen (-) for the file name.
-ALL
Outputs the access-permission information and information about the initial person in charge of status in all systems including the master system.
-s -id system-ID
Outputs the access-permission information and information about the initial person in charge of status in a selected system. For system-ID, use 1 to 64 half-width alphanumeric characters.
-p -id process-work-board-ID
Outputs the access-permission information and information about the initial person in charge of status in a selected process work board. For process-work-board-ID, use 1 to 64 half-width alphanumeric characters.
-f
Overwrites the files in the output destination folder.
If the access-permission information file specified with the -o option does not exist, a file with the specified name is created. If the -f option is omitted when the access-permission information file specified with the -o option exists, the processing finishes without outputting the access-permission information file.
Return values
Return value |
Meaning |
---|---|
0 |
Normal end |
1 |
Abnormal end |
Contents of an access-permission information file
An access-permission information file contains data in the following format.
The first line in the body section in an access-permission information file lists the attribute names.
The following details the contents of an access-permission information file.
- Header section
-
Output sequence
Header item
Value
1
Product name
JP1/Service Support
2
Version number of the access-permission information file
The version number of the file is indicated by 6 digits.
3
Character encoding used in the access-permission information file
Character encoding of output files
4
Type of data that is output to the access-permission information
ACLEXPORT
- Body section
-
Output sequence
Body item
Description
1
System ID of target system
ID of the system for which access permissions are set
2
Process work board ID
ID of the process work board that has the process for which access permissions are set
3
User/Role ID type
Type that indicates either the user ID or role ID
-
For user ID: USER
-
For role ID: ROLE
4
User/Role ID
User ID or role ID
5
Access permissions
All access permissions and initial persons in charge of status the user or role has#
Table 12‒7: Access permissions that can be output Output sequence
Output value
Description
1
CREATE
New item permission for the Item
2
EDIT
Edit item permission for the Item
3
REFER
View item permission for the Item
4
DELETE
Delete item permission for the Item
5
ESCALATE
Escalation permission for the Item
6
APPROVE
Acknowledge item permission for the Item
7
CLOSE
Close item permission for the Item
8
ST_INQUIRY
Edit item permission for the Item that is in Received status
9
ST_INQUIRY_DEF
Edit item permission for the Item that is in Received status, and the initial person in charge of Received status
10
ST_RESEARCH
Edit item permission for the Item that is in Investigating status
11
ST_RESEARCH_DEF
Edit item permission for the Item that is in Investigating status, and the initial person in charge of Investigating status
12
ST_PLANNING
Edit item permission for the Item that is in Planning status
13
ST_PLANNING_DEF
Edit item permission for the Item that is in Planning status, and the initial person in charge of Planning status
14
ST_DISCUSSING
Edit item permission for the Item that is in Discussing status
15
ST_DISCUSSING_DEF
Edit item permission for the Item that is in Discussing status, and the initial person in charge of Discussing status
16
ST_APPROVED
Edit item permission for the Item that is in Acknowledged status
17
ST_APPROVED_DEF
Edit item permission for the Item that is in Acknowledged status, and the initial person in charge of Acknowledged status
18
ST_WAITING
Edit item permission for the Item that is in Support Requested status
19
ST_WAITING_DEF
Edit item permission for the Item that is in Requested status, and the initial person in charge of Requested status
20
ST_REVIEW
Edit item permission for the Item that is in Reviewing status
21
ST_REVIEW_DEF
Edit item permission for the Item that is in Reviewing status, and the initial person in charge of Reviewing status
22
ST_CLOSE
Edit item permission for the Item that is in Close status
23
ST_CLOSE_DEF
Edit item permission for the Item that is in Close status, and the initial person in charge of Close status
24
ST_USER01 to ST_USER40
Edit item permission for the Item for which the status of Extended status 01 to Extended status 40 is set
25
ST_USER01_DEF to ST_USER40_DEF
Edit item permission for the Item for which the status of Extended status 01 to Extended status 40 is set, and the initial person in charge of the status of Extended status 01 to Extended status 40
-
Sort order of access-permission information (body section)
Access-permission information is output in the following sort order:
-
System ID: Ascending order
-
Process ID#1: Ascending order
-
User/Role ID type#2: Descending order
-
User/Role ID: Ascending order
- #1
-
If there are multiple process in a system, they are sorted and output in the following order. Note that process names are the default names.
-
Incident management
-
Problem management
-
Change management
-
Release management
-
- #2
-
The access-permission information for roles is output, and then the access-permission information for users is output. However, information about the master system (temporary receipt process work board) is output at the end.
If access permissions are set for the jp1admin user and system roles, the access-permission information is output. However, information about the access permissions for which system roles are set by default is not output. For details about the system roles, see the description about the system roles in 3.17.2 Role management.
Differences in the result of the command depending on the statuses of the system and process work board
The jssaclexport command acts differently depending on the statuses of the system and process work board. The following table describes the differences in the result of the jssaclexport command depending on the statuses of the system and process work board.
No. |
Status of the system |
Status of the process work board |
Result |
---|---|---|---|
1 |
Waiting to be deleted |
-- |
The command does not output the access-permission information and information about the initial person in charge of status in the system. |
2 |
Operating |
In process |
The command outputs the access-permission information and information about the initial person in charge of status in the process work board. |
3 |
Operating |
||
4 |
Under suspension |
||
5 |
Waiting to be deleted |
The command does not output the access-permission information and information about the initial person in charge of status in the process work board. |
Prerequisites for executing the command
-
For details about the status of services when commands are executed, see Status of services when commands are executed in Chapter 12. Commands.
Remarks
-
If you cancel the jssaclexport command by using Ctrl+C while the command is being executed, access permission information might not be output. For this reason, do not use Ctrl+C to cancel the command during execution. If you happen to do so, wait for a while, and then re-execute the command.
-
If the jssaclexport command stops due to an error while it is being executed, the contents of the output file might be incomplete.
-
If you change access permissions set for a process work board while the jssaclexport command is being executed for that process work board, the access-permission information might not be output. For this reason, we recommend that you execute the command after you place the target process work board in Under suspension status.
-
The jssaclexport command can output a maximum of 1,000,000 lines (number of lines in the body section, excluding the first line for attribute names) of access-permission information at one time. If the maximum number of lines is exceeded, review and modify the conditions for outputting access-permission information, and then re-execute the command.
Example
The following example shows how to output the access-permission information for all systems to the access-permission information file (c:\accesspermission\accesspermissioninfo.csv):
jssaclexport -o c:\accesspermission\accesspermissioninfo.csv -ALL