2022.2

Method Description Script type
"getVariable()"on
thefacingpage
Retrievesavalueofavariablestoredintheboundariesobject. Boundaries
"set()"onpage373 Setsanewrecordboundary.(See:"Recordboundaries"onpage226.) Boundaries
"setVariable()"on
page374
Setsaboundariesvariabletothespecifiedvalue,automaticallycre-
ating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394).
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tem-
plates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395.
WhenusedtosearchthroughaTextfile,thefind()methodreturnsadifferentregionobject(see
"region"onpage394)whoserangepropertyisadjustedtopointtotheexactphysicallocationwhere
thematchwasfound.Thiswillalwaysbeasubsetofthein_Region.rangeproperty.Itcanbeused
todeterminetheexactlocationwherethematchoccurred.
Useboundaries.get()toretrievetheactualtextfromtheresultingregion;see"get()"onthefacing
page.
Page 371