Synopsis
fcli ssc appversion list [--q-param=<qParam>] [-e=<values>[,<values>…]]… [--embed=<embedSuppliers>[,<embedSuppliers>…]]… [-i=<values>[,<values>…]]… [[-h] [--env-prefix=<envPrefix>] [--log-file=<logFile>] [--log-level=<logLevel>]] [[--ssc-session=<sessionName>]] ] [--style=<outputStyleElements>_[, <outputStyleElements>…]]… ] [--to-file=<outputFile>_]] [-q=<SpEL _ _ expression>]
Description
By default, this command simply lists all application versions. However, the --embed, --query and --output options allow for implementing advanced use cases. Some examples:
List application versions created by user 'admin': -q 'createdBy=="admin"'
List application versions requiring refresh: -q 'refreshRequired'
List application versions with artifacts requiring approval: -q 'currentState.attentionRequired'
List application versions with business risk 'High':
--embed attrValuesByGuid -q 'attrValuesByGuid["BusinessRisk"].contains("High")'
Generate script for purging all application versions:
-o 'expr=fcli ssc appversion purge-artifacts --older-than 30d {id}\n'
Options
- -e, --exclude=<values>[,<values>…]
-
Exclude versions that either have no results, or no issues assigned to the current user. Allowed values: empty, no-assigned-issues.
- --embed=<embedSuppliers>[,<embedSuppliers>…]
-
Embed extra application version data. Allowed values: attrs, attrValuesByName, attrValuesByGuid, bugtracker, customTags, filterSets, folders, resultProcessingRules.
- -i, --include=<values>[,<values>…]
-
List either active (default), inactive, or both active and inactive versions. Allowed values: active, inactive.
- -q, --query=<SpEL expression>
-
Only display records for which the given Spring Expression Language (SpEL) expression returns true.
- --q-param=<qParam>
-
Server-side queries are automatically generated from the -q / --query option if possible; generated queries can be viewed in the debug log. The --q-param option can be used to override the automatically generated query, for example to further optimize the request. See SSC REST API documentation for information on supported formats.
SSC session name options
- --ssc-session=<sessionName>
-
Name of the SSC session to use for executing this command. Default value: default.
Output options
- -o, --output=type[=<args>]
-
Specify output type and optional type arguments. Available output formats: csv, table, expr, json, xml, yaml. The 'expr' output format takes a string containing '{property}' placeholders, other output formats take an optional, comma-separated list of properties to include in the output.
- --store=variableName[:<propertyNames>]
-
Store the JSON results of this command in a variable. Variables can be managed through the 'fcli util variable' command, and can be referenced using ::variable::[property] on any subsequent command.
- --style=<outputStyleElements>[,<outputStyleElements>…]
-
Comma-separated list of style elements to apply to the selected output format. Allowed values: header, no-header, pretty, no-pretty, flat, no-flat, array, single, border, no-border, md-border.
- --to-file=<outputFile>
-
Write command output to the specified file instead of stdout.
Generic fcli options
- --env-prefix=<envPrefix>
-
Environment variable prefix for resolving default option and parameter values. Default value is FCLI_DEFAULT.
- -h, --help
-
Show this help message and exit. Use 'fcli <command> -h' to display help for subcommands.
- --log-file=<logFile>
-
File where logging data will be written. Defaults to fcli.log in current directory if --log-level is specified.
- --log-level=<logLevel>
-
Set logging level. Note that DEBUG and TRACE levels may result in sensitive data being written to the log file. Allowed values: TRACE, DEBUG, INFO, WARN, ERROR.