Open topic with navigation

Use the Search and Replace dialog to create, modify, and test actions for the search and replace transform. You can access this dialog by 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 side of the Search and Replace 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. You can also 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.

The following options are available:

Inserts a new action into the list.

Removes the selected action from the list.

Removes the selected action from the list and places a copy of the action on the Clipboard.

Copies the selected action to the Clipboard.

Pastes a copy of the action that is on the 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.

Import and Export

The Actions list, which includes the list of actions and their configurations, can be transferred between installed instances of BarTender. To save the current locations in an XML file, click Export , and then browse to the destination directory that you want. After you save the XML file, you can load it into another instance of BarTender by using the Import option.

Action Options

The Action Options section of the Search and Replace 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. To enter non-typable characters into the search field, click the icon.

• Syntax: Specifies how the search for the text in the Search Text field is conducted. Available options include Literal, Regular Expression, and Wildcard.

• First Occurrence Only: Specifies that the action is performed only on the first occurrence of the search text.

• Replace with: Specifies the text that replaces the search text in the selected data source. To enter non-typable characters into the search field, click the icon.

• Insert: Specifies the text that is inserted before or after the search text in the selected data source. To enter non-typable characters into the search field, click the icon.

Test: Opens the Test Action List dialog, which you can use to test the list of actions and confirm that they behave the way that you want. By using this dialog, you can specify the location of a sample file that contains the data in the data source and export the file to a destination file. The actions are performed in the order that they appear in the Actions list.

Related Topics

• Using Search and Replace in BarTender