Synopsis

fcli ssc appversion list [--q-param=<qParam>] [-e=<values>[,<values>…​]]…​ [--embed=<embedSuppliers>[,<embedSuppliers>…​]]…​ [-i=<values>[,<values>…​]]…​ [[-h] [--env-prefix=<prefix>] [--log-file=<logFile>] [--log-level=<logLevel>] [--log-mask=<level>] [--debug]] [[--ssc-session=<sessionName>]] [[-o=<type+args>] [--style*=<style>,…​]…​ ] [--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 (also see documentation link below)

-o, --output=<type+args>

Select output type (csv, table, expr, json, xml, yaml) and optional type arguments.

--store=<var>[:<prop>]

Store JSON results in an fcli variable for later reference.

*--style*=<style>,…​

Select output style: header, no-header, pretty, no-pretty, flat, no-flat, array, single, border, no-border, md-border.

--to-file=<outputFile>

Write output to the specified file.

Generic fcli options (also see documentation link below)

--debug

Enable collection of debug logs.

--env-prefix=<prefix>

Prefix for resolving default option values. Default value: FCLI_DEFAULT.

-h, --help

Use 'fcli [command] -h' to display help for fcli (sub-)commands.

--log-file=<logFile>

Write log output to file. Default: ./fcli.log if logging is enabled.

--log-level=<logLevel>

Set logging level: TRACE, DEBUG, INFO, WARN, ERROR, NONE.

--log-mask=<level>

Log mask level: high, medium, low, none. Default: medium. Masking is done on a best-effort basis; no guarantee that all sensitive data will be masked.