fiori client features and configuration

PUBLIC

Kevin Bates, Principal Support Engineer IS, SAP

May 18, 2018

Fiori Client Featuresand Configuration

2PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

Overview

▪ Fiori Client features and benefits

Configuration

▪ Basic configuration and setup of application store Fiori Client

Customization

▪ Using custom Fiori Client from SDK and benefits

Troubleshooting

▪ Common issues and solutions when using Fiori Client

Q&A

Agenda

3PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

“Its all about the User Experience. The purpose is to enhance the performance of SAP Fiori Applications, provide enterprise security features, and persistence caching for the mobile device.”

Features and Benefits

5PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

SAP Fiori Client Architecture

6PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

Built with SAP Kapsel

▪ Apache Cordova

– WebView

– Web App

– Plugins

▪ Kapsel Plugins

– Print

– Offline

– Camera

– Push

– InAppBrowser

– CacheManager

Internals

7PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

Features

▪ Native Client – Android, iOS, Windows, Windows Mobile

▪ Extends Cordova

▪ Enterprise Security - SAML, SSO, x.509, authentication, encryption

▪ Client Logging – tracing and troubleshooting

▪ Client Caching – consistent performance

▪ Access to Mobile Device Features – camera, GPS, address book, printer, calendar

▪ Improved performance over browser

▪ Offline

KapselEnterprise Native Client

8PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

“Better to have it and not need it than it is to need it and not have it.”Lonesome Dove

Configuration and Setup App Store

10PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ Android, iOS, Windows, and Windows Mobile

▪ Although not certified with third party, works with Mobile Device Management (MDM) Software– SAP Mobile Secure and Afaria– Mobile Iron SAP KBA 2603000– Airwatch SAP KBA 2369004

▪ Works with SAP Mobile Platform (SMP) or SAP Cloud Platform Mobile Services (SCPms)

▪ Works with SAP Authenticator (SSO Configuration)

▪ MDM Configuration https://blogs.sap.com/2016/11/10/sap-fiori-client-sp13/#mdm

▪ Multi-user support, supports VPN (not VPN app wrapping), Direct, Proxy, SAP Mobile Platform, SCPms

Prebuilt Fiori Client from OS Application Store

11PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ https://host/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html or QR Code

▪ appID – Identifies application to datavault

▪ fioriURLIsSMP – true/false

▪ nobridgewhitelist – Additional domains that can access plugins beside URL domain

▪ multiuser – true/false

▪ enableCacheManager – true/false

▪ allowSavingFormCredentials – true/false, requires passcode

▪ skiphomebuster – true/false, avoids sending homebuster request which could cause proxy issues

Key Configuration Parameters

12PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

“The most effective way to do it, is to do it.”Amelia Earhart

Custom Fiori Client and Benefits

14PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ SAP Mobile Platform SDK latest release

▪ SAP Mobile Platform (optional)

▪ SAP Cloud Platform mobile Services (optional)

▪ Access to Fiori URL

▪ GIT (optional)

▪ MAC xCode (iOS)

▪ Visual Studio 2015 (Windows)

Custom Fiori Client Software Requirements

15PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ Android SDK/Studio (Android on Windows or MAC)

▪ Latest Java 8 SDK (Android)

▪ Gradle (Android)

▪ Node.js (LTS Support)

▪ Apache Cordova

▪ Setup is documented here:

– https://blogs.sap.com/2016/10/20/getting-started-kapsel-part-1-sp13/

Custom Fiori Client Software Requirements

16PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

1. Configure environment and download required software

2. Edit config.json for project defaults

3. Use node/npm to run create_fiori_client.js

4. Edit appConfig.js as required

– URL, passcode policy, parameters

5. Build and run Fiori Client

– Cordova run <platform>

6. See details here:

– https://blogs.sap.com/2016/11/10/sap-fiori-client-sp13/

Custom Fiori Client Step Overview

17PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ Branding Fiori Client for company

▪ Changing App Name, Icon, Splash Screen

▪ Custom background image

▪ Modifying status bar

▪ Hiding/unhiding screens, disabling screen capture

▪ Preconfigure URL or MDM integration

▪ X.509/Custom certificate Provider

Benefits and Customizations

18PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

“Quality is not an act, it is a habit.”Aristotle

Issues and Solutions

20PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ #1 issue is Certificates and security

– Not using Enterprise certificates

– Missing Root CA on Device

– Netweaver or Web Dispatcher has verify_client default (1 instead of 0)

– Certificate not trusted

Common Issues and Solutions

▪ #1 issue is Certificates and security

– Mutual Authentication certificate not on device or iOS keychain

– Self signed certificate

– Negotiate/SPNEGO not supported with Fiori Client

– Incorrect credentials

– IDP configuration or not whitelisted

21PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ MDM Issues

– Incorrect Configuration on MDM Software

– MDM can be different in iOS, Android, Windows

– App wrapping with MDM VPN solution

– Unsupported MDM solution

Common Issues and Solutions

▪ Other issues

– HTTP 404 or 500 from Proxy - skiphomebuster

– Unable to change Fiori URL on custom/MDM

– Deeplinks – app or OS specific

– Attachments and InAppBrowser

– BI Launchpad does work

22PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ Other Issues

– Old versions of OS (Android, iOS, Windows)

– Firewall

– Web Gui and Web Dynpro Applications

– Offline – Fiori Apps Library

Common Issues and Solutions

▪ Other issues

– SAP Authenticator Configuration BC-IAM-SSO-OTP

– Mime Type not supported

– savingFormCredentials

– Facial Recognition - iOS

– Multiple devices – same user

23PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ Fiddler

▪ Requesterly

▪ Vysor

▪ Getting started with Kapsel

– https://blogs.sap.com/2016/10/20/getting-started-kapsel-part-1-sp13/

▪ Building Custom Fiori Client

– https://blogs.sap.com/2016/11/10/sap-fiori-client-sp13/

▪ SAP Help Portal Fiori Client

– https://help.sap.com/viewer/p/SAP_FIORI_CLIENT

▪ Feedback on App Store

Useful Links and Tools

24PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

▪ SAP Fiori Client for Android

– https://answers.sap.com/tags/67838200100800006537

▪ SAP Fiori Client for iOS

– https://answers.sap.com/tags/67837800100800007345

▪ SAP Fiori Client for Windows

– https://answers.sap.com/tags/73555000100800000162

▪ SAP Fiori Client for Windows Phone

– https://answers.sap.com/tags/73555000100800000152

SAP Community Tags

25PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

“Accept the challenges so that you can feel the exhilaration of victory.”George S. Patton

Question and Answer?

27PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

“Keep your eyes on the stars and your feet on the ground.”Theodore Roosevelt

Insert page title (sentence case)

28PUBLIC© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ

Overview

▪ Fiori Client features and benefits

Configuration

▪ Basic configuration and setup of application store Fiori Client

Customization

▪ Using custom Fiori Client from SDK and benefits

Troubleshooting

▪ Common issues and solutions when using Fiori Client

Q&A

Review

Thank you.

Contact information:

Kevin Bates

Principal Support Engineer IS

k.bates@sap.com

SAP