Update tab

The Update tab indicates whether users can update cell data from the PDA, and enables you to customize the update buttons.

**Table 6-6: Update tab parameters**
Parameter	Description
Enable Update	Indicates whether to enable the update feature. If enabled, users can update cell data. If disabled, users cannot update cell data. By default, update is enabled.
Use Images	Indicates whether to use images or text for update buttons. By default, images are used.
Image path properties
Image Location	If images are used for buttons, specify the image file location. By default, button images are stored in: %SYBASE\UnwiredAccelerator70 \tomcat\webapps\onepage\portlets \templates\mobile\images To customize images, provide the correct image file location.
Edit Button Image	Identifies the Edit button image; for example, btn_edit_6B875D.gif. A preview of the button displays to the right of the input field.
New Button Image	Identifies the New button image; for example, btn_new_6B875D.gif. A preview of the button displays to the right of the input field.
Save Button Image	Identifies the Save button image; for example, btn_save_6B875D.gif. A preview of the button displays to the right of the input field.
Done Button Image	Identifies the Done button image; for example, btn_done_6B875D.gif. A preview of the button displays to the right of the input field.
Text button font properties
Font	The font type used for the update buttons. The default is Arial.
Font Color	The font color used for the update buttons. The default is #FFFFFF.
Font Size	The font size used for the update buttons. The default is 10 pixels.
Text Button properties
Button Color	Enter or select the button color to use for update buttons, using information in the Note, below.
Edit Button Text	Use the default Edit button text or type new text.
New Button Text	Use the default New button text or type new text.
Save Button Text	Use the default Save button text or type new text.
Done Button Text	Use the default Done button text or type new text.
Enable Update JavaScript	Indicates whether to enable the JavaScript function. This enables you to add a JavaScript update validation call. If enabled, you can access the text area under Update JavaScript Properties.
Update JavaScript Properties	Enter an update function call using JavaScript. The function is called when an update is submitted from the PDA. See “Sample update function call using JavaScript,” below, for example code.

Table 6-6: Update tab parameters

Parameter

Description

Enable Update

Indicates whether to enable the update feature. If enabled, users can update cell data. If disabled, users cannot update cell data. By default, update is enabled.

Use Images

Indicates whether to use images or text for update buttons. By default, images are used.

Image path properties

Image Location

If images are used for buttons, specify the image file location. By default, button images are stored in:

%SYBASE\UnwiredAccelerator70
\tomcat\webapps\onepage\portlets
\templates\mobile\images

To customize images, provide the correct image file location.

Edit Button Image

Identifies the Edit button image; for example, btn_edit_6B875D.gif. A preview of the button displays to the right of the input field.

New Button Image

Identifies the New button image; for example, btn_new_6B875D.gif. A preview of the button displays to the right of the input field.

Save Button Image

Identifies the Save button image; for example, btn_save_6B875D.gif. A preview of the button displays to the right of the input field.

Done Button Image

Identifies the Done button image; for example, btn_done_6B875D.gif. A preview of the button displays to the right of the input field.

Text button font properties

Font

The font type used for the update buttons. The default is Arial.

Font Color

The font color used for the update buttons. The default is #FFFFFF.

Font Size

The font size used for the update buttons. The default is 10 pixels.

Text Button properties

Button Color

Enter or select the button color to use for update buttons, using information in the Note, below.

Edit Button Text

Use the default Edit button text or type new text.

New Button Text

Use the default New button text or type new text.

Save Button Text

Use the default Save button text or type new text.

Done Button Text

Use the default Done button text or type new text.

Enable Update JavaScript

Indicates whether to enable the JavaScript function. This enables you to add a JavaScript update validation call. If enabled, you can access the text area under Update JavaScript Properties.

Update JavaScript Properties

Enter an update function call using JavaScript. The function is called when an update is submitted from the PDA. See “Sample update function call using JavaScript,” below, for example code.

You can change the grid color property by entering a color Hexadecimal code (such as #6B875D) in the text box, or you can click on the color palette next to the color properties, and select a color.

Sample update function call using JavaScript

This is a sample function that is called when a user submits an update from a PDA:

// This function will be called when save is click // arr : An array of updated input fields function updateValidation(arr) { // arr is an array of the modified updated values for (var ii=0; ii < arr.length; ii++) { // The input name is receivd from arr[ii][0] // The input value is received from arr[ii][1\ } }

In this example, comments are added to assist users on the data returned. An array is passed to the “updateValidation” JavaScript function which contains a list of all the input data within the update form, including the input name and its previous or updated values. You can add validations or change values within the array. You need not return the array since it is referenced within the main code.