Shared Devices Support¶
Introduction¶
The SDK frameworks support the onboarding of multiple users in the same native application where the pending changes from previous users are allowed to be uploaded even after the user switch. Developers can either use SAP BTP SDK Assistant for iOS to enable the Shared Devices feature, or the administrator can enable the feature in the mobile services cockpit
!!! Note Currently Shared Devices support is only present for native applications that make use of Offline OData.
Procedure¶
Use this page to configure Shared Devices from SAP BTP SDK Assistant for iOS.
Go to the mobile services cockpit and select your app from the app list. Click Mobile Settings Exchange in the assigned features list.
Verify that the Allow Upload of Pending Changes from Previous User (Enable Multiple User Mode) flag under the Shared Devices section of Mobile Settings Exchange feature is enabled.
Generated App¶
The generated client application from the SAP BTP SDK Assistant for iOS that has the Allow Upload of Pending Changes from Previous User (Enable Multiple User Mode) flag enabled in mobile services cockpit provides complete create-read-update-delete (CRUD) access to the OData service data behind the selected app of the mobile services cockpit. It includes the Fiori logon screens for onboarding as well as the OData and Foundation libraries that are used to consume the service.
The generated client app will have the code required to support multi-user mode, including a User Mode key in the AppParameters.plist with the value, Multiple.
<key>User Mode</key>
<string>Multiple</string>
Onboarding Flow¶
The onboarding process is the same as for single-user mode, except that no biometric authentication screen is shown. This feature is supported for OAuth2, SAML, Basic, or no authentication.
After authentication, each user of the app receives the client-side configuration policy from the mobile services cockpit containing the required passcode policy. If the app requires passcode protection, then the Create Passcode and Verify Passcode screens are displayed.
After a passcode is created, the logon flow is complete. The app then displays the entity set list.
After onboarding, if the app is put in the background and brought back, in multi-user mode there will now be a Switch or Add User button at the bottom of the screen.
When the user clicks the button, the user list is displayed. The user can either select an existing user from the list or click the ADD USER icon at the top right of the screen. This will start the onboarding process for the new user.
