.navigateToRelated()

Navigates to a related page.

Returns the 'this' object.

Syntax

.navigateToRelated( page, options )

options ::= {

pageTarget: page-target

, title: title

, quiet: quiet

, success: success-function

, error: error-function

}

page-target ::= { Dialogs | Pages | Current }

quiet ::= { true | false }

The required page identifies the related page to be navigated to.

Options is a struct that can have the following items, all of which are optional.

Page-target is a string specifying whether the related page must be displayed in Dialogs mode or in Pages mode. In Dialogs mode, the related page appears as a modal dialog. In Pages mode, the current page is replaced by the related page. The value 'Dialogs' denotes Dialogs mode. 'Pages' (the default) denotes Pages mode. 'Current' denotes the mode of the current page context, which is either Dialogs mode or Pages mode.

Title has an effect only if page-target is set to 'Dialogs'. Title is a string representing the related page dialog title to be used.

Quiet is a boolean that determines whether or not a message is displayed if an error occurs. Default is false, meaning that a message is displayed by default.

Success-function is a function called after the operation has successfully completed.

Error-function is a function called if an error occurs.

Example

$.udb.navigateToRelated('MyRelatedPage',{quiet:true});