5.2.11 Request Operation Commands

Command Name: fscsm_request

Format

fscsm_request delete {-requestId | -date end-date} [-force]

fscsm_request export [-start start-date] [-end end-date] -dir output-directory

Description: Deletes a submitted request. This command also outputs request information as a file.

Subcommands

delete {-requestID requestID | -date end-date } [-force]

Deletes submitted requests.

It is necessary to specify either requestID or end-date.

In requestID, specify the ID of the request to be deleted.

In end-date, specify the most recent submission date of the target requests in the format, YYYY-MM-DD. Requests that were submitted on or before the specified date will be deleted.

-force can be omitted. When specified, all the corresponding requests will be deleted regardless of their statuses.

When omitted, the requests whose status is Waiting Processing will not be deleted, while the requests whose status is Approved, Rejected, Cancelled, or Failed will be deleted.

export [-start start-date] [-end end-date] -dir output-directory

Outputs submitted requests as a file.

In start-date, specify the start date of the target period for which requests are to be obtained, in the format, YYYY-MM-DD. When omitted, the oldest submission date of the existing requests is regarded as the start date.

In end-date, specify the end date of the target period for which requests are to be obtained, in the format, YYYY-MM-DD. When omitted, the date on which the command is executed is regarded as the end date.

In output-directory, specify the folder to which the file is to be output. This parameter cannot be omitted.

Specify the folder name using a character string containing alphanumeric characters, hyphens ("-"), and underscores ("_").

When the specified file already exists, an error occurs. Before executing this command, create an empty folder and specify it as the output folder. When the specified folder does not exist or is not empty, an error will occur. Specify an absolute path or a relative path.

File Name and Output Content

The file name should be in the following format:

<Submission date>_<Request ID>_<Target resource>_<Operation>.xml

In <Target resource>, one of the following is specified:

Target Resource	Specified Value
Organizations	org
Users	user
Project management	project
Menus	menu
Platforms	platform
Services	service

In <Operation>, one of the following is specified:

Operation	Specified Value
Addition	register
Modification	modify
Deletion	delete

For details on the format of the file, refer to "5.3.7 Request Information".

Example

When deleting a request with request ID "123" which is under request
```
>fscsm_request delete -requestId 123 -force<RETURN>
```
When deleting approved, rejected, canceled, or failed requests which were submitted on or before March 31, 2014
```
>fscsm_request delete -date 2014-03-31<RETURN>
```
When outputting the requests that were submitted in the period from December 1, 2015 to December 31, 2015 as a file
```
>fscsm_request export -start 2015-12-01 -end 2015-12-31 -dir .\usertmp\201512<RETURN>
```

Information

Request output files can be used for the following purposes:

For use as past operation logs by periodically outputting requests as files
To confirm detailed information, such as the approvers of a request, that are not recorded in audit logs