2022.2

ThemandatoryrecordparameterisaJavaScriptobjectthatcontainsoneormorefieldsspecifiedin
thedatamodelattherootlevel.
TherecordparametermaycontainasubsetofthefieldsintheDataModel.Onlythefieldsincludedin
therecordparameterareupdatedinthedatabase,whilethecontentsofallotherfieldsremain
unchanged.
Thecallfailsiftheparameterisomittedorempty,ifanyofthefieldsspecifiedintherecorddoesn't
existintheDataModel,orifavaluecannotbeconvertedtothedatatypethatisexpectedinafield.
Note: Inordertochangevaluesintherecordcopies,thefieldstomodifymusteitherhavea
defaultvalueorhaveanextractiontaskearlierintheprocessthatactuallyassignsavalueto
them.
About data types
Wherepossible,valuesareautomaticallyconvertedintothedatatypeoftherespectivedatafield.
Note: DatesmustbepassedasaDateobjecttoallowthemtobeextractedintoaDatefield.See
DateintheMozillahelpfiles.
Passinganimproperdatatypetriggersanerror.Forinstancethefollowingobjectsareallinvalid:
{ myBoolean : "true" }-ThemyBooleanfieldisbooleanandexpectsaboolean,notastring
{ myDate : "2021-03-29" }-ThemyDatefieldisadateandexpectsaDateobject:myDate:
new Date(2021,2,29),notastring
{ myPageCount : 2.5 }-ThemyPageCountfieldisanintegerandexpectsanumberwithoutany
decimals
{ myPrice : "19.99" }-ThemyPricefieldisacurrencyandexpectsanumbervalue,notastring
Example
record.copies = 3;var oneRec = {CopyFor:'',Note:''};
for(var i=0;i<record.copies;i++){
switch (i) {
case 0:
oneRec.CopyFor = "Customer";
oneRec.Note = "Payment due in 30 days";
break;
case 1:
oneRec.CopyFor = "Administration";
oneRec.Note = "Due date set to 30 days";
break;
case 2:
oneRec.CopyFor = "Archive";
}
record.setCopy(i, oneRec);
}
record
Thecurrentrecordinthemaindataset.
Page 393