2022.2

Example: Thefollowingexampleloadsasnippetintoavariableandusesthefind()andtext()
commandsoftheDesignerscriptingAPI.
var labelElm = loadhtml('snippets/label.html');
for(var i = 0; i < record.tables.products.length; i++) {
var label = labelElm.clone();
label.find('@ProductLabel@').text(record.tables.products[i].ProductDescription);
results.after(label);
}
What'swrongwiththiscodeisthatitinsertsthepersonalizedinformationwithintheloop.Theafter()
commandrunsasmanytimesastherearerecordsinthedetailtable'products'.
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;
}
Page 822