Detail View Client-side Events

Description

These are the Client-side events used with the UX component's List control's Detail View.

Name
Description
afterCancelBatch

If the List is being synchronized in batches, fires after the user has clicked the 'Cancel' button to stop sending batches of records to the server to synchronize.

afterDeleteOrphanMediaFiles

Fires after orphaned media files have been deleted.

afterDeleteRow

Fires after the user has deleted a row in a List.

afterDetailViewPopulate

Fires after the user has selected a row in a List and the List's Detail View has been populated.

afterListRowSelectCancelled

Detail View for the orderDetail List is in another Panel, this event can give focus to the Panel so that the user can save the dirty Detail View record.

afterMediaFilesDownloaded

Fires after media files have been downloaded.

afterMediaFilesUploaded

Fires after all media files (photos, video, audio recordings) have been uploaded to the server, or Amazon S3 when data are synchronized.

afterNewRecord

Fires after the new record has been displayed in the DetailView form.

afterRefreshListIncremental

Fires after an incremental List refresh completes.

afterResetRow

Fires after the user has undone edits to a row of data in the List.

afterSynchronizeList

Fires after the data in the List has been synchronized.

afterSynchronizeListBatch

If the List is being synchronized in batches, fires when a batch is completed. If the function returns false, the next batch (if any) will not be sent. The data in the e object that is passed in will allow you to create your own progress counter. The countObject parameter in the e object has statistics on the current batch (e.g. number of records with errors, etc.) To see all of the properties in e.countObject you can add this to your code: alert(JSON.stringify(e.countObject)).

afterSynchronizeListBatchEnd

If the List is being synchronized in batches, fires after the last batch has completed. A possible use case for this event is to allow you to close a window you might have opened to show the synchronization progress. The countObject parameter in the e object has statistics on the current batch (e.g. number of records with errors, etc.) To see all of the properties in e.countObject you can add this to your code: alert(JSON.stringify(e.countObject)).

afterUndoEdits

Fires after the user has undone edits to the List Detail View.

afterUpdateList

Fires after the user updates the List with edits that have been made to the List Detail View.

beforeCRUDExecute

Fires before a SQL statement that is part of a List sync operation is executed.

beforeDeleteOrphanMediaFiles

Fires before any orphaned media files are deleted from the local file system on the device.

beforeDetailViewPopulate Event

Fires after the user has selected a row in a List, but before the List's Detail View is populated.

beforeMediaFilesDownloaded

Fires before media files are downloaded.

beforeMediaFilesUploaded

Fires before any media files (photos, video, audio recordings) are uploaded to the server, or Amazon S3 when data are synchronized.

beforeSynchronizeListBatchStart

If the List is being synchronized in batches, fires before the first batch is submitted. The purpose of this event is to allow you to open a window or set focus to a panel where the synchronization progress will be shown.

canCancelBatch

If the List is being synchronized in batches, fires if the user clicks the 'Cancel' button to stop sending batches of records to the server to synchronize. If the function returns false, then the synchronization is not cancelled.

canDeleteRow

Fires when the user tries to delete a row of data in the List. If function returns false, action is cancelled.

canNewRecord

Fires when the user tries to go to a new Detail View record. If the function returns false, action is cancelled.

canResetRow

Fires when the user tries to undo edits to a row of data in the List. If function returns false, action is cancelled.

canSynchronizeList

Fires when the user tries to synchronize the data in the List (by making an Ajax callback). If the function returns false, the action is cancelled. The data object is passed in as a member of the e object. If you set properties in e.data, you can override the values from the List that will be submitted to the server. If you set the e.data[rowNumber]._isDirty property of a particular row to false, then the data in that row will not be synchronized. The e object that is passed in includes batchSize, totalDirtyRows, and startingRow. If all of the data is not being submitted in batches, then the batch size is 0. To test if this is the first batch in a job test for batchSize > 0 and startingRow = 1.

canUndoEdits

Fires when the user tries to undo edits to the List Detail View form. If function returns false, action is cancelled.

canUpdateList

Fires when the user tries to update the List with edits that have been made to the List Detail View. If function returns false, action is cancelled. The data object is passed in as a member of the e.object. If you set properties in e.data, you can override the values that the user entered.

hasClientSideValidationErrors

The 'hasClientSideValidationErrors' event fires when the user tries to save Detail View edits back to the List and one or more controls in the Detail View has a client-side validation error.

listReadyToPersist

Fires when the list is ready to persist to storage.

modeChanged

Fires when the Detail View mode changes. The possible states of the 'mode' flag are: 'edit', 'enter' and 'search'.

onMediaFilesUploadErrors

Fires if there were any errors when uploading media files.

onNoMediaFilesToFetch

Fires when there are no media files to download.

See Also