Changing preferences
Much of Rational® Integration Tester behavior can be customized in the application preferences.
To view or modify these preferences, select Rational® Integration Tester menu bar.
or in the mainGeneral
General preferences control the behavior of Rational® Integration Tester on the whole, as follows:
Preference | Description |
---|---|
Run Resources | Controls how test resources are executed. From disk (saved) executes the last saved version of the resource. From memory (current) executes the resource in its current state, including any unsaved changes. If Auto save on run is enabled (when From disk is in use), test resources are saved automatically when executed. |
Prompt for Suite Run Archive Policy | If this option is selected, you are prompted to use a suite archive policy on the results from any suite that you run. |
Display prompt on exit | Asks the user to confirm whether to exit Rational® Integration Tester. |
Show header information panels in editors | In message editors, displays a description panel in the headers area (once you are more familiar with Rational® Integration Tester, they can be disabled to save screen space). |
Show Tag Data Store with editors | Displays the Tag Data Store automatically whenever a message editor is opened. |
Show project name in title bar | Toggles the display of the current project name in the Rational® Integration Tester title bar. |
Default Run Tests action to parallel execution | Select this option if you want the Run process in parallel option in the Run Test dialog to be selected by default. |
Run Button Mode (Removed in version 9.0.1) | Controls the behavior of the Run button and F5: Run Selected always runs the selected test resource; Run Last Launched always runs the test resource that was executed last. |
URL Connection Timeout | Specifies a default timeout to use for connections in test actions. |
Maximum Preview Rows | The maximum number of rows to display in previews (for example, when you are importing a WSDL). |
Maximum filtered message logs | Specifies the maximum number of messages to log when you are using a filter on a message. To log all messages, enable the Log All option. |
Maximum dependencies shown | Specifies the maximum number of dependencies to display at one time in the Architecture School Logical View. |
Tooltip display time (secs) | Specifies the amount of time (in seconds) that tooltips are displayed when the cursor rests on an applicable icon. If left empty or if an invalid entry is set, the default value (that is, four seconds) is used. If set to zero, tooltips are not displayed at all. |
Synchronization Filter | Specifies a filter that ignores certain items that are found
within a synchronization source (currently applies to only TIBCO BusinessWorks
projects). The filter string can be modified as needed. Click Reset
filter to restore the default value, which ignores .svn and .cvs folders
(that is, for projects in SVN or CVS repositories). |
Sort Method | Specifies the strength of the sorting method
used when sorting items based on the locale in several places in
Rational® Integration Tester, such as the providers in Library Manager and the item trees
in Test Lab and Test Factory. The following methods are available:
|
Look and feel
Use the Look and Feel preferences to specify which fonts to use throughout Rational® Integration Tester and the color to be used for highlighting null fields in data sources. Fonts could be fixed width or proportional.
Preference | Description |
---|---|
Fonts | Provides combination lists for selecting an available fixed width or proportional system font
and the size of the font, to use in Rational®
Integration Tester. Below
each selection is a Sample field that displays a sample of text in the
selected font. You can now select the size of the font as required. Note:
The size of the font is fixed in the Logical View of the Architectural School as you have an option to zoom in and out. |
Colors | Controls the Color for null values option. Specifies the color to use for highlighting fields
that are treated as null when you preview the contents of a file or Excel data source. For more
information, refer to Test data sources in Related concepts. To change the current color, click it and select a new color by using the Select color dialog that is displayed. |
Server Settings
Server settings preferences control default behavior when servers are specified.
Preference | Description |
---|---|
Show server URL validation failed dialog | This option is checked when you specify URLs for Rational® Test Control Panel, Rational® Test Automation Server, and for the project results server configured in the project settings window. If you select this option and either URL fails validation, a dialog is displayed. |
Rational® Test Automation Server Offline Token | The offline token generated from the Rational® Test Automation Server is copied in this field. This token enables Rational® Integration Tester to connect to the Rational® Test Automation Server and access the secrets contained in the secrets collections that can be deployed in test runs and publish test reports to the Rational® Test Automation Server. For more information about offline tokens, see Accessing Rational Test Automation Server. |
Git
You can configure the Git preferences so that the project test assets can be accessed from Rational® Integration Tester. For more information, refer to Setting preferences for Git in Related tasks.
Schema
Schema preferences control how Rational® Integration Tester works with schemas, as follows:
Preferences | Description |
---|---|
Analysis Settings | Controls the default selections to use for schema analysis, which can be overridden during analysis. For more information, refer to Analyzing schemas in Related concepts. |
Cache | Displays the number of files that are currently stored in Rational® Integration Tester schema cache, as well as the caches current size. To clear the cache (for example, to save disk space), click the Clear button. |
Rebuild when saving resource | Controls how Rational® Integration Tester rebuilds referenced schemas when it saves resources (for example, a SOAP message). |
Schema Library | Specifies whether to save schemas automatically (that is, when you are clicking away from the schema after you finish making changes). |
Record Layouts | Controls the appearance of grouping rows in record layouts. You can change the background color and the color of the text that is used in such rows. For more information, refer to Record Layouts in Related concepts. |
Message
With Message preferences, you can enable or disable default options to be applied when you are working with messages, as described in the following table.
Preference | Description |
---|---|
Message Expansion Level | The number of levels of a message to expand in editors (used only when the editor is opened for the first time). A value of 0 expands all nodes in the message. |
Enable initial interesting node expansion | Controls which fields are expanded by default.
If selected, Rational®
Integration Tester only expands what are considered interesting
nodes. If not selected, Rational®
Integration Tester expands all nodes. Rational® Integration Tester determines what is interesting, depending on the context. For case action, stub input action, consumer actions (subscribe,
receive request, receive reply), and producer actions (publisher,
send request, send reply) , the following nodes are considered interesting:
For the message differencing window, the following
nodes are considered interesting:
|
Content | Default settings to use when you are creating
messages:
|
Assert | Default validation options when you are creating
a message:
|
Message Import | Option to handle imported messages:
|
Console
Console preferences control the appearance and behavior of the output console in the Test Lab.
Preference | Description |
---|---|
Success color |
Controls the colors that are used to indicate message status
in the console. By default, green is used for success messages, red
is used for errors, blue is used for information, and orange is used
for warnings. To modify the default colors, click an existing color and select a new one in the Select color dialog. |
Retain message context data | Enables or disables the selection of console output (where validation errors occur) to invoke the message comparison tool. |
Enable debugging output | Enables or disables debug messages in the console when you are running a test. When enabled, more details of the various actions that are processed in the test are provided. |
Action Prefix | Determines whether the Technical or Business view descriptions are displayed in the console for test step action names. |
Console Caching | When enabled, users can specify that console output for no more than the selected number of tests be cached by Rational® Integration Tester. Caching is disabled if no results database provider is specified. |
Stub default log level | Levels include:
|
Recording
Recording preferences control various aspects of the recording process in the Recording Studio.
Preference | Description |
---|---|
Sequence Numbering | Two numbering options are available:
|
Database Recording | If you are recording from a database resource
and the stub information in the database definition is incomplete,
you have the following options:
|
Simulation Data Editing | You have the following options for editing a
virtual database when the associated stub is running:
|
Transport Specific Recording | You can set two preferences:
|
Message Comparison
Message comparison preferences control the appearance and behavior of the Message Differences window.
Preference | Description |
---|---|
Colors | Controls the colors that are used to indicate difference types or ignored nodes. To modify a selected color, click it and select a new one in the Select color dialog. |
Reset to Color Scheme | Click one of the buttons to set all colors to the Pastel or Vibrant scheme. |
Navigation | Controls whether looping is enabled in the Message Differences window. If Do not loop when navigating differences is enabled, the Next difference and Previous difference buttons are disabled when the last or first difference is selected. In that case, you cannot loop back to the beginning or end of the differences. If this option is cleared, the buttons are always enabled and they loop to the beginning or end of the message to view the next or previous difference. Both buttons are disabled if there are no differences between the messages. |
Always retain the rules | Sets the default behavior when you are overwriting an expected message (that is to repair a validation failure) that uses validation rules. For more information, refer to Overwriting messages that use validation rules in Related concepts. |
Always apply changes without prompting | If you select this option, changes that are made to the expected message in the Message Differences window are applied without prompting when the window is closed. If disabled, the user is prompted to save and apply changes, discard any changes, or cancel the action and return to the window. |
Always keep repairs | While the Message Differences window is open, you can edit the message in the Test Factory perspective. If you do, a message about unsaved changes is displayed when you close the Message Differences window. You can avoid this message by selecting the Always keep repairs preference. |
Test Editor
Test Editor preferences control the display color for missing business view descriptions, the rendering of comments within a test, and the behavior of the test or stub action editor (inline or pop up).
Preference | Description |
---|---|
Missing business descriptions color | Controls the color to use for a test name or test step that is not customized in the Business View. To modify the default color, click the existing color and select a new one in the Select color dialog. |
Render comments as HTML 2.0 | Controls whether the text within new comment actions are rendered as HTML, by default. You can override this feature on a per-comment basis when such actions are created. |
Restart resources automatically | If you select this option and you edit a stub that is currently running, the stub is restarted automatically when you save your changes. |
Action Editor Settings | The following settings are available:
|
Subscriber Settings | The following settings are available:
|
Virtualization
Virtualization preferences control the pass-through options for the available transport types.
Preference | Description |
---|---|
Transports | The following setting is available:
|
Pass Through | Double-click a row in the table to display the Pass Through action to be taken
for the associated transport type. For more information about these actions, refer to
Configuring transports in Related concepts.
Not all options are available for all transports. |
Applications
You can specify custom application associations for various file extensions. Click Add to enter a new association and provide the following information:
Field | Description |
---|---|
File Extension | Enter the file extension characters (such as XML) that you want to associate with an application. |
Program List | Select this option if you want to choose the associated program from the displayed list. Highlight the program in the list. |
Launch Command | Select this option if the program you want is not displayed. You must provide a full path to the executable program in the Command field. |
Options are available to Delete a highlighted association or to Edit the fields in the table for a highlighted association.
EDIFACT
If you use the United Nations Electronic Data Interchange For Administration, Commerce, and Transport (EDIFACT), you have the following preference available:
Preference | Description |
---|---|
Schema Processing | The following setting is available:
|
SOAP
SOAP preferences control the default options in the Field Properties dialog for SOAP messages.
Preference | Description |
---|---|
SOAP Version | Select the default SOAP version (1.1 or 1.2) to apply in the Field Properties dialog. |
SOAP Headers | Controls whether SOAP headers are enabled by default in the Field Properties dialog. |
Byte Arrays
If you use byte arrays, you can set the following preferences:
Preference | Description |
---|---|
Encoding | The following character encoding systems are available:
|
New Line | You can set the newline character to any of the following options:
|
Copybook
Copybook preferences control the default behavior for handling Copybook schema files.
Preference | Description |
---|---|
Schema Processing | Specify the Start Column and End Column values for each line of the schema. |
File Serialization | The following Encoding values are available:
|
Processing Properties | The following settings are available:
|
Files
The following preference is available for controlling file access:
Preference | Description |
---|---|
Default Retry Interval | The number of milliseconds that Rational® Integration Tester should wait before retrying file access. |
WS-* Extensions
Preferences are available for web services addressing and web services security.
Preference | Description |
---|---|
WS Addressing | If you select the Enable by default option, the WS-Addressing transport-neutral mechanisms are enabled by default in the Field Properties editor for SOAP messages. |
WS Security | If you select the Enable by default option,
the WS-Security communications protocol is enabled by default in the
Field Properties editor for SOAP messages. If you enable WS-Security, you can select the Enable milisecond precision for timestamps option to increase the granularity of the timestamp tokens within WS-Security. |
XML
These preferences control the default options that are used when you process XML.
Preference | Description |
---|---|
File Serialization | The following setting is available:
|
Processing Properties | The following settings are available:
|
XML Name Matcing | The following settings are available:
|
Message Editing Preview | The following settings are available:
|
(see Record layouts.)