Naming Rules

Naming rules

Naming rules let you specify replacement characters for invalid characters and set prefixes Studio will use when naming interrogated objects. To define naming rules, choose Pega Robot > Naming Rules from the Options dialog (choose Tools > Options).

The Naming Rules options are listed under these option nodes:

Invalid characters
Type prefixes

Invalid characters

The Invalid Characters option lets you add or remove a character to use in place of an invalid character. An invalid character is any character that cannot be used by Studio when naming matching targets. For example, when interrogating webpage objects, the tag name of the target may include an apostrophe ('). This character is invalid in Studio object names. If you set a replacement string for the apostrophe (such as Apos), then Studio uses the replacement string rather than the actual character when adding the target as an object to the solution.

Use the Invalid Characters – Replacement String table available from the Options dialog: Pega Robot> Naming Rules > Invalid Characters option. These functions are available:

Add – Use this button to add a new invalid character. When you click Add, a new line is inserted in the table. Enter the invalid character and its replacement string. Click OK to save the new entries.
Max Name Length – Use this field to specify the maximum length of object names that Studio creates when you interrogate targets. For example, some web application objects have very long tag names, for example: Fed_Ex_Rates_and_Transit_ Times_Form_Table. If the Max Name Length is less than 15, you will receive an error when interrogating this object. Setting the value higher lets you capture targets with long names.
Remove – Highlight the row containing the invalid characters and replacement string and click the Remove button to delete the naming rule.

Type prefixes

The Type Prefixes option lets you specify a prefix for common interrogated controls. For example, when interrogating a label in a Windows application, you can set the Type Prefix such that the prefix is: lb. In this case, the prefix lb is applied to the control name.

Use the Type Name – The prefix table available from the Options dialog's Pega Robot> Naming Rules > Type Prefixes option. These buttons are available:

Add – Click this button to add a prefix. To add a prefix, perform these steps:
1. Click Add. The Get Type Name from Type window is displayed.
2. Select the type of object that you want to select. The type name of your selection is displayed in the field to the right.
3. Click OK. The name is added in the list in the Type Name - Prefix table.
4. Click OK on the Options dialog to save your new prefix.

Remove – Highlight the row containing the Type Name and Prefix and click the Remove button to delete the naming rule.