Follow

Connection Configuration Options

Table of Contents

Configuring Connections

 

Connections between pages are configured in two manners: by choosing/adding pages as prompted by the Designer or via the Configure Connections menu.

 

In the former option, you are prompted by the Designer to Create a New Page, Connect an Existing Page, or Import a Page when navigating through your Zapp and interacting with a control that does not have any outgoing connections yet but leads to a new page on the source web application.

 



Please see Declaring Pages for more information.

 

If you wish to add a connection manually, you can do so by configuring the connections of the page. You can access the Configure Connections menu by clicking the caret in the upper right hand corner of the Zapp preview and selecting Configure Connections.

 



 

The Configure Connections option enables you to view and edit all incoming, internal, and outgoing connections for each page. This article provides an overview of each of these types of connections and the various options available.

 



Anatomy of a Connection

 

Each connection consists of three parts:

  • The page to/from which the Zapp will navigate.
  • The control involved. This may be a button, lookup, dropdown, modal, etc.
  • The type of user interaction with the control, such as clicking a button, selecting an item from a dropdown, etc.

The following example illustrates each of these three properties.

 


In this connection, selecting an item from the Location dropdown menu causes the Zapp to navigate from Page 2 (where the Location dropdown is located) to the currently selected page.

 

Defining & Modifying Connections

 

Incoming Connections

 

Incoming connections describe how the user may navigate from other pages to the selected page. For example, in the below example, the user may arrive at page 1 by clicking the "Save Changes" button on Page 2.

 



Editing Connections

 

You can edit a connection by clicking on the desired item. The below menu will open.

 



Using this UI, you may modify optional configurations for each connection, such as preserving the UI state. To save, click the blue checkmark. To cancel, click the X.

 

Note: The page, control, and action cannot be edited once created.

 

Connections can also be deleted by clicking the delete icon in the upper right hand corner.

 



Adding a New Connection

 

While connections are automatically captured during the Zapp Building process, they can also be manually added via the Configure Connections menu. To add a new connection, click the plus sign icon in the upper righthand corner while viewing the Incoming tab.

 



The below menu will display. Choose the page, control, and other options you wish to enable. Once finished, click the check button to save.

 



Configuration Options

 

Several required and optional settings are available for each incoming connection:

  • Select Source: This is the page from which the user will navigate to the currently selected page. You can choose the page from a dropdown menu. Starting Point, which refers to the first page of your Zapp users reach, is also included as an option.

  • Select Control: The control which triggers the connection. A list of the available  controls on the source page is displayed.

  • Action: Click, Select, Open, etc. This field is pre-populated based on the type of the selected control.

 

If a dropdown menu is selected as the control, a secondary field, asking for a specific value within the dropdown will also display. You may select either a particular value or [Any Value].

 

 

Note: Additional settings, such as waiting X seconds or delaying a connection are set via Outgoing Connections.

 

The incoming connections for a particular page can also be defined as a global connection, whereby the page can be connected from any other page in the Zapp. See Global Connections for more information. 

 

Internal Connections

 

Internal Connections define the interactions that will result with the user remaining on the same page. For example, in the below example, filling in a text field in the table will not result in moving between pages.

 



Editing Connections

 

Like incoming connections, internal connections can be edited by clicking the desired connection. You may edit whether or not to Remember the UI State as well as enable/disable delaying the connection for X seconds.

 

Note: The selected control and action are not editable.

 

 

Connections can also be deleted by clicking the delete icon in the upper right hand corner.

 



Adding a New Connection

 

While connections are automatically captured during the Zapp Building process, they can also be manually added via the Configure Connections menu. To add a new connection, click the plus sign icon in the upper righthand corner while viewing the Internal tab.

 


 

The below menu will display. Choose control, and other options you wish to enable. Once finished, click the check button to save.

 



Configuration Options

  • Select Control: The control which triggers the connection. A dropdown of the available controls on the page is displayed.

  • Action: Click, Select, Open, etc. This field is pre-populated based on the selected control type.

 

If a dropdown menu is selected as the control, a secondary field, asking for a specific value within the dropdown will also display. You may select either a particular value or [Any Value].

 

  • Remember UI State: Ensures that the same tab or drilldown page or scroll position is accessed when navigating back and forth between pages. Please see Preserving the UI State Between Zapp Pages for more information.

  • Delay Connection: Allows you to delay the connection for X seconds. This setting is useful for cases where you may experience source application latency and, therefore, must wait before an action is completed in the Zapp.

Outgoing Connections

 

Outgoing connections define how interacting with controls on the selected pages will lead the user to other pages within the Zapp. For example, in the below example, opening the lookup called "Location" will lead the user to page 2 of the Zapp.

 



Editing Connections

 

Outgoing connections can be edited by clicking on the desired connection. The following menu will then appear.

 

 

Using this menu, you can add additional destinations, add rules, set the connection to lead to the previous page (always go back), and choose to delay the connection for X seconds.

 

Note: The selected control cannot be edited.

 

You can also delete the entire connection or a particular destination by clicking the grey minus icons.

 



Adding a New Connection

 

While connections are automatically captured during the Zapp Building process, they can also be manually added via the Configure Connections menu. To add a new connection, click the plus sign icon in the upper righthand corner while viewing the Outgoing tab.

 



The below menu will display. Choose control, and other options you wish to enable. Once finished, click the check button to save.

 

 

Configuration Options

  • Select Control: The control which triggers the connection. A dropdown of the available controls on the page is displayed.

  • Action: Click, Select, Open, etc. This field is pre-populated based on the selected control.

 

If a dropdown menu is selected as the control, a secondary field, asking for a specific value within the dropdown will also display. You may select either a particular value or [Any Value].

 

  • Destinations: Outgoing connections lead to one or more pages. You can add a destination by clicking the plus icon and selecting the desired page from the dropdown menu.

    The option to "Always Go Back" can also be selected to take the user to the previous page. Please see Back Connections for more information.

 

Note: If multiple destinations are found to be similar, the Designer will detect a conflict and prompt you to add rules further defining when to connect to each page. Please see Resolving Connection Conflicts for more information.

  • Delaying Connections: You can configure your Zapp to "Wait for X seconds." During this period, the connection can either be delayed or all interaction with the Zapp may be blocked.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.