5.2.2 User Operation Commands

Command Name: fscsm_user

Format

fscsm_user create -file input-file

fscsm_user modify -file input-file

fscsm_user delete -userId userID

fscsm_user export [-orgId organizationID | -userId userID] -file output-file

fscsm_user import [-check result-file] -file input-file

fscsm_user list [-orgId organizationID]

Description

Performs addition, modification, deletion, batch addition, batch modification, and output of user information.

This command also checks the user information of files to be added.

Subcommands

create -file input-file

Adds user information.

In input-file, enter the name of the file containing the user information to be added. For details on the format of the file, refer to "5.3.2 User Information".

modify -file input-file

Modifies user information. Only the information of a single user can be modified at one time.

In input-file, enter the name of the file containing the user information to be modified. For details on the format of the file, refer to "5.3.2 User Information".

delete -userId userID

Deletes user information.

In userID, specify the ID of the user to be deleted.

export [-orgId organizationID | -userId userID] -file output-file

Outputs user information as an XML file.

organizationID and userID can be omitted. However, it is possible to narrow down the target user information by specifying either one of them.

In organizationID, specify the organization ID. To narrow down to the users belonging to operators and planners, specify "!mgr". In userID, specify a user ID.

In output-file, specify the file name using a character string containing alphanumeric characters, hyphens ("-"), underscores ("_"), and periods ("."). For details on the format of the file, refer to "5.3.2 User Information".

When the specified file already exists, an error occurs.

import [-check result-file] -file input-file

Performs batch addition and modification of user information.

If -check result-file is specified, only the consistency check of the XML format, description format, and organization information of the user information to be added or modified is performed. To perform batch addition or modification, omit this parameter. If -check is omitted, when a failure of addition or modification is detected, the subsequent processes are not performed.

In result-file, enter the name of the file to which the check results will be output. If specified, the results of the check of input-file are output to the specified file.

In input-file, enter the name of the file containing the user information to be added or modified as a batch. For details on the format of the file, refer to "5.3.2 User Information". If the specified user information has not been added in Cloud Services Management, the information will be added. If the specified user information has been added already, the information will be modified to the specified content.

If -check result-file is specified, the results of the check will be output in the following format:

"userId, orgId, Result(Create/Modify/NotExist/Error)"

Create: New addition
Modify: Modification
NotExist: The information is not in the input file but has been added in Cloud Services Management.
Error:message: When there are errors in the input content, the error details are displayed using messages beginning with fscsm. For details and corrective actions, refer to "FUJITSU Software Cloud Services Management Messages".

If -check result-file is not specified, batch addition and modification will be performed. Execution results are output as files with the following names in the log folder:

fscsm_user_import_mmddhhmmss.log 
(mmddhhmmss: The month, date, hour, minute, and second when the command was executed)

Execution results of batch addition and modification are output in the following format:

"userId, orgId, Result(Create/Modify/NotExist/Error)"

Create: New addition
Modify: Modification
NotExist: The information is not in the input file but has been added in Cloud Services Management.
Error:message: When there are errors in the input content, the error details are displayed using messages beginning with fscsm. For details and corrective actions, refer to "FUJITSU Software Cloud Services Management Messages".

list [-orgId organizationID]

Displays the added user information in a prompt window.

-orgId organizationID can be omitted. If specified, only the information of the users belonging to that organization will be output. If not specified, the information for all users will be output. To narrow down to the users belonging to operators and planners, specify "!mgr".

The following items are displayed in ascending order of user ID. For users with multiple roles, role IDs are displayed separated by commas (",").

User ID
User name
Organization ID
Role ID

Example

When adding user information

>fscsm_user create -file adduser.xml<RETURN>

When modifying user information

>fscsm_user modify -file upduser.xml<RETURN>

When deleting the user information with user ID user-6
```
>fscsm_user delete -userId user-6<RETURN>
```
When outputting the user information of A Unit (Organization ID is 101) as a file
```
>fscsm_user export -orgId 101 -file userdata_A.xml<RETURN>
```

When outputting the user information with user ID user-6 as a file

>fscsm_user export -userId user-6 -file userdata_user-6.xml<RETURN>

When outputting all user information as a file

>fscsm_user export -file userdata_ALL.xml<RETURN>

When outputting the user information of A Unit (organization ID 101) to the screen

>fscsm_user list -orgId 101<RETURN>
userId         username        orgId      roleId
------------------------------------------------------------------------------
user-1         Ichiro_Fujitsu  101        bizSysProv_manager
user-2         Jiro_Fujitsu    101        bizSysProv_manager
user-3         Saburo_Fujitsu  101        bizSysProv_user

When outputting all user information to the screen

>fscsm_user list<RETURN>
userId         userName        orgId      roleId
------------------------------------------------------------------------------
user-1         Ichiro_Fujitsu  101        bizSysProv_manager,operation_manager
user-2         Jiro_Fujitsu    101        bizSysProv_manager
user-3         Saburo_Fujitsu  101        bizSysProv_user
user-b1        Taro_Fuji       !mgr       operation_manager

Information

For users belonging to operators and planners, the orgId is displayed as "!mgr".

Each role name corresponds to the following user type:

planEval_manager	Planners - Approver
planEval_user	Planners - Representative
operation_manager	Operators - Approver
operation_user	Operators - Representative
operation_admin	Operators - Administrator
bizSysProv_manager	Platform Providers - Approver
bizSysProv_user	Platform Providers - Representative