Search and Replace: Action List Dialog

Required Edition

Professional, Automation, Enterprise Automation

The Search and Replace: Action List dialog allows you to create, modify, and test actions for the search and replace transform. It is accessible using one of the following methods:

Click next to the Search and Replace option on the Transforms tab of the Data Sources property page.
Click next to the Search and Replace option on the Human Readable property page.

The following options are available:

Actions List

The Actions list is located on the left hand side of the Search and Replace: Action List dialog. This is a list of all the search and replace actions that will be performed. Each action consists of text to be searched for, directions to insert, replace, or delete that text, and the search method to be used. It is also possible to specify the code page to be used. The actions in the list are performed in the order they appear, and each action makes a complete pass through the trigger file before continuing with the next action.

Below the list are buttons for maintaining the actions list:

Inserts a new action into the list.

Removes the selected action from the list.

Removes the selected action from the list, but places a copy of the action on BarTender's clipboard.

Copies the selected action into BarTender's clipboard.

Pastes a copy of the action on BarTender's clipboard into the action list.

Moves the selected action up one position in the list.

Moves the selected action down one position in the list.

Each of these commands can also be accessed from the Actions list's context menu.

Import and Export

The Actions list, containing the list of actions and their configurations, can be transferred between installed instances of BarTender. To save the current locations in an XML file, select Export and browse to the desired destination directory. Once saved, the XML file can be loaded into another instance of BarTender using the Import option.

Action Options

The Action Options section of the Search and Replace: Action List dialog defines the configuration for the selected action in the Actions list.

Description: Specifies the name that identifies the selected action.
Action: Specifies the action to be performed.
Search for: Specifies the text to search for in the selected data source. The icon allows you to enter non-typable characters into the search field.
Syntax: Specifies how the search for the text in the Search Text field will be conducted. Available options include Literal, Regular Expression, and Wildcard.
First Occurrence Only: When enabled, specifies that the action is performed only on the first occurrence of the search text.
Replace with: Specifies the text that will replace the Search Text in the selected data source. The icon allows you to enter non-typable characters into the replace field.
Insert: Specifies the text that will be inserted before or after the Search Text in the selected data source. The icon allows you to enter non-typable characters into the insert field.

Test: Opens the Test Action List dialog, which allows you to test the list of actions and confirm they behave as desired. Using this dialog, you can specify the location of a sample file containing the data in the data source and export the file to a destination file. The actions will be performed in the order that they appear in the Actions list.

Related Topics

Using Search and Replace in BarTender