Changes

Sbfunc

1,682 bytes added, 15:15, 21 October 2010
Created page with 'You can use '''sbfunc''' to create a custom Browser Script that runs whenever a user clicks '''Save''' or '''Submit'''. * ''Similar to '''savefunc''' but '''sbfunc''' does no…'
You can use '''sbfunc''' to create a custom [[Browser Script]] that runs whenever a user clicks '''Save''' or '''Submit'''.
* ''Similar to '''savefunc''' but '''sbfunc''' does not run on '''Save Draft'''

'''Instructions:'''
* Create a [[Custom Field]] on the page of type: [[Custom Field Type: Special – Browser Script]]
* Include a function in the [[Browser Script]] called '''sbfunc''' that includes the [[JavaScript]] you wish to execute when the record is either saved or submitted.
* The function must return either a value of '''true''' if the record should be saved/submitted; or '''false''' if the record should not be saved/submitted.
* Standard and Custom Field validations are performed '''before''' the sbfunc script is run, so if the function returns '''true''' the record immediately be saved/submitted. If the function returns '''false''' no further validation is performed and the record is <u>not</u> saved/submitted.


'''Example 1:'''

function sbfunc(frm)
{
''do this''
''RunAnotherFunction()''
''do that''
return true
}


* Note that [[JavaScript]] is case sensitive.


'''Example 2:'''
* The following sample [[JavaScript]] function will prompt the [[User|user]] to confirm if they really want to save the record.
<pre>
function sbfunc(frm)
{
var answer = confirm ("Do you really want to save this?")
if (answer)
{
alert ("Consider it done")
return true
}
else
{
alert ("Keep filling it in then")
return false
}
}
</pre>
* ''The "return false" isn't strictly necessary. If the function does not return true then false is assumed.''

===See Also===
* [[savefunc]]
* [[onloadfunc]]

[[Category:JavaScript]]
0
edits