Access privileges input file (Optional)
- Organization of this page
Description
This file contains access-permission information that is used to set for JP1/IM - Service Support. This file must be created in CSV format. To set access-permission information in this file for JP1/IM - Service Support, execute the jssaclimport command.
Format
# comment (Linefeed)
"system-ID","process-work-board-ID","User/Role-ID-type","User/Role-ID","access-permission","access-permission",... (Linefeed)
"system-ID","process-work-board-ID","User/Role-ID-type","User/Role-ID","access-permission","access-permission",... (Linefeed)
:
:Lines starting with a hash mark (#) are treated as comments.
- Legend:
-
(Linefeed): Indicates a linefeed character.
File name
Use any file name.
Storage folder
Any folder on the host where the jssaclimport command is executed
When the definition is applied
When you execute the jssaclimport command, the definition is applied to JP1/IM - Service Support.
What is described
Specify access-permission information in the order shown in the following table.
|
Specification order |
Element name |
Specifiable characters |
Specifiable number of bytes |
Specify or not |
|---|---|---|---|---|
|
1 |
System ID |
Half-width alphanumeric characters |
1 to 64 bytes |
Y |
|
2 |
Process work board ID |
Half-width alphanumeric characters |
1 to 64 bytes |
Y |
|
3 |
User/Role ID type |
Either USER or ROLE. Case insensitive |
-- |
Y |
|
4 |
User/Role ID |
Half-width alphanumeric characters |
1 to 64 bytes |
Y |
|
5 |
Access permission |
Half-width alphanumeric characters |
-- |
|
- Legend:
-
--: Because the value you can specify is already determined, the value itself is the specifiable number of bytes.
Y: Elements you must specify
![[Figure]](GRAPHICS/ZUENG020.GIF)
: Elements to specify if necessary
Each line contains access-permission information that can be set for a process work board. Each element of access-permission information is enclosed by double quotations ("), and separated by a comma (,). Note that you can specify multiple access permissions. To specify multiple access permissions, separate each access permission by a comma (,).
Specifiable values for an access permission
The following table lists and describes the values that can be set for access permissions.
|
Specifiable value#1 |
Description |
|---|---|
|
CREATE |
New item permission for Items |
|
EDIT |
Edit item permission for Items |
|
REFER |
View item permission for Items |
|
DELETE |
Delete item permission for Items |
|
ESCALATE |
Escalation permission for Items |
|
APPROVE |
Acknowledge item permission for Items |
|
CLOSE |
Close item permission for Items |
|
ST_INQUIRY#2 |
Edit item permission for Items that are in Received status |
|
ST_RESEARCH#2 |
Edit item permission for Items that are in Investigating status |
|
ST_PLANNING#2 |
Edit item permission for Items that are in Planning status |
|
ST_DISCUSSING#2 |
Edit item permission for Items that are in Discussing status |
|
ST_APPROVED#2 |
Edit item permission for Items that are in Acknowledged status |
|
ST_WAITING#2 |
Edit item permission for Items that are in Support Requested status |
|
ST_REVIEW#2 |
Edit item permission for Items that are in Reviewing status |
|
ST_CLOSE#2 |
Edit item permission for Items that are in Close status |
|
ST_USER01 to ST_USER40#2 |
Edit item permission for Items for which a status among Extended status 01 to Extended status 40 is set. |
- #1
-
Case insensitive when access permissions are set.
- #2
-
When you set access permissions for Items in a specified status, you can set a status used in the process work board.
To delete access permissions set for a user or role in the target process work board, set nothing for the access-permission elements (all access permissions are deleted as a result). When you add or change access permissions (including deletion of a part of access permissions), set all new access permissions. The access-permission element "" is ignored.
Notes
-
A maximum of 1,000,000 lines are allowed in the access privileges input file (excluding comment lines). If you want to set access-permission information that exceeds 1,000,000 lines, divide the access privileges input file and apply the contents of the divided files separately.
-
If you set the same access-permission information multiple times for a target, an error occurs.
-
If two or more lines have exactly the same values for system-ID, process-work-board-ID, User/Role-ID-type, and User/Role-ID, only the bottom-most written line becomes valid.
-
The Access privileges input file must be created or edited with a character encoding that is compatible with the system locale of the machine on which JP1/IM - Service Support is installed. You can use one of the following character encodings:
-
In a Japanese environment: MS932
-
In an English environment: ISO-8859-1
-
In a Chinese environment: GB18030
-
Definition examples
Definition example 1
- Adding new access permissions
-
The following definition example adds new access permissions for user0001 and role0001 in process work board pwb0001 in system0001:
"system0001","pwb0001","USER","user0001","CREATE","REFER","ST_INQUIRY" "system0001","pwb0001","ROLE","role0001","REFER","CLOSE","ST_APPROVED","ST_CLOSE"
In this case, the following access permissions are newly registered:
-
Access permissions that are set for user0001
New item permission for Items, View item permission for Items, and Edit item permission for Items that are in Received status
-
Access permissions that are set for role0001
View item permission for Items, Close item permission for Items, Edit item permission for Items that are in Acknowledged status, and Edit item permission for Items that are in Close status
-
Definition example 2
- Changing access permissions
-
The following definition example changes access permissions set for user0002 in process work board pwb0001 in system0001:
"system0001","pwb0001","USER","user0002","REFER","CLOSE"
In this case, access permissions are changed as follows:
-
Access permissions that were set for user0002
New item permission and View item permission for Items
-
New access permissions for user0002
View item permission and Close item permission for Items
-
Definition example 3
- Deleting access permissions
-
The following definition example deletes access permissions set for user0003 in process work board pwb0001 in system0001:
"system0001","pwb0001","USER","user0003"
In this case, access permissions are deleted as follows:
-
Access permissions that were set for user0003
New item permission and View item permission for Items
-
New access permissions for user0003
None
-