Add/Remove Text

Add/Remove Text action tasks can be used to perform the following actions on the data file they receive:

  • Add or remove characters.
  • Add or remove lines of data.
  • Add the content of a text file.

Note that the content must be located at the beginning or the end of the data file.

Input

Any text-based file can be used in this task, even formats that are not directly compatible with PReS. As long as the text is visible in a text-based editor (such as Notepad), it is readable and supported by this task.

Processing

The selected operation (adding or removing lines, text or pages) is made on the data file.

Output

The modified data file is output from this task. Metadata is not modified in any way if it is present.

Task properties

General tab
  • Action group
    • Add: Select if you want the task to add content to the job file.
    • Remove: Select if you want the task to remove content from the job file.
  • Content: Select what the task will actually add or remove. Select Text file to add the whole content of a text file to the beginning or end of the job file. Select Characters to add the string of characters entered in the Characters box to the beginning or end of the job file, or to remove a given number of characters from the beginning or end of the job file. Select Lines to add the lines of text entered in the Lines box to the beginning or end of the job file, or to remove a given number of lines from the beginning or end of the job file.
  • Position: Select whether you want the task to add or remove content from the beginning or end of the job file.
  • Add CRLF after last line: Select if you want to add a CRLF (carriage return/line feed) character after the last line of text added to the job file. This option is only available when you choose to add lines of text to the job file.
  • ASCII file: Enter the path and name of the text file to be added to the job file, or use the Browse button to navigate to this file. This box is only displayed when the Text file option is selected in the Content box.
  • Characters: Enter the string of characters to be added to the job file. This box is only displayed when the Characters option is selected in the Content box.
  • Lines: Enter the lines of text to be added to the job file. This box is only displayed when the Lines option is selected in the Content box.
  • Remove: Enter the number of characters or lines to be removed from the job file. This box is only displayed when Remove is selected in the Action group and when the Characters or Lines option is selected in the Content box.

On Error Tab

For a description of the options on the On Error tab see Using the On Error tab.

Miscellaneous Tab

The Miscellaneous tab is common to all tasks.

It contains a text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button and are displayed in The Task Comments Pane.

Check the option Use as step description to display the text next to the icon of the plugin in the Process area.

The tab also provides an option to highlight the task in The Process area with the default color, set in the Preferences (see Colors), or the color selected or defined under Highlight color on this tab.
To revert the selected highlight color to the default color, open this tab, turn the Highlight option off and close the dialog with the OK button; then turn highlighting back on.
Highlighting can also be turned on and off via the task's contextual menu and with the Highlight button on the View ribbon.