Create a Customer List Page in an MDK App

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 Cell 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 Cell Table control is that it has icons that can activate device functionality such as phone, email, video and more.

1. In SAP Business Application Studio project, right-click the Pages | MDK: New Page.

   

2. Select | Section Page and click Next.

   

   You can find more details about Section Page.

3. Enter the Page Name Customers_List and click Next and the Finish on the confirmation step.

   

4. In the Properties pane, set the Caption to Customers.

   

5. In the Layout Editor, expand the Controls | Data Bound Container group, drag and drop the Contact Cell Table control onto the Page area.

   

6. In the Properties pane, provide the below information:

   Field	Value
   Service	Select SampleServiceV2.service from the dropdown
   EntitySet	Select Customers from the dropdown
   QueryOptions	$orderby=LastName

   

7. In the Properties pane, click the link icon to open the Object Browser for the Description property. Double click the City property of the Customer entity to set it as the binding expression and click OK.

   

   Be careful not to select City from Address (ESPM.Address).

   

8. Remove the default value for the DetailImage property. Repeat the above steps for Headline and Subheadline properties binding to LastName and FirstName properties of the Customer entity respectively.

   You should have final results as below.

   

9. In the Search section of the Properties pane, change both the Search Enabled property and Barcode Scanner property to true.

   

10. In the Activity Items section of the Properties pane, click Add to add a new activity item.

    

11. Expand the added item, click the 3 dots icon to open the Object browser to bind the ActivityValue to the PhoneNumber property of the Customer entity.

    

12. Similarly, add one more activity item, select Email from the dropdown and bind it to EmailAddress property of the Customer entity.

    

Now, you will create a Navigation action that opens the Customers_List.page when called.

1. In SAP Business Application Studio project, right-click the Actions | MDK: New Action.

   

2. Choose MDK UI Actions in Category | click Navigation Action | Next.

   

3. Provide the below information:

   Field	Value
   Action Name	NavToCustomers_List
   PageToOpen	Select Customers_List.page from the dropdown

   

4. Click Next and then Finish on the confirmation step.

Now, that the Customer List page is created, you will add a button to the Main page to display the Customers. You will use a Button Table control.

1. In Main.page, expand the Controls | Static Container group, drag and drop the Button Table control onto the Page area.

   

   Container includes controls that act as containers for other controls, such as container items. A container is constant for all pages. The size of a container depends on the controls and contents included inside.

2. Expand the Static Items section of the Controls palette.

   Drag and drop a Button onto the Button Table container on the page.

   

   Each static container type in a Section Page can contain specific controls (static items).

   You can find more details about Container and Container Item.

3. In the Properties pane, set the Title of the button to Customer List.

   

4. Under Events tab, click the link icon for the OnPress Handler property to open the Object Browser. Double click the NavToCustomers_List action and click OK to set it as the OnPress Handler Action.

   

Deploy the updated application to your MDK client.

1. Right-click Application.app and select MDK: Deploy.

   

2. Select deploy target as Mobile & Cloud.

   

   You should see success message for both deployments.

   

   Alternatively, you can select MDK: Redeploy in the command palette (View menu>Find Command OR press Command+Shift+p on Mac OR press Ctrl+Shift+P on Windows machine), it will perform the last deployment.

   

Make sure you are choosing the right platform tab above.