RefreshFieldsAction

 
RefreshFieldsAction is used to form a AjaxMgr.refreshFields() call definition. With this call, the attributes of one or more DOM elements can be refreshed  with the fresh data taken from the specified data source.

See RefreshFieldsProcess

Properties

Data Source Name (dataSource) (MScript kullanılabilir)

The name of a Data Source Element (e.g. mor>RelDB>RelDBQueryDataSource).

Nodes To Encrypt (nodesToEncrypt) (Separated with commas, Accepts MScript)

The names of the data nodes (separated with commas) whose values to be encrypted.

Data Nodes (dataNodes) (Separated with commas)

The names of the data nodes provided by the data source separated with commas.

Target Elements Ids (targetElements) (Separated with commas)

The HTML ids of the target elements (Process fields or ordinary HTML elements). The target elements can be selected from the "ProcessField List" dialog. Use CTRL key to select more than one element.

Target Element Attributes (targetElementAttrs) (Separated with commas)

A string that contains the names of the attributes of the target elements, separated with commas, to set. If omitted "value" attributes of the target elements are set. Note that the definitions should positionally correspond to the elements defined in Target Elements Ids property.

Request Parameters (requestParams)

The parameters and their values. The initial value "{p1:'p1val', p2:'p2val'} ?" aims to show the definition syntax and if no update is made to it, it is ignored in the output.

When defining this property, it is important in which element the generated call definition is used. For example the this word in "{ID:this.value}" definition represents the HTML element object that the generated call definition is used in, not this action element itself.
 

Busy Image (busyImage)

The HTML id of a BusyImage element that exists in the page.

CallBack Function (callbackFunc)

The Javascript function to be called after the target fields are refreshed. The function receives a MultiPartAjaxResponse object as the parameter

User Data (userData)

The user data object defined with this property is passed to the response handler and the callback function.

Error Handler (errorHandler)

The name of the function to be called when an error occurs. The function receives Exception and AjaxResponse objects as the parameters.

The calling the AjaxMgr.refreshFields() function

Dynamic Call Definition
 
On the context menu that pops up when an action element is right clicked, the following options are displayed. If the option 'Copy "Dynamic Call Definition" to Clipboard' is selected, a dynamic call definition is formed and copied to the Windows clipboard.

The copied definition can later be pasted into the event properties of the elements or into the "Embedded Script" properties of the Script elements.
 
Example:
 

%vof(/myRefreshFieldsAction/jscall)

The actual AjaxMgr.refreshFields() call is generated during the compiling of the page by expanding the %vof(??/jscall) definition.

Function Call

The second "Copy to clipboard" option on the context menu is used for that. When the 'Copy "Javascript Function Call" to Clipboard' option is selected, AjaxMgr.refreshFields() call definition is formed immediately with the current values of the properties and copied to the Windows clipboard.

The call definition copied to the clipboard can later be pasted into the event properties of the elements or into the "Embedded Script" properties of the Script elements.
 

Warning! In contrary to the dynamic call definition, the changes made to the properties after the function call copied, will not be effective.