setFieldValues( )
Updates the values of a set of fields in the current item.
The setFieldValues function sets the value of a set of fields in the current item.
Setting the field values fires one onItemValuesChanged event when the page
elements connected to the fields have been updated with the new values.
Calling setFieldValues() on a read-only dataset causes an error.
Note:
A dataset needs to load its data before you call its setFieldValues() function.
Usually a dataset finishes loading a short time after the page it is on finishes
loading. So if you call setFieldValues() inside the page’s onReady()
event handler, the dataset might not be ready yet.
To call setFieldValues() as soon as possible after a page loads, use the dataset's
onReady() function inside the page’s onReady()
event handler to ensure that both the page and the dataset have finished loading.
A map of field IDs to new values.