Page tree

Skip to end of metadata
Go to start of metadata

You can configure SOAtest settings once and propagate them across the team’s installations. You can also extend or override these settings as needed, such as for machine-specific paths. In this section

Workflow Overview

Implement the following workflow if your organization uses Parasoft Development Testing Platform (DTP) or Parasoft Concerto:

  1. Choose Parasoft> Preferences from a SOAtest desktop installation and configure your settings. 
  2. Export the settings as a localsettings file. The localsettings file is a configuration file with a .properties file extension. 
  3. Add the settings to your team’s DTP or Concerto server.
  4. Connect your SOAtest desktops and/or servers to DTP or Concerto and allow it to automatically configure your SOAtest installations. You can also manually extend or override those settings as needed.
  5. When team-wide preferences need to be updated, update them on the DTP or Concerto. Changes will automatically be propagated to the connected tools.

If your organization does not use DTP or Concerto, you can export the settings configured in one SOAtest installation and import them manually to each desktop installation. For server configurations, use the following command to point to a locally-stored .properties file:

 -localsettings <path/to/file> 

Configuring Preferences in the UI

  1. Choose Parasoft> Preferences and configure the following settings:
  2. Click Parasoft in the sidebar menu to return to the top-level preferences page and click the Share link.

  3. Specify where you want to store the localsettings file and which settings you want to include in the exported file.




  4. Copy the contents of the .properties file to the project or global settings in DTP or Concerto. See the DTP documentation for details.

About Multicast DNS for Concerto Users

Concerto uses multicast DNS to broadcast its services in the local network. This allows SOAtest to automatically detect available Concerto servers, which enables easy configuration. 

  • For Eclipse: In the file <ECLIPSE_INSTALL_DIR>/eclipse.ini, add the line -Dparasoft.jmdns.autoconf.disabled=true
    after the -vmargs parameter.

  • For Visual Studio: In the file <PARASOFT_TEST_INSTALLDIR>/plugins/com.parasoft.xtest.runtime.vstudio.core/parasoft.properties, add the line
    parasoft.jmdns.autoconf.disabled=true

Configuring Preferences on Each Installation

Connect each desktop and/or server SOAtest installation to DTP or Concerto and enable the option to automatically configure SOAtest. See Connecting to Parasoft Development Testing Platform for details. 

Using Preference Settings for Command Line Execution

Using an Existing Locally-stored Localsettings File

For SOAtest server installations, use the following command to point to a locally-stored localsettings file:

-localsettings <path/to/file>

See Configuring Localsettings for details on manually configuring the localsettings file.

Using the Settings Stored on the Concerto Server

Specify -concerto.autoconfig [email protected]:port at the command line if you do not already have a locally-stored localsettings file. For example:

-concerto.autoconfig [email protected]:8080

If you already have a localsettings file and want to import additional settings from Concerto, use the concerto.autoconfig=true option and specify your connection settings. For example: 

concerto.enabled=true
concerto.server=servername
concerto.web.port=8080
concerto.autoconfig=true
general.project=project_name

You can define common properties in Concerto, then configure per-test-run specific properties in various localsettings files for different test runs.

Specifying Multiple Groups of Settings

You can express a hierarchy of localsettings files if you want to use a combination of settings. This enables you to use, for example, core project settings stored on Concerto, test-specific settings associated with the particular machine, and custom settings for a specific set of analyses.

  1. Export each group of settings as a localsettings file using the procedure described in Exporting GUI Preferences to a localsettings File
  2. Use both -concerto.autoconfig  and -localsettings at the command line. For example:
    -concerto.autoconfig [email protected]:8080 -localsettings 
    machine_override_properties -localsettings project_override_properties
    Be sure to list your most general settings first, and your most specific settings last. Settings will be processed in the order in which they are listed; any settings that are duplicated across groups will be overridden each time a duplicate is found.

Updating Team-wide Settings

If you are using this recommended process, you can updated team-wide settings in Parasoft Concerto, then those modifications will automatically be propagated to all the connected machines. 

To prevent this automated updating (e.g., because you have updated settings locally and do not want them overridden), disable Use Concerto settings on the Preferences page(s) you do not want updated from Concerto.

Preference Categories

The following preferences are available in the UI:

Parasoft (Root-Level)

Sets general preferences and allows you to export settings to a localsettings file.

    • Ignore solution and solution folder names in paths: Enables "reduced paths" mode. In this mode—where Parasoft Test uses only reduced (project relative) paths. Names of solution and solution folders will be skipped in these paths. New paths will be unique because project names are unique inside a solution.
    • User name: Allows you to set a different user name than the one specified in the operating system. Parasoft Test uses this user name for code review and Report Center/Project Center settings. The user name specified here can be overwritten at the code review and Report Center/Project Center level.
    • Share/import: See Exporting GUI Preferences to a localsettings File.
Authors

Maps a team member’s automatically-detected username to a different username and/or email address.


See Configuring Task Assignment and Code Authorship Settings.
Code ReviewSpecifies settings for automating the preparation, notification, and tracking of the peer review process. See Code Review.
Configurations

Specifies the number of Test Configurations available in the Parasoft> Test History menu, the location where custom static analysis rules (user rules) are saved and searched for, and the location where user-defined Test Configurations and rules are saved and searched for.

    • Size of recently run test configurations: Determines the number of Test Configurations available in the Parasoft> Test History menu.
    • Custom directories: Indicates where user-defined Test Configurations and  custom directories (e.g., for user rules, embedded cross-compilers, etc.) are saved.
    • Run configuration on save: Tells the product to automatically run the specified Test Configuration each time a source file is saved. This enables fully-automated continuous desktop analysis.
Console

Specifies settings for the Console view.

    • Low: Configures the Console view to show errors and basic information about the current step’s name and status (done, failed, up-to-date).
    • Normal: Adds command lines and issues reported during test and analysis.
    • High: Uses full-format violation listings and also reports warnings.
    • Show console on any change: Determines whether the console is brought to the front any time its content changes
Continuous Testing Platform

Configures your connection to Continuous Testing Platform.

Contact your Parasoft representative for additional information.

Development Testing Platform

Configures your connection to Development Testing Platform.

See Connecting to Parasoft Development Testing Platform.

DictionaryConfigures the language dictionary.
E-mail

Specifies email settings used for report notifications and for sending files to Parasoft Technical Support.

See Configuring Email Settings.

Global Data SourcesSpecifies where the datasources.properties file is saved. See Adding a Data Source at the Test Suite, Project, or Global Level.
Issue Tracking Tags

Specifies custom tags that the team uses to associate a test case with an issue from an issue/feature/defect tracking system (for example, Bugzilla). 

See Using Custom Defect/Issue Tracking Tags.

JDBC Drivers

Specifies JDBC drivers (e.g., drivers needed to connect to a database used for parameterizing tests).

 See Configuring JDBC Drivers.

License

Specifies license settings.

See Licensing.

MIME TypesSpecifies recognized MIME types.
Misc.

Enables you to specify the following settings:

  • Enable/disable tool descriptions in Add Test and Add Output Wizards
  • Enable auto-beautify (formatting) for tools
  • Character encoding
  • Default timeout for connections
  • Duplicate error handling
  • Reset cookies for HTTP sessions
  • Import preferences from a binary file
  • Save settings
  • Automatic backups
ProxySpecifies custom proxy settings. The IDE proxy settings (General> Network) are used by default.
Quality Tasks

Specifies general options related to how tasks are displayed in the Quality Tasks view.

See Configuring Task Reporting Preferences.

Reports

Specifies what reports include and how they are formatted.

See Configuring Task Reporting Preferences.

ScanningSpecifies default user agent, FTP log, and script extensions.
Scope and Authorship

Specifies how code authorship is computed and how tasks are assigned to different team members. 

See Configuring Task Assignment and Code Authorship Settings.

ScriptingSee Extensibility and Scripting Basics.
SecuritySee Configuring for Services Deployed Over HTTPS
ServerSpecifies SOAtest server start-up and port settings. See Deploying the SOAtest and Virtualize Server WAR File.
SOA RegistrySee Using Software AG webMethods with SOAtest and Using Oracle or BEA with SOAtest.
SOAPSpecifies default SOAP settings.
Source Controls

Specifies how Parasoft Test connects to your source control repositories. 

See Connecting to Your Source Control Repository.

System PropertiesSpecifies additional JARs and class folders to add to the classpath.
Technical Support

Specifies options for preparing "support archives" and sending them to the Parasoft support team.

See Preparing a "Support Archive" and Sending it to Technical Support

UDDISpecifies UDDI inquiry endpoint.
WSDL HistoryEnables you to set/reset the WSDL history.
XML ConversionSpecifies data model directories for XML conversion.
XML Schema HistoryEnables you to set/reset the XML schema history.
XML Schema LocationsEnables you to set/reset XML schema namespaces.

Using Variables

You can use the following variables in your preference configuration settings. The session tag value can not contain any colon characters (:). See Configuring Localsettings for additional information about variables.

Using Variable Assist

For help specifying variables, you can use the variable assist feature, which automatically proposes possible variables when you type $. For example:

env_var

This variable specifies the value of an environmental variable. Use a colon followed by the name of a system environment variable before the closing curly brace to output the value of the environment variable. Usage:

${env_var:HOME}

project_name

Outputs the name of the tested project. If more than one project is provided as an input, the name of the project tested is printed followed by an ellipsis (...). Usage:

${project_name}

general_project

It outputs the name of the general Concerto project that results are linked to. Only applies when connected to Concerto. Usage:

${general_project}

workspace_name

Outputs the workspace name or Visual Studio solution name. Usage:

${workspace_name}

config_name

Outputs the name of executed test configuration. Only applies to reports and email settings. Usage:

${config_name}

analysis_type

Outputs a comma separated list of enabled analysis types (for example: Static, Execution). Only applies to reports and email settings. Usage:

${analysis_type}

tool_name

Outputs the name of the tool. Usage:

${tool_name}


Exporting GUI Preferences to a localsettings File

You can export Parasoft Test preferences from the GUI to a localsettings text file. For example, this is useful if you want to:

  • Copy settings into Concerto for team-wide sharing (see Workflow Overview)
  • Quickly create a settings file that you can modify for command-line testing preferences.
  • Share the preferences via source control (rather than via Concerto).
  • Edit preferences in a text file rather than in the GUI.

To export preferences to a localsettings file:

  1. Choose Parasoft> Preferences. The Preferences dialog will open.
  2. Select Parasoft (the root element in the left tree) in the Preferences dialog.
  3. In the top-level Parasoft Preferences page, click the Share link, specify which settings you want to export, then export the settings to a localsettings file.




    • If you select an existing file, the source control settings will be appended to that file. Otherwise, a new file will be created.
    • Exported passwords will be encrypted.

To import these preferences:

  1. Choose Parasoft> Preferences. The Preferences dialog will open.
  2. Select Parasoft (the root element in the left tree) in the Preferences dialog.
  3. Click the Import link, then specify the file where the saved settings are stored, and which settings you want to import:

Overriding the System User Name Outside of the GUI

If you need to override the system user name (e.g., if you are integrating the product into an automated process and do not want the resulting tasks assigned to the default system name), you can do so as follows:

  • Provide the -Duser.name=<username> switch to the Java Virtual Machine

Note that this configuration is the equivalent to modifying the User name setting at the top level of the Preferences UI. 

  • No labels