Overview
You will learn
- How to create a new page and add some controls to display customer information
- How to navigate from one page to another page
Prerequisites
Steps
Intro
To enhance your MDK app with customer list information, you need to carry out the following tasks:
- Create a new customer list page
- Add Contact Table control to the page
- Create a new navigation action to the customer list page
- Add a new button on main page and navigate to customer list page when user clicks it
- Deploy the app metadata to SAP Mobile Services & Cloud Foundry
- Update the app with new changes

This page is a searchable list that displays all customers.
To create the Customer List page, you will create a Section page and drag the Customer Contact Table control onto the page. In the property palette, you will link the control to the Customer Collection and then map data and actions to different areas of the cell object in the property palette. One nice feature about the Contact Table control is that it has icons that can activate device functionality such as phone, email, video and more.
In the project, right-click the Pages | MDK: New Page.

Pages Folder New Page Right-Click Menu Select | Section and click Next.

Section Page Type Selection You can find more details about the Section Page in this documentation.
Enter the page Name as
Customers_List, and click Finish.
Customers List Page Name Entry Once the page opens in the page editor, click on the white area to select it’s Action Bar, and set the Caption to Customers.

Action Bar Caption Set To Customers In the Layout Editor, expand the Controls | Data Bound Container group, drag and drop the Contact Table control onto the Page area.

Contact Table Control Drag And Drop In the Target section, provide the below information:
Field Value ServiceSelect com_sap_edm_sampleservice_v4.servicefrom the dropdownEntitySetSelect Customersfrom the dropdown
Service And EntitySet Target Configuration In the Properties pane, click the link icon to open the Object Browser for the Description property. Double click the
Cityproperty of the Customer entity to set it as the binding expression and click OK.
City Property Bound To Description Be careful not to select
CityfromAddress (ESPM.Address).
City Property From Address Warning Remove the default value for the
DetailImageproperty. Repeat the above steps forHeadlineandSubheadlineproperties binding toLastNameandFirstNameproperties of the Customer entity respectively.You should have final results as below.

Contact Table Final Property Bindings In the Search section of the Properties pane, change both the
SearchEnabledandBarcodeScannerproperties to true.
Search And Barcode Scanner Properties Enabled In the Data section of the Properties pane, click Add to add a new activity item.

Activity Item Added In Data Section Expand the added item, click the dotted icon to open the Object browser to bind the
ActivityValueto thePhoneNumberproperty of the Customer entity.
Phone Number Bound To Activity Value Similarly, add one more activity item, select Email from the dropdown and bind it to
EmailAddressproperty of the Customer entity.
Email Address Activity Item Added
Now, you will add a button on the Main page and from there, you will navigate to the Customers_List.page.
In the
Main.page, expand the Controls | Static Container group, drag and drop the Button Table control onto the Page area.
Button Table Control Dragged To Main Page Container includes controls that act as containers for other controls, such as container items. A container is constant across all pages. The size of a container depends on the controls and contents it contains.
Expand the Static Items section of the Controls palette.
Drag and drop a Button onto the Button Table container on the page.

Button Dragged Onto Button Table Container Each static container type in a Section Page can contain specific controls (static items).
You can find more details about Container and Item it may contain in this documentation.
In the Properties pane, provide the below information:
Field Value ImageClick link icon to open the browser and bind it to customerSAP iconTitleCustomers
Button Image And Title Properties Set Imageproperty is referencing to the SAP font icon.Under Events tab, click the dotted icon for the
OnPress Handlerproperty and select theCreate a rule/action.
OnPress Handler Create Rule Action Selected Keep the default selection for the Object Type as Action and Folders path.

Default Object Type And Folders Selection Choose UI in Category | click Navigation | Next.

UI Navigation Category Selected In the Base Information step, provide the below information and click Finish.
Field Value NameNavToCustomers_ListPageToOpenSelect Customers_List.pagefrom the dropdown
Navigation Action Base Information Configured
You will now deploy the updated project to your MDK client.
Click the Deploy option in the editor’s header area, and then choose the deployment target as Mobile Services

Make sure you are choosing the right platform tab above.
Tap Check for Updates in the user menu on the Main page, you will see a New Version Available pop-up, tap Now.

Android Check For Updates New Version Popup You will notice the newly added section button on the Main page. Tap Customers.

Android Main Page Customers Button Added Here, you will see list of all the Customers. You can search a record by by First Name or Last Name or City. Controls are rendered natively on device, you can email to the customer, make a phone call etc.

Android Customer List With Search Results Here, you may notice that City is not showing up on screen, this is by design. In portrait mode, the device width is considered compact, if it was a tablet device (where both portrait and landscape are considered regular instead of compact) you would see City on either orientation.
Tap Check for Updates in the user menu on the Main page, you will see a New Version Available pop-up, tap Now.

iOS Check For Updates New Version Popup You will notice the newly added section button on the Main page. Tap Customers.

iOS Main Page Customers Button Added Here, you will see list of all the Customers. You can search a record by by First Name or Last Name or City. Controls are rendered natively on device, you can email to the customer, make a phone call etc.

iOS Customer List With Contact Controls Here, you may notice that City is not showing up on screen, this is by design. In portrait mode, the device width is considered compact , if you change device orientation to landscape mode, you will see City.

iOS Landscape Mode City Column Visible If it was an iPad (where both portrait and landscape are considered regular instead of compact) you would see City on either orientation.
Resources
Discussion
Share feedback on this tutorial or join the conversation in SAP Community.