Navigation

Navigation methods can be used to move the participant to a different screen or dashboard. In native apps, these can change which application is active.

Applications allow you to present other applications. This can be done both modally and non-modally.

Presenting another application can be done via calling OpenApplication with the specified url. If selecting a specific object, for instance, you might want to append query string parameters to your url to identify that object.

If no options are supplied to the OpenApplication action, a “push” transition is used by default. In iOS/Android native applications, the new application slides in from the right. To go back, you must call MyDataHelps.Back() which will “pop” the current view off the stack.

You can also present applications modally by passing modal:true in options. In iOS/Android native applications, the new application slides in from the bottom and is presented “on top” of the current application. This creates a new “stack” of applications. Inside a modal application you can present other applications non-modally, in which case you can use MyDataHelps.Back() as normal to “pop” them off the stack. MyDataHelps.Dismiss() will dismiss the modal window and everything in it’s “stack”.

Note that your application can only open urls which have been “registered” for your project. When you submit your initial inquiry to CareEvolution we will register the application urls for your project - if you need to open an application at a non-registered url, however, please contact CareEvolution support.


Open a Url Outside of the App

MyDataHelps.openExternalUrl(url)

Opens a url in the system browser. In native apps, this will cause the user to leave MyDataHelps.

Parameters

url string (required)

The URL to open.

Availability

MyDataHelps Applications
Web View Steps

Open a Url Inside the App (Native Only)

MyDataHelps.openEmbeddedUrl(url)

Opens a url in an embedded browser. In native apps, this will leave the user in MyDataHelps.

Parameters

url string (required)

The URL to open.

Availability

MyDataHelps Applications
Web View Steps

Change the Active Tab in MyDataHelps

MyDataHelps.showTab(tabKey)

Switches the participant’s view to the specified tab. Tabs are the main screens used in your project, and each has a unique key. CareEvolution can provide keys to your project tabs during the review process.

Parameters

tabKey string (required)

The key for the tab you want to show.

Availability

MyDataHelps Applications
Web View Steps

Open a Registered External Application in MyDataHelps

MyDataHelps.openApplication(url, options)

See Navigating Between Applications.

Parameters

url string (required)

The URL of the external application.

options object

A javascript object. Set properties to control the operation. The only available option is modal; set to true to present the application modally.

Availability

MyDataHelps Applications
Web View Steps

Close the Current Modal Application

MyDataHelps.dismiss()

See Navigating Between Applications.

Availability

MyDataHelps Applications
Web View Steps

MyDataHelps.back()

See Navigating Between Applications.

Availability

MyDataHelps Applications
Web View Steps