Push a Sales Order Card to Your Mobile Device

Intermediate

30 min.

SAP Mobile Cards, iOS, SAP Mobile Services, Intermediate, Tutorial, SAP Business Application Studio, SAP Business Technology Platform, Android, Mobile

Push a card to the mobile device by triggering an action in an external system.

You will learn

How to push a card to your mobile device from an external system
How to view and delete subscription cards on your mobile device

Sandeep TDSAugust 12, 2021

Created by

August 16, 2020

Contributors

Prerequisites

You have created a push enabled card.
Postman client, CURL or any other API development platform

Congratulations! You can now push cards to your Mobile Device effortlessly.

Step 1
In the previous tutorial of this group, you created a card that will be used by the Sales Managers to Approve / Reject sales orders.
In this tutorial, you will mimic Watson’s request by triggering a request from an external system. Once the request is created, Alice will receive a push notification.
Log in to complete tutorial
Step 2
Open your Mobile Services Cockpit.

Click SAP Mobile Cards.

Navigate to Service Keys tab and click + to create a new service key.

> If you can’t see the Service Keys tab, refresh your page.

Enter/Select the values as indicated in the table, and click OK.
Alias Role
RegisterCardServiceKey register_card

You can now see the newly created service key in the table.
Make a note of the Alias, API Key, and the URL for your service key. You will be using these values in an upcoming step.
Log in to complete tutorial
Step 3
In the Mobile Services cockpit, Click Features tab → Push Notification.

In the Push Registrations tab, make a note of your User Name. You will need it in an upcoming step.
If you are unable to determine your User Name, use the Send Notification to send a custom message as a push notification.

Log in to complete tutorial
Step 4
Click Features Tab → Mobile Sample OData ESPM.

Click V2.

Access /SalesOrderHeaders Entity in the browser window that opens.

Make a note of a Sales Order ID. You will need it in the next step.

Log in to complete tutorial
Step 5
Make sure you are choosing the preferred tab above: Postman or cURL.
In this step, you will make an HTTP Request. This knowledge is transferrable, i.e. you can implement this logic in your Web/Desktop/Mobile applications.
Create your HTTP Request by using the following configuration:

Request Type & URL
HTTP Method Type URL
POST <The URL you copied from the service key table>/mobileservices/origin/hcpms/CARDS/v1/register/templated
Authorization
Authorization Type Username Password
BASIC RegisterCardServiceKey <The API Key you copied from the service key table>
Headers
Key Value
Content-Type application/json
Body - Raw → JSON

JSON
Copy
{ "method": "REGISTER", "username": "<The User Name you copied from the Push Registration table>", "templateName": "Sales Push Card BAS", "parameters": { "SalesOrderID": "<The Sales Order Id you copied from the Sample OData Service>" } }

Log in to complete tutorial
Step 6
Make sure you are choosing the right device platform tab ( Android or iOS ) above.
Before proceeding, ensure that you have created a Push Card by following this tutorial.

Either terminate the app or send it to background.

Upon a successful HTTP Request call, you will see a New card added notification; Tap on the notification to see thee card.

Tap on the card to to open it.

You can now see a sales order card for the Sales Order ID you specified in the HTTPS request method.

Which of the following attributes can be seen on the SalesOrder card?
LifeCycleStatus
Customer Address
Customer
OrderStatus
Log in to complete tutorial