2020.1

Method Description Script type
setVariable
()
Sets a boundaries variable to the
specified value, automatically creating the
variable if it doesn't exist yet.
Boundaries
find()
Method of the boundaries object that finds a string in a region of the data source file. The
method returns the region in which the string was searched (PDF file) or the exact region in
which the string was encountered (Text file).
To check if the call to boundaries.find() was successful, you can read the region object's
property found (see "region" on page400).
Note
In PlanetPress Connect 1.8 and previous versions, the DataMapper's boundaries.find()
function returned the region searched within PDF files, whereas for text files it returned the exact
region where the text was found. In 2018.1 this was changed so that boundaries.find() on
PDFs would return the exact region where the text was found, the same as for text files. However, it
was subsequently found that this could cause issues with previously created templates using the
function on PDF files. Consequently, this change was reverted in 2018.1.1.
find(stringToFind, in_Region)
Finds the string stringToFind in a rectangular region defined by in_Region.
stringToFind
String to find.
in_Region
The in_Region region can be created prior to the call to find() with the region.createRegion()
method. It depends on the type of data source how a region is defined; see "createRegion()"
on page401.
When used to search through a Text file, the find() method returns a different region object
(see "region" on page400) whose range property is adjusted to point to the exact physical
Page 381