T32 - Invoice Text Search (Accounts Report Generator variable)

From Catalyst
Jump to: navigation, search

Syntax

T32{text, F/L, start line, end line}

Description

This variable will return a TRUE(1) or FALSE(0) state using the 'F' option, or a line number using the 'L' option, based on a case insensitive search of the parameter on the invoiced text.

TRUE(1) will indicate that the parameter has been found in the invoice text.

If the search is on an invoice whose invoiced text has been cleared down or the search is for a transaction such as a payment the result will be FALSE(0).

Supplying start/end line numbers will limit the search to a specific block of text on each page.

If double quotes (") or commas (,) are needed in the search text then the whole search text should be enclosed with double quotes, and any double quotes within the search text should be preceded by a backslash (\). eg. to search for : Text to search, "quoted" the parameter should be : "Text to search, \"quoted\";


Parameters

text
A text parameter that can not be omitted.
The text to search for.
F/L
A text parameter that can be omitted (it defaults to "F").
F
Returns a TRUE(1) or FALSE(0) state.
L
Returns the line number of the first occurrence of the text being searched for. As page lengths vary depending on the document being searched on, this is a literal value so, if the text was found on the 30th line of page 2 of a document which has 50 lines per page, then the value returned would be 80.
start line
A numeric parameter that can be omitted (it defaults to "1").
The 'start of search block' line number.
end line
A numeric parameter that can be omitted (it defaults to "999").
The 'end of search block' line number.

Returns

A numeric value whose typical size is 3 digits.