2022.2

Example: Thescriptbelowismuchmoreefficient:itaddsthepersonalizedcontenttoastring
calledlabelStrandonlycallsafter()aftertheforloop.
var labelElm = loadhtml('snippets/label.html');
var labelStr = "";
for( var i = 0; i < record.tables.products.length); i++) {
var label = labelElm.clone();
label.find('@ProductLabel@').text(record.tables.products[i].ProductDescription);
labelStr += label;
}
results.after(labelStr);
Usereplace()
WhenpersonalizingHTMLfragmentsretrievedfromasnippetorfromthetemplateitself,JavaScript's
replace() methodshowsthebestperformance.
Replace()canonlybeusedonStrings,whilethecommandsloadhtml()andquery()returnora
QueryResult,whichisasetofstrings,liketheresultsobject.
AQueryResultallowsyoutoperformDOMmanipulationslikeaddingandremovingelements,adding
andremovingCSSclassesetc.Whentherequiredmanipulationsarelimitedtofind/replaceactions,
youcouldchangetheQueryResultintoastring.Thisallowsyoutoreplacetextusingthereplace()
method.
Forthis,youcouldusetoString():
var labelSnippet = loadhtml('snippets/label.html').toString();
OryoucouldcopytheHTMLoftheQueryResultstoavariable:
var block = results.html();var labelSnippet = loadhtml('snippets/label.html').toString();
var labelStr = "";
for( var i = 0; i < record.tables.detail.length; i++) {
var label = labelSnippet;
label = label.replace('#', i);
label = label.replace('@product@', record.tables.detail[i].fields['product']);
label = label.replace('@notes@', record.tables.detail[i].fields['notes']);
label = label.replace('@netweight@', record.tables.detail[i].fields['netweight']);
labelStr += label;
}
results.after(labelStr);
Tip: Thereplace()methodasusedintheaboveexamplereplacesonlythefirstoccurrenceof
thesearchstring.Toreplace every occurrenceofasearchstringinagivenstring,useareg-
ular expression.Inthefollowinglineofcode,theregularexpression/@product@/gmakes
replace()searchforalloccurrencesofthestring@product@inthelabelstring:
label = label.replace(/@product@/g, record.tables.detail[i].fields
['product']);
Page 382