Adding a Run Connector Modifier

Run Connector Modifiers are saved changes to PROIV connection details held in a Recording. Any of the details can be modified including the host name. This means that Recordings made in one environment can be used to run Tests or Suites in other environments, making Tests highly portable and reusable. Run Connector Modifiers also serve to future-proof Recordings, if, for example, a machine name changes in your environment, you can modify the Run Connector to connect to the new name. They can be tailored to connect to new environments or configured to cope with changes with connection settings.

Run Connector Modifiers, Tests and Suites

Run Connector Modifiers can be associated with Tests and Suites in a variety of ways:

Click here to see a screenshot for further explanation.

Click here to see a screenshot for further explanation.

Click here to see a screenshot for further explanation.

To discover where Run Connector Modifiers are used in PROIV Assure, use the Locating Where Items are Used utility.

 

To add a Run Connector Modifier, follow these steps:

  1. Click Admin Options Admin options icon on the PROIV Assure Toolbar. Alternatively, select the Admin option from the PROIV Assure Menu.

  2. Select the Run Connector Modifiers option.

  3. The Run Connector Modifiers window appears.

Fields on the Run Connector Modifiers window:

Item

Description

Column Headings

 

Connector Name

Displays Run Connector Modifier's name.

System

Displays the Session Type.

Host/IP Address

Displays the host details or IP address used by the Run Connector Modifier.

Port

Displays the port used by the Run Connector Modifier.

Buttons

 

Add

Click Add to create a Run Connector Modifier.

Delete

Click Delete to delete a Run Connector Modifier. You are prompted before the deletion occurs.

Properties

Click Properties to maintain the Run Connector Modifier details. The Recording Connector Details window appears, which shows the information that you can amend as appropriate.

OK

Click OK to save the Run Connector Modifier details and to close the Run Connector Modifiers window.

  1. Click Add to create a new Recording Connector. The Add New Connector window appears.

  2. Enter a name for the Recording Connector in the Connector Name field.

  3. Click OK to close the Add New Connector window.

  4. The Run Connector Modifier Details window appears.

The displayed fields on the Run Connector Modifiers Details window are dependent on the Session Type that is selected, i.e. Windows or UNIX. Consequently, you will notice that there are more fields enabled when a UNIX Session Type is selected. Note that the Session Type for a Run Connector Modifier is not mandatory, as you may want the connection to be determined by the Recording's connection details, hence all connection options are available to configure and none are made mandatory. Leaving a field blank on the Run Connector Modifiers Details window results in the Recording connection settings being used. If you make an entry in a field, then this will override the Recording connection settings for that option. Furthermore, if you select the Set to Blank check box for a field, this explicitly blanks the Recording's settings and configures the setting to NULL. Run Connector Modifiers do not hold full connection details, so the connection details cannot be tested in the same way as the Recording Connectors.

Fields on the Run Connector Modifiers Details window:

Item

Description

Session Type

Select a Session Type that determines the connection type you want the service to establish with the PROIV application server. The selection made in the drop-down list determines which fields are enabled on this screen.

Windows

Selecting this option specifies Telnet processing and no auto-login.

UNIX

Selecting this option specifies Telnet processing and auto-login on a UNIX platform.

A32 - Non-Mandatory

Host/IP Address

The IP address or system name of the machine where the PROIV application server is installed.

A32 - Non-Mandatory

Port

The port which the PROIV application server listens to for connections. The default values are 23 on UNIX and 6023 on Microsoft Windows.

N4 - Non-Mandatory

PROIV User Name

The user name used at login. If you use Microsoft Windows, the user name is used for the PROIV login process. If you use UNIX, the user name is used to log onto the UNIX operating system, not PROIV.

A32 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Password

The password used at login. If you use Microsoft Windows, the password is used for the PROIV login process. If you use UNIX, the password is used to log onto the UNIX operating system, not PROIV.

A32 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Success Prompt

The string to search for to indicate that the login has been successful. Applicable for UNIX operating systems. This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Failure Prompt

The string to search for to indicate that the login has failed. Applicable for UNIX operating systems. This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Login Prompt

Specify the login prompt for the operating system. The default entry is 'login:' This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Password Prompt

Specify the password prompt for the operating system. The default entry is 'password:' This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A10 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Command

Command to be run on the host machine once logged in. The default command is ./runproiv.sh. This field is disabled if the Session Type is set to Telnet with No Host Login (Windows).

A250 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Xfer in

Passes parameters to the PROIV session at start up.

A250 - Non-Mandatory

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Image Paths

By default, Assure picks up the application images which are set in the OpenClient; however, the image path mentioned in this box will overwrite the default path.

Template Page

A template page is used to reference Cascading Style Sheets which control the look and feel of the rendered widgets (for example icons, objects, etc.)

You do not have to enter a template page name in the field as Open Client will search the resource paths for the default template page, index.html. If the file is located, it will be used. It references two CSS files; PROIVFixedStyle.css and PROIVDefaultStyle.css which control the look and feel of the rendered application.

Warning: Do not change the contents of the PROIVFixedStyle.css and PROIVDefaultStyle.css as any updates released by PROIV will overwrite your changes.

You can also create your template page which must be called index.html and must be placed in the root of your folder under the appResources folder. The Open Client loads its own CSS files, but properties in these files may be overridden by properties in your CSS files.

A250 - Non-Mandatory

Upload Maximum

Sets the maximum upload size for the file send and receive process. The send and receive process in Open Client requires user interaction, it is not a transparent process. Therefore, when a file is required by the PROIV Virtual Machine, a message box appears which prompts the user to locate the file and manually upload it to PROIV.  To avoid the system bottlenecks, it is advisable to set an upload file size limit to prevent users from uploading huge files.

N10 - Non-Mandatory

Calendar Control

Check to enable standard Windows Calendar Control for input of dates. This is enabled on a global basis and does not require any application changes. You can select or deselect this option only when disconnected from PROIV.  Once a connection is active, you cannot change the setting; the box and the text are greyed out, but the check is still visible in the box. The default setting for the option is disabled.

Select the Set to Blank check box to explicitly blank the Recording's settings and configure the setting to NULL.

Test Connection

Click Test Connection to test the connection.

Buttons

 

Reset

The Reset appears when the Test or Suite is configured to Prompt for Connector Details? flag set. The resets the connection details to the original connection details.

OK

Click OK to save the Recording Connector details and to close the Recording Connector Details window.

Cancel

Click Cancel to cancel the process and to close the Recording Connector Details window.

  1. Click OK to save the Recording Connector details and to close the Recording Connector Details window.

  2. Click OK to close the Recording Connectors window.

Comment on this topic

Topic ID: 780014