This component allows you to automatically make changes to existing text files according to the parameters you set.
The left pane displays any text files that have been added. Click the arrow buttons to change the order in which the text files will execute.
Click the plus sign next to a text file to display any changes that have been added for it. You cannot add only one change mode per change item.
If you click a change in the left pane, the right pane displays the attributes for the change parameters. The attributes control the changes that will be made to the text file.
The following fields are displayed when you click a change in the left pane.
Change Mode
You can perform three functions on a text file:
Search in it
Prepend text to it
Append text to it
Search Type
You can define a type of search:
Sub-string
Whole word
Start of a line
End of a line
Entire line
Search String
Enter the exact string of text to be located in the search.
Case Sensitive
Click to make the search case-sensitive.
Find All Occurrences
Click to have the search locate all occurrences, instead of just the first one.
Result Action
You can determine what to do with the search string by selecting any of the following actions:
Add a line after
Add a line before
Add a word after
Add a word before
Delete string
Delete word
Delete line
Delete all lines after
Delete all lines before
Replace string
Replace word
Replace line
Append a line
Prepend a line
Prepend to file if not found
Append to file if not found
New String
If the action selected under Result Action requires text to insert, then enter that text here. You can include variables.
Add
You have two add options (accessed by clicking the down arrow on the list box left of the Add button):
Text File:
Click to add a text file. You must know the exact name of the text file, including its full path.Change:
Click to add a change to the text file. The name of the change should indicate what it does.IMPORTANT:
For each change mode you want to apply to the text file, you must add a separate change item. You can only have one change mode per change item.
Remove
If you select a text file and click Remove, the package component will no longer make changes to that text file. This does not remove the text file from the server.