2_salesperson_mdk_app

Salesperson App

This application is used by Mahlwerk Store's Sales Persons to place Orders on the Customer's behalf. The salesperson can scan the Machine's Barcode from the template and show the machine details to the customers. The salesperson can also add customers through this application.

Overview

Mahlwerk Sales Person application is a cross platform mobile application built using SAP Mobile Development Kit.

Architecture

This application fetches data using the OData end points form Mahlwerk's Mobile Backend. SAP Mobile Services handles the user Authentication and Identitiy management for this application

MDK Client Version

MDK 23.4 or higher

Setup & Run

Configure a new MDK application in Mobile Services cockpit

1. Navigate to SAP Mobile Services cockpit.

2. On the home screen, select Create new app.

3. In the Basic Info step, provide the required information and click Next.

   Field	Value
   ID	com.sap.mdk.salesperson
   Name	SAP MDK Demo App

   

   If you are configuring this app in a trial account, make sure to select License Type as lite.

4. In the XSUAA Settings step, continue with the default settings and click Next to navigate to further steps.

   

5. In the Assign Features step, choose Mobile Development Kit Application from the dropdown and then click Finish.

   

   If you see a Confirm Finish window, click OK.

   Once you have created your application, you see a list of default features have been automatically assigned to the app.

   

Create a new destination to your MDK Mobile application

1. Click Mobile Connectivity.

   

2. Click the Create icon to add a new destination.

   

3. In Basic Info step, provide the required information and click Next.

   Field	Value
   Destination Name	Mahlwerk
   URL	Your backend OData Service URL generated in previous exercise

   

4. For this tutorial, there is no Custom Headers, Annotations required. Click Next to navigate to further steps.

5. Since the current implementation of the OData service doesn't provide any authentication, keep the default SSO Mechanism in Destination Configuration step as No Authentication, click Next and then click Finish.

Clone Git repository in your SAP Business Application Studio space and deploy MDK project

1. Go to your SAP Business Application Studio space.

2. Clone git repository and upload this folder to SAP's Business Application Studio's workspace.

3. Right click Application.app in 2_salesperson_mdk_app folder and select MDK:Deploy.

4. Select deploy target as Mobile Services.

   MDK editor will deploy the metadata to Mobile Services.

   

5. If you want to enable source for debugging the deployed bundle, then choose Yes.

   

   You should see Deploy to Mobile Services successfully! message.

   

Display the QR code for onboarding the Mobile app

SAP Business Application Studio has a feature to display the QR code for onboarding in the Mobile client.

Click the Application.app to open it in MDK Application Editor and then click the Application QR Code icon.

Leave the Onboarding dialog box open for the next step.

Test the application

1. Download and install: SAP Mobile Services Client on your iOS or Android device (If you are connecting to AliCloud accounts then you will need to brand your custom MDK client by allowing custom domains.)

2. Follow the steps to on-board the MDK client on Android device or iOS device.

Screenshots

Coffee Machines

Machine Details

New Order > Select a customer

Configuration > Select a color

Configuration > Select the Max Pressure

Order Summary

Order being created

Customers

Customer Details and Address

Customer Machines

Machine Details

User Settings

User Actions

New Customer

Scan a barcode