Skip to content

Mobile Cards for Android

Overview

SAP Mobile Cards for Android is a wallet style app used to mobilize enterprise data as micro apps. Customizable sample cards include sales orders, products, company news, SAP Inbox, common HR data from SuccessFactors, etc.

Note

SAP Mobile Cards Android Client is now compatible only with 7.1 and up versions.

Installing the Application

To use SAP Mobile Cards, you must install the application on your Android phone.

You can download the app directly from the Google Play Store. The application installs the SAP Mobile Cards app icon on your Android phone's home screen.

Launching the Application

Launch the application by tapping the SAP Mobile Cards application icon. SAP Mobile Cards application icon

Registering the Application

Register SAP Mobile Cards so that it can retrieve application settings from the server.

Context

If your system administrator has automatically configured SAP Mobile Cards, you won't see the registration screen. Instead, you'll see the logon screen. If that's the case, go directly to Logging on to the Application

If your system administrator hasn't automatically configured SAP Mobile Cards, follow the steps below to register the app. You only need to register the app the first time you use it, or if you reset or reinstall it. Once you've registered the app, you'll be able to receive card information and updates on your Android phone.

Note

If you experience any issues while registering the SAP Mobile Cards app, please reset the app and try again.

You can also use the Scan QR Code function to scan a registration QR code to register an app.

Procedure

  1. From the Welcome screen, enter the following information, provided to you by the system administrator

    • The Server URL or Email

    • (If required) OAuth Client ID

    • (If required) OAuth Endpoint URL

  2. Tap Register.

Logging on to the Application

Log on to the SAP Mobile Cards application on your Android phone.

  1. From the logon screen, enter the following information, provided to you by the system administrator:

    • User ID or Email

    • Password

  2. If you've been redirected to the Authorize Client screen, select Authorize. If you select Cancel, you are redirected back to the Registration Required screen, and you see a message telling you that the registration was unsuccessful. For a successful registration, you must authorize the SAP Mobile Cards application to retrieve data from the server.

Setting a Passcode

Set a passcode to prevent unauthorized access to your SAP Mobile Cards application.

When you set a passcode, anyone trying to access SAP Mobile Cards from your mobile device must enter the passcode. Using a passcode provides additional security to prevent unauthorized access.

Your app passcode is different from your password. A passcode is stored locally on your device and is never shared with the server or any other system. Your password authenticates you against the server so that the app can securely communicate with the server to send and receive data.

The application uses the following default passcode settings:

  • Must be at least eight characters.

  • Must contain at least one uppercase and one lowercase letter.

  • Must contain a special character.

  • Must contain at least one digit.

  • Must contain at least two unique characters.

Note

Your system administrator can override these default settings.

To change, set or disable your passcode, do the following in the Mobile Cards application:

  • Tap the More tab at the bottom-right of the screen

  • Tap Settings

Note

In the Security section of the Settings screen, you'll see options to change your passcode and to turn your passcode on or off. Note that these options can be disabled by your system administrator.

Note

If you want to change your passcode, select the options menu at the upper-right corner of the screen, then select Change Passcode. If you've forgotten your passcode, you must reset the SAP Mobile Cards app in the Android Settings menu.

Enabling Fingerprint Authentication

Enable fingerprint authentication to quickly unlock the SAP Mobile Cards application.

A fingerprint reader built into the Mobile Cards app enable the use of fingerprint authentication for unlocking the SAP Mobile Cards application.

To use fingerprint authentication, make sure you have:

  • A device that supports fingerprint authentication

  • Enabled fingerprint authentication

  • Set a passcode

Note

Your system administrator can choose to disable fingerprint authentication. When disabled, you don't see the option Enable Fingerprint Authentication on your device. Also, if you turn off your passcode, fingerprint authentication is automatically disabled for the SAP Mobile Cards application.

If fingerprint authentication fails, you have two options:

  • Try Again – Allows you to reattempt fingerprint authentication.
  • Enter Passcode – Allows you to enter the passcode to unlock the application.

Customize Notifications

When you're within range of an address that corresponds to a card, or when a future date and time on a card is reached, notifications are sent to your Android phone.

  • Timestamp – a card contains a specific date and time. You automatically receive a notification on the specified date. No permissions have to be enabled to receive timestamp notifications.

  • Location – a card contains an address. When location permissions are enabled, you receive a notification when you are within range of the address. When location permissions are disabled, you don't receive location-specific notifications.

When a card contains both an address and timestamp, and you are within range of the address on the date and at the time specified in the timestamp, you receive a notification for each.

Timestamp-Specific Notifications

Set a timestamp-specific notification for cards that contain future dates and times.

When a card contains a future date and time as part of its data, SAP Mobile Cards automatically creates a reminder notification that doesn't repeat. You can disable reminders at any time.

  1. In the upper-right corner of the card, select the vertical-grip icon.

  2. Select Open Subscription.

  3. Do one of the following:

    • To disable Reminder, move the slider to the left. Do not proceed further.

    • To enable Reminder, move the slider to the right, then complete the below steps.

    • To edit a reminder notification, complete the below steps.

  4. Select bell icon, and choose a date and time.

  5. Select Date, then choose a date.

  6. Select Time, then choose a time.

  7. Select Repeat, and choose one of the following:

    • Never

    • Every Day

    • Every Week

    • Every Month

    • Every Year

Note

For subscriptions with flavors, the reminders can be set by tapping on the bell icon corresponding to that flavor.

Location-Specific Notifications

Set a location-specific notification to be notified when you're within range of the specified address.

To set a location-specific notification, do the following:

  1. In the lower-right corner of the card, select the add icon.

  2. Select menu icon.

  3. Do one of the following:

    • To disable the notification, move the slider to the left. Do not proceed further.

    • To enable the notification, move the slider to the right, then proceed further.

  4. Select bell icon.

  5. Under Location, select Set Location.

    Note

    You can only set the location to your current on.

  6. To set the range (you'll receive a notification if you're within the specified distance from the set location), select the drop-down menu, then choose one of the following:

    • 500 meters

    • 100 meters

    • 10 meters

Note

For subscriptions with flavors, the reminders can be set by tapping on the bell icon corresponding to that flavor.

Android Shake Gesture

Shake your Android phone or tap on the GPS icon to see time- or location-relevant cards, or both, in the SAP Mobile Cards card deck.

The shake-gesture feature detects a timestamp (date and time), an address (location), or both, on cards in a card deck. When location permissions are enabled, and you're within range of an address that corresponds to one found on a card in the deck, the relevant card is shown when you shake your mobile device. No location-specific cards are shown if location permissions are disabled.

If a card contains a timestamp that's within the same day you shake your mobile device or tap on the GPS icon, that is, by 11:59 PM, the relevant card is shown. For timestamps, no permissions have to be enabled for the relevant cards to be shown.

If a card contains both a corresponding address and a relevant timestamp and location permissions are disabled, the card appears based only on the timestamp. If there are no relevant cards when you shake your mobile device, no cards appear.

Adding Widgets for SAP Mobile Cards

Add SAP Mobile Cards widgets to your Android phone's home screen.

  1. Long press on your phone's home screen.

  2. From the widget screen under Mobile Cards, long press on one of the following widgets to add it to your home screen (you can only add one widget at a time):

  3. Deck – Adds the current card deck with cards in the order that they were recently viewed. Once the deck has been added, you can swipe up to see the next card or swipe down to see the previous card. Tap on a card to view it in the SAP Mobile Cards app. You can't resize this widget.

  4. What's New – This content is controlled by your system administrator. This widget updates automatically every 6 hours.

    Note

    To remove a widget, long press on it, then swipe it up towards Remove.

The widgets are updated each time you close the SAP Mobile Cards app (put it in the background). When you deregister the SAP Mobile Cards app, the associated widget prompts you to sign in to SAP Mobile Cards. You can tap on the widget to sign in to the SAP Mobile Cards app.

1
   To remove a widget, long press on it, then swipe it up towards **Remove**.

The widgets are updated each time you close the SAP Mobile Cards app (put it in the background). When you deregister the SAP Mobile Cards app, the associated widget prompts you to sign in to SAP Mobile Cards. You can tap on the widget to sign in to the SAP Mobile Cards app.

1
    To remove a widget, long press on it, then swipe it up towards **Remove**. The widgets are updated each time you close the SAP Mobile Cards app (put it in the background). When you deregister the SAP Mobile Cards app, the associated widget prompts you to sign in to SAP Mobile Cards. You can tap on the widget to sign in to the SAP Mobile Cards app.

Searching for Cards

Search for cards in the SAP Mobile Cards card deck.

  1. In the search field above the card deck, enter your search terms.

  2. Tap Search.

    Note

    If multiple cards contain the same search terms, the search returns all cards that match, regardless of the card group. For example, if you search for customer, every card containing that term is included in the search result.

Subscribing or Unsubscribing to Cards

You can manage what information is stored in the card deck on your Android phone via card subscriptions.

Depending on the card type, you are either automatically subscribed or unsubscribed. For more information about card types, please contact your system administrator.

  1. Tap the add (plus sign) in the bottom-right corner.

  2. Choose an available card subscription, then select one of the following:

    • Subscribe – Activates a subscription. If additional parameters are required while subscribing, you will have to provide the value. If no cards are added to the card deck after you've subscribed, it could be a permissions-related issue. For more information, please contact your system administrator.

    • Unsubscribe – Depending on the card type, all applicable cards are removed from the deck, or the subscription is canceled and the cards remain in the deck. For cards with canceled subscriptions that remain in the deck, go to the back of each card and choose Delete. You can also unsubscribe to, or delete, a card by tapping the menu icon to open the options menu.

  3. (If required) To close the Subscription screen, select the back arrow, then tap the decline (close) button.

    Note

    The front of each card in the deck displays the name of the card subscription it belongs to.

Viewing Cards in a Card Group

View cards that are grouped by card type in the SAP Mobile Cards card deck.

Swipe left to view cards in the group.

Note

Swipe right to make your way back to the first card in the group.

Rearranging Card Groups

Move a card group higher or lower in the card deck.

On the deck screen, touch a group and drag toward the top of the screen to move it higher in the deck or drag toward the bottom of the screen to move it lower in the deck.

Performing Actions From the Card Deck

From the SAP Mobile Cards card deck, quickly perform developer specified actions, call, text, or email a customer, locate an address, share cards, search for related cards, or edit published card content.

Note

Overview Cards support only the Open Details action option. Card type is determined by the template used to create a Fiori application. For additional Information about card types, contact your system administrator.

  1. You can perform actions from the deck screen (i.e., the list of cards) or from the card-details screen.

  2. To show the list of actions from the deck screen, tap the dropdown icon located on the front of a card in the deck.

  3. To get to the card-details screen, tap a card in the deck. To show the list of actions from the card-details screen, tap the menu (options) menu in the top-right of the screen.

  4. Once the list of actions is displayed, perform one of the following actions (if available) by tapping that action in the list:

    • Developer Specified Actions – Card-specific actions provided by the developer. For example, Accept or Reject for new cards added to the card deck. When performing this type of action, a pop-up dialog may appear prompting you to enter information, for example, a reason for rejecting a card.

      Note

      When either the Accept or Reject action is performed successfully, the selected action is grayed out until the next successful application sync, at which time the card may be removed if deleted, or the options reset if accepted.

    • Call – Call a phone number listed on a card.

    • SMS – Send a text message to a phone number listed on a card.

    • Email – Send an email to an email address listed on a card.

    • Open Maps – Get directions to an address listed on a card.

    • Open Details – Edit card content. Opens Fiori launchpad in a Safari browser. See Editing a Card for more information.

    • Search Related Cards – Find cards that share similar information, for example, the same customer name or ID. Unlike using the search field, a related card search only returns exact matches, not partial ones.

    Your system administrator defines which cards are related, and cards can share more than one identifier. For more information, please contact your system administrator.

Sharing A Card

A card can be shared via email with an SAP Mobile Cards. This can be done from the deck screen or from the card-details screen.

To share a card user from the deck screen, tap the share-2 icon.

To share a card from the card-details screen, tap the options menu in the top-right of the card-details screen. The share option appears in the list of options, alongside any available actions and other options.

The email contains a prepopulated link that recipients tap to download the card to their respective devices. If a recipient sees the message You do not have permission to subscribe the card, that person should contact their system administrator. A card can be shared via email with an SAP Mobile Cards. This can be done from the deck screen or from the card-details screen.

1
2
3
4
5
    To share a card user from the deck screen, tap the :f-share-2: icon.

    To share a card from the card-details screen, tap the options menu in the top-right of the card-details screen. The share option appears in the list of options, alongside any available actions and other options.

    The email contains a prepopulated link that recipients tap to download the card to their respective devices. If a recipient sees the message **You do not have permission to subscribe the card**, that person should contact their system administrator.

Performing Card-Specific Actions From Notifications on Your Mobile Device

When a new card is added, a push notification is sent to your Android phone. Once you've received a notification, you can perform actions specified by your system administrator, for example, Accept or Reject a new card.

Note

The card developer controls which cards are actionable.

From the Android notification drawer:

  • From your phone's home screen, swipe down to access the notification drawer.

  • Select a notification.

    Note

    If actions don’t appear automatically, pull down on the notification to expand it. When expanded, you'll see available actions.

  • Perform an available action.

    Note

    For some actions, you may be prompted to enter information, for example, a reason for rejecting a card after performing the Reject action.

From a locked screen or notification banner:

  1. Select a notification.

    Note

    If actions don’t appear automatically, pull down on the notification to expand it. When expanded, you'll see available actions.

  2. Perform an action.


Last update: October 12, 2020