Table Of Contents
Parsing Operators/Rules
This chapter describes the pre-defined text manipulation operators available for parsing raw device input and turning it into a soft property that are available in the Add/Edit Parsing Rule dialog box. For each operator its name, description, expected input, validation rules and the unique fields displayed in the dialog box are described. An example of each operator is also provided.
For more information about the Add/Edit Parsing Rule dialog box see Defining the Parsing Parameters.
•
Header and Footer—Describes the Header And Footer operator and provides an example.
•
•
•
•
•
•
•
Header and Footer
Description
Removes a specified number of lines from the header and footer of the input text.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Header And Footer operator is selected. In addition, the dialog box displays an example using the Header And Footer operator.
Figure A-1 Header and Footer Operator
Parameters
Header lines
The number of header lines to be removed.
Integers only. Mandatory.
Footer lines
The number of footer lines to be removed.
Integers only. Mandatory.
Remove Lines
Description
Removes a range of lines from the specified starting row to the specified end row of the input text.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Remove Lines operator is selected. In addition, the dialog box displays an example using the Remove Lines operator.
Figure A-2 Remove Lines Operator
Parameters
Select Lines
Description
Extracts a range of lines from the specified starting row to the specified end row of the input text.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Select Lines operator is selected. In addition, the dialog box displays an example using the Select Lines operator.
Figure A-3 Select Lines Operator
Parameters
Replace
Description
Finds one or all occurrences of a substring, which matches a specified regular expression, and replaces it with a specified value.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Replace operator is selected. In addition, the dialog box displays an example using the Replace operator.
Figure A-4 Replace Operator
Parameters
Match
Description
Finds and extracts a substring, which matches a specified regular expression. If no match can be found the output buffer receives an empty string.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Match operator is selected. In addition, the dialog box displays an example using the Match operator.
Figure A-5 Match Operator
Parameters
Expression
Search for value or regular expression.
Text. Mandatory.
Set
Description
Prints the results of the input and output buffers.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Set operator is selected. In addition, the dialog box displays an example using the Set operator.
Figure A-6 Set Operator
Parameters
Expression
Regular expression template to use for formatting. $_$ specifies the main output buffer.
Text. Mandatory.
Substring
Description
Extracts a substring of a specified length from a specified starting point.
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Substring operator is selected. In addition, the dialog box displays an example using the Substring operator.
Figure A-7 Substring Operator
Parameters
Parse Integer
Description
Uses the substring rule, and when a result is received with the substring it is converted into an integer value.
Note
Dialog Box
The Add/Edit Parsing Rule dialog box is displayed below when the Parse Integer operator is selected. In addition, the dialog box displays an example using the Parse Integer operator.
Figure A-8 Parse Integer Operator
Parameters
