Get Lines

The Get Lines object gets multiple lines from a text file according to criteria that you specify.

Note: This object replaces functionality in the Manage Text File Legacy object. For more information, see the Legacy topic.

How it is used

Use the Get Lines object to get specific lines from a text file, no matter which line they are found on.

Configuration

To configure the Get Lines object you need to know the name of the file that you want to get lines from, the file encoding it uses, and the criteria that you use to filter the lines.

Details Tab

 

File	Type the path and name of the file that you want to get the text from, or click the ellipsis button (...) and browse for it.
File encoding	Click the ellipsis button (...) and select the format that the file is encoded in from the File encoding drop-down list. Verify that you select the correct encoding format: if the file uses a different encoding format, the object fails.
Lines	Click Add and create filters for the lines that you want to get from the file: • Name – Search for lines by their name. • Range – Search for lines by their range.

Available Published Data

 

Name	Description
File path	The filename and path of the file that the lines were taken from.
File encoding	The file encoding format that you selected in the File encoding field.
#Name# line text	For each item that you add in the Lines list of the dialog, a new Published Data item is created. This item displays the line text of each item in the Lines list. #Name# represents the name that you assigned in the Name field.
#Name# line numbers	For each item that you add in the Lines list of the dialog, a new Published Data item is created. This item displays the line numbers where text was found from each item in the Lines list. #Name# represents the name that you assigned in the Name field.
Total Number of Lines in the Ranges Specified	The total number of lines that were found in the ranges that were specified.

Common Published Data