...
| Table of Contents | ||
|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Implement the following workflow if your organization uses Parasoft DTP:
...
-localsettings <path/to/file>
Configuring Preferences in the UI
- Choose Parasoft> Preferences and configure the following settings:
- E-mail, see Configuring Email Settings.
- License, see Licensing.
- DTP, see Connecting to DTP.
- Team Server, see Connecting to Parasoft Team Server.
- Source control, see Connecting to Your Source Control Repository.
- Authors, see Specifying Author-to-Author and Author-to-Email Mappings.
- Any additional settings you want to share. See Configuring SOAtest Across TeamsPreference Configuration Basics for details.
- Click Parasoft in the sidebar menu to return to the top-level preferences page and click the Share link.
Specify where you want to store the localsettings file and which settings you want to include in the exported file.
Copy the contents of the .properties file to the project or global settings in DTP. See the DTP documentation for details.
| Note | ||
|---|---|---|
| ||
DTP uses multicast DNS to broadcast its services in the local network. This allows SOAtest to automatically detect available DTP servers, which enables easy configuration. In the file <INSTALL>/eclipse.ini, add the line |
Configuring Preferences on Each Installation
Connect each desktop and/or server SOAtest installation to DTP and enable the option to automatically configure SOAtest. See Connecting to DTP for details.
| Anchor | ||||
|---|---|---|---|---|
|
You can specify the preference settings stored in a file or allow DTP to auto-configure your settings.
| Anchor | ||||
|---|---|---|---|---|
|
For SOAtest server installations, use the following command to point to a locally-stored localsettings file:
...
See Configuring Localsettings for details on manually configuring the localsettings file.
Using the Settings Stored on DTP
Specify Use the -dtp.autoconfig project_name@servername:port at the command line if you do not already have a locally-stored localsettings file. For example: flag and specify the DTP project, host, and port to allow DTP to auto-configure your settings. This enables you to configure your tool without pointing to a settings file. For example:
| Code Block | ||
|---|---|---|
| ||
-dtp.autoconfig [email protected]:8080 |
If you already have a localsettings file and want to import additional settings from DTP, use the dtp.autoconfig=true option and specify your connection settings. For example:
...
You can define common properties in DTP and 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 configure several localsettings files if you want to use a combination of settings. This enables you to use, for example, core project settings stored on DTP, test-specific settings associated with the particular machine, and custom settings for a specific set of analyses.
- Export each group of settings as a localsettings file using the procedure described in Configuring SOAtest Across TeamsExporting GUI Preferences to a localsettings File
Use both
-dtp.autoconfigand-localsettingsat the command line. For example:Code Block language powershell -dtp.autoconfig [email protected]:8080 -localsettings machine_override_properties -localsettings project_override_properties
Be sure to list your Specify the 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 DTP, 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 DTP settings on the Preferences page(s) you do not want updated from DTP.
| Anchor | ||||
|---|---|---|---|---|
|
The following preferences are available in the UI:
...
Parasoft (Root-Level) | Sets general preferences and allows you to export settings 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. |
| Browser | Specifies which browser executables to use for web testing. See Browser Settings. |
| 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.
|
| Console | Specifies settings for the Console view.
|
| Continuous Testing Platform | Configures your connection to Continuous Testing Platform. Contact your Parasoft representative for additional information. |
| DTP | Configures your connection to DTP. See Connecting to DTP. |
| Dictionary | Configures the language dictionary. |
Specifies email settings used for report notifications and for sending files to Parasoft Technical Support. | |
| Global Data Sources | Specifies where the datasources.properties file is saved. See Adding a Data Source at the Test Suite, Project, or Global Level_soa. |
| 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, BugzillaJira). |
| JDBC Drivers | Specifies JDBC drivers (e.g., drivers that are needed to connect to a database used for parameterizing tests). |
| License | Specifies license settings. See Licensing. |
| MIME Types | Specifies recognized MIME types. |
| Misc. | Enables you to specify the following settings:
|
| Proxy | Specifies 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. |
| Reports | Specifies what reports include and how they are formatted. The value used for the Session Tag field cannot contain colon characters (:). See Configuring Report Reporting Settings |
| Scanning | Specifies 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 |
| Scripting | See Specifies additional scripting languages you can use in Scripting Tools. See Extensibility or Scripting Basics. |
| Security | Specifies settings for allowing the tool to connect to secure applications. See Configuring for Services Deployed Over HTTPS |
| Server | Specifies SOAtest server start-up and port settings. See Parasoft Virtualize Server WAR File Deployment. |
| SOAP | Specifies default SOAP settings. |
| Source Controls | Specifies how Parasoft Test connects the connection to your source control repositories. |
| System Properties | Specifies 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. |
| UDDI | Specifies UDDI inquiry endpoint. |
| WSDL History | Enables you to set/reset the WSDL history. |
| XML Conversion | Specifies data model directories for XML conversion. |
| XML Schema History | Enables you to set/reset the XML schema history. |
| XML Schema Locations | Enables 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 (:)Some preferences, such as the report settings, enable you to use variables. This enables you to dynamically define outputs, such as report names or report metadata. See Configuring Localsettings for additional information about variables.
| Info | ||||
|---|---|---|---|---|
| ||||
For help specifying variables, you can use the variable assist feature, which automatically proposes possible variables when you type
|
| Scroll Table Layout | ||
|---|---|---|
|
| 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:
|
|---|---|
| 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:
|
| general_project | It outputs the name of the general DTP project that results are linked to. Only applies when connected to DTP. Usage:
|
| workspace_name | Outputs the workspace name or Visual Studio solution name. Usage:
|
| config_name | Outputs the name of executed test configuration. Only applies to reports and email settings. Usage:
|
| analysis_type | Outputs a comma separated list of enabled analysis types (for example: Static, Execution). Only applies to reports and email settings. Usage:
|
| tool_name | Outputs the name of the tool. Usage:
|
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:
...