qacli validate config

Manage the configuration of the Perforce QAC project within Validate.

Usage

validate config  {-c|-u|-d|-s|-a <ENABLE|DISABLE>|-D <ENABLE|DISABLE>|-S <ENABLE|DISABLE>|-f <ROOT|RELATIVE|ABSOLUTE>} [-P <directory>] [-U <[protocol://]host:port>] [-b <Validate project/stream>] [-r <REPLACE|UPDATE|MERGE>] [--] [-h]

Extended Description

Perforce QAC project configuration is stored on the Validate ‘connected’ project. This command allows that configuration to be stored (push) and retrieved (pull) and synced i.e. the pulling of the RCF.

Perforce QAC project configuration is stored on the Validate ‘connected’ project. This command allows that configuration to be stored (push) and retrieved to an existing Perforce QAC project (pull), synced i.e. automatic or manual the pulling of the RCF. A Perforce QAC project can also be created from a Validate project.

All commands, except --create, must have previously set up a link to a Validate project. See qacli validate connect for more details.
Configuration data cannot be stored in a Validate stream. It will be stored in the parent project.

Options

Name, shorthand Default Description
‑‑auto‑sync‑diags, ‑D ENABLE Automatically synchronize diagnostics from the Validate 'connected' project/stream.
‑‑auto‑sync‑suppressions, ‑S ENABLE Automatically synchronize suppressions from the Validate 'connected' project/stream.
‑‑auto‑sync, ‑a ENABLE Automatically synchronize the RCF from the Validate 'connected' project, before every analysis.
‑‑create, ‑c   Create a local Perforce QAC project from the previously stored Validate project/stream, then connect both projects.
‑‑path‑format, ‑f  

Specify how paths are translated before upload. There are three possible values:

  • ROOT: A root variable is embedded at the start of the path
  • RELATIVE: Paths are converted relative to the project directory
  • ABSOLUTE: Paths are converted to their absolute value
You should avoid changing the path type for Validate projects that already contain results, as this could cause diagnostic matching to fail.
‑‑pull, ‑d   Pull and use the Perforce QAC project configuration from the Validate 'connected' project/stream.
‑‑push, ‑u   Push the Perforce QAC project configuration into the Validate 'connected' project/stream.
‑‑qaf-project, ‑P  

Specify a path to a valid Perforce QAC project to act upon.
‑‑rcf‑update‑method, ‑r  

When synchronizing the RCF this option specifies how the RCF is imported. Choose one of:

  • MERGE : Merge rules from both local and the incoming RCF (Default).
  • REPLACE: Replace RCF with the incoming RCF from Validate.
  • UPDATE: Update RCF, replacing mappings for existing components.
‑‑sync, ‑s   Synchronize the RCF from the Validate 'connected' project/stream.
‑‑url, ‑U   URL of the Validate server. By default the http protocol is assumed. Examples include; localhost:80, 127.0.0.1:8080, https://prometheus:8888
‑‑validate‑project, ‑b   Name of the Validate project/stream to use when creating a Perforce QAC project whose configuration is stored on Validate.
‑‑help, ‑h   Displays usage information and exits.
‑‑ignore‑rest, ‑‑   Ignores the rest of the labeled arguments following this flag.

Examples

Send a Perforce QAC Configuration into a Connected Validate Project

To push a Perforce QAC configuration, from a project (in the current directory) to an existing connected project on the Validate server, issue a command such as:

qacli validate config -P . ––push

All the configuration files for the Perforce QAC project will be now stored in the Validate project.

Create a Perforce QAC Project from a Connected Validate Project

To push a Perforce QAC configuration, from a project (in the current directory) to an existing connected project on the Validate server, issue a command such as:

qacli validate config -P local_project --create --url http://validate_server:8080/ --validate-project validate_project

A new Perforce QAC project will be created in the specified location, pulling its configuration from the Validate project.

Retrieve and Use a Perforce QAC Configuration from a Connected Validate Project

To create a Perforce QAC project from an existing project on the Validate server, issue a command such as:

qacli validate config -P . --pull

All the configuration files for the Perforce QAC project that are stored in the Validate project will now be retrieved and used.

Retrieve and Use Configuration (RCF) from a Connected Validate Project

To synchronize configuration (RCF), into an existing Perforce QAC project (in the current directory) from an existing connected project on the Validate server, issue a command such as:

qacli validate config -P . --sync

The RCF for the Perforce QAC project, stored in the Validate project will be merged with the local RCF. Other merge methods are available, for example to replace the local RCF with the RCF from the Validate project:

qacli validate config -P . --sync --rcf-update-method REPLACE

Disable the Automatic Synchronization of the RCF Before Analysis

To disable the synchronization of the RCF from Validate before analysis begins then set the option to DISABLE (or ENABLE to enable it):

qacli validate config -P . –-auto-sync DISABLE

Only the local RCF will be used during analysis.