SAP Asset Manager Installation Guide
SAP Asset Manager Installation Guide
Before you begin reading this guide, be sure that you have the latest version. Find the latest version at https://
help.sap.com/viewer/p/SAP_ASSET_MANAGER.
The following table provides an overview of the most important document changes.
SAP Cloud Platform enables customers and partners to rapidly build, deploy, and manage cloud-based
enterprise applications that complement and extend your SAP or non-SAP solutions, either on-premise or on-
demand.
Note
For more information on prerequisites and procedures for setting up customer accounts on SAP Cloud
Platform, see the topic Getting Started with a Customer Account: Workflow in the Neo and Cloud Foundry
environment.
SAP Cloud Platform is an in-memory cloud platform based on open standards. It provides access to a feature-
rich, easy-to-use development environment in the cloud. The platform includes a comprehensive set of
services for integration, enterprise mobility, collaboration, and analytics.
As a Platform-as-a-Service operated by SAP, our product frees your administrators from any infrastructure and
IT costs and offers state-of-the art quality of service.
Scenarios
Application development
You can use the following programming models to build highly scalable applications:
● Java - SAP Cloud Platform is Java EE 6 Web Profile certified. You can develop Java applications just like for
any application server. You can also easily run your existing Java applications on the platform.
● SAP HANA - you can use the SAP HANA development tools to create comprehensive analytical models and
build applications with SAP HANA programmatic interfaces and integrated development environment.
● HTML5 - you can easily develop and run lightweight HTML5 applications in a cloud environment.
● SAPUI5 - use the UI Development Toolkit for HTML5 (SAPUI5) for developing rich user interfaces for
modern Web business applications.
Solutions
In the context of SAP Cloud Platform, a solution is comprised of various application types and configurations
created with different technologies, and is designed to implement a certain scenario or task flow. You can
deploy solutions by using the Change and Transport System (CTS+) tool, the console client, or by using the
cockpit, where you can also monitor your solutions. To describe and technically realize the solutions, SAP
Introduces the multi-target application (MTA) model. It encompasses and describes application modules,
dependencies, and interfaces in an approach that facilitates validation, orchestration, maintenance, and
automation of the application throughout its lifecycle.
Applications developed on SAP Cloud Platform run in a modular and lightweight runtime container. The
platform provides a secure, scalable runtime environment with reusable platform services.
Virtual machines allow you to install and maintain your own applications in scenarios not covered by the
platform. A virtual machine is the virtualized hardware resource (CPU, RAM, disk space, installed OS) that
blends the line between Platform-as-a-Service and Infrastructure-as-a-Service.
Services
You can consume a set of services provided by SAP Cloud Platform according to the technology you prefer and
the use cases of your scenarios.
SAP Cloud Platform facilitates secure integration with on-premise systems running software from SAP and
other vendors. Using the platform services, such as the connectivity service, applications can establish secure
connections to on-premise solutions, enabling integration scenarios with your cloud based applications.
In-memory persistence
SAP Cloud Platform includes persistence powered by SAP HANA, taking full advantage of its real-time, in-
memory computing technology and built-in analytics.
Secure data
Comprehensive, multilevel security measures have been built into SAP Cloud Platform. This security is
engineered to protect your mission critical business data and assets and to provide the necessary industry
standard compliance certifications.
Free trial
You can start by getting a free SAP Cloud Platform developer license on SAP Cloud Platform Developer Center
that also gives you access to our community and all the free technical resources, tutorials, blogs, support you
need.
SAP Cloud Platform Mobile Services provides services to mobile applications, such as application analytics,
app resources, onboarding, and HTTP/HTTPS configuration.
● Application analytics: Usage statistics that are displayed graphically in the Mobile Services Cockpit
● App resources: Containers of dynamic configurations, styles, or content that are downloaded by native
applications
● Onboarding: Authentication of users who are registering through SAP Mobile Place
● HTTP/HTTPS configuration: Open standards for client communications
● Life cycle management: Managing and deploying multiple versions of an application
● Offline oData service: Optimizes data transport between the back end and the client offline store
● Push notifications: Native notifications sent from back-end systems to the server, which forwards them on
to the clients
● Mobile Services Cockpit: Deploys, manages, and monitors applications
● Supportability: Logs for monitoring system health and troubleshooting
SAP Cloud Platform Mobile Services security enables you to use an on-premise identity management system
for on-demand applications. You can use basic authentication using LDAP, or form-based application
authentication using SAML.
The SAP Cloud Platform SDK includes well defined layers (SDK frameworks, components, and platform
services) that simplify development of enterprise-ready mobile native apps that take full advantage of the
mobile platform features.
The SAP Cloud Platform SDK is tightly integrated with the SAP Cloud Platform Mobile Services Cockpit to
provide the following:
For more information about the SAP Cloud Platform SDK see the following topics, depending on your mobile
client platform:
To install the SAP Asset Manager application, you must follow a specific order for certain steps in the
installation process. Some objects in the installation rely on previously installed objects for IDs or URLs, or
other data.
Use the following high-level process table for information on the process steps to take when installing the SAP
Asset Manager.
Prerequi Before you can install the SAP Asset Manager application,
sites ensure that the following SAP components are installed:
1 Creation or update of SAP Cloud Platform account SAP Cloud Platform Must be first step
administrator
Use the default subaccount or create a subaccount within
your SAP Cloud Platform account.
2 Mobile Add-On for SAP S/4HANA system installation pro SAP S/4HANA admin None
cedure: See Installing the Mobile Add-On for SAP S/4HANA istrator or SAP ERP
(ECC) administrator
Mobile Add-On for SAP ERP system installation procedure
(ECC): See Installing the Mobile Add-On for ERP
3 On-premise Cloud Connector setup. See the Cloud Connec IT administrator Relies on Step 1
tor Installation topic.
4 Create your application in SAP Cloud Platform Mobile Serv SAP Cloud Platform Application connec
ices (SAP Cloud Platform Mobile Services): administrator or Busi tion settings rely on
ness expert Step 2
Set application security settings. For more information, see
the Security Administration topic in the SAP Cloud Platform
Mobile Services guide.
5 Choose to set up or build the mobile application in one of the Administrator Relies on Application
following ways: security settings in
Step 4
1. Set up the mobile application:
○ Obtain onboarding URL and QR code. See the On
boarding to the MDK Client App topic for more in
formation.
2. Build the mobile application (optional):
○ Building the SAP Asset Manager Application Over
view [page 26]
○ Building the SAP Asset Manager Application Client
[page 27]
6 Import the metadata definitions into the SAP Web IDE Business expert Relies on Steps 4–5
7 Launch the SAP Asset Manager application using the on Administrator Relies on Steps 1–6
boarding URL. Navigate through the launch screens and per
form the initial sync.
Read the following SAP Notes before you begin installation. The SAP Notes contain the most recent
information about the installation, as well as any corrections to the installation process.
Make sure you have the most recent version of each SAP Note. Find SAP Notes on the SAP Service
Marketplace at https://sap.com/notes .
2495578 Release Information Note - Mobile Add-On Information and references to additional SAP Notes in
for SAP S/4HANA 1.0 and Support Pack the context of applying the Mobile Add-On for S/
ages 4HANA 1.0 and support packages to an SAP S/4HANA
on premise system
2493602 SAP Asset Manager Mobile Add-On for SAP Release and Information (RIN) note about planning
S/4HANA Installation Master SAP Note the installation and upgrades of the ABAP Add-On for
the SAP Asset Manager application
2566071 SAP Cloud Platform (SCPms) Setup Info for Information on how to set up SAP Cloud Platform Mo
SAP Asset Manager with an SAP S/4HANA bile Services (SCPms) to run the SAP Asset Manager
On-Premise System application
2660862 SAP Cloud Platform (SCPms) Setup Info for Information on how to set up SAP Cloud Platform Mo
SAP Asset Manager with an SAP ERP On- bile Services (SCPms) to run the SAP Asset Manager
Premise System application
2933065 SAP Asset Manager - MDK Support Matrix Detailed information on SAP Asset Manager and Mo
bile Development Kit version compatibility
2970982 MDK App Crash on Launch on Certain iOS Corrects issues with iOS 14 when building an iOS client
14 Devices
You can find additional information for the Mobile Development Kit in the following continually updated blog
post: Latest Mobile Development Kit Blogs and Videos .
The oData service provides a universally available service for the SAP Asset Manager application.
Note
To fully install and run the SAP Asset Manager application, perform the Building the SAP Asset Manager
Application Client [page 27] procedure after performing the tasks in this Deployment and Configuration
section.
● Ensure that an SAP Cloud Platform Mobile Services account with an active mobile services account is
available
● A Cloud Connector is required. For more information, see the Setting up the SAP Cloud Platform Cloud
Connector System Mapping [page 12] procedure.
Software Prerequisites
For all prerequisite and installation information for the Mobile Development Kit, see the https://help.sap.com/
viewer/977416d43cd74bdc958289038749100e/Latest/en-US manual.
The SAP Cloud Platform Cloud Connector serves as the link between on-demand applications in the SAP Cloud
Platform and existing on-premise systems.
For general Cloud Connector set up and configuration, see the SAP Cloud Platform Cloud Connector
documentation, specifically Configure Access Control (HTTP). The following topic addresses specific SAP
Asset Manager Cloud Connector configurations to make in the Cloud Connector cockpit. Perform these
additional configuration modifications after the initial Cloud Connector installation and configuration.
1. Click the Cloud to On-Premise link, and in the Access Control tab, add your on-premise system in your
Cloud to On-Premise mapping as follows:
○ Protocol: HTTPS
○ Back-End Type: ABAP
○ Virtual Host: Your choice
○ Virtual Port Your choice
○ Internal Host: SAP back-end system
○ Internal Port: SAP back-end system
○ Principle Type: X.509 Certificate
To successfully deploy the SAP Asset ManagerSAP Shop Floor Manager application, you must create a
corresponding application in SAP Cloud Platform Mobile Services.
The corresponding application created in SAP Cloud Platform Mobile Services connects a mobile device
application to its corresponding data service on the on-premise back-end servers. There are two corresponding
versions of SAP Cloud Platform Mobile Services: an SAP Cloud Platform Neo environment and an SAP Cloud
Platform Cloud Foundry environment.
Procedure
1. Using theSAP Cloud Platform Cockpit, navigate to the Services Development & Operations tile. If it is
not enabled, enable it. Then click the Go to Service link after clicking on the tile.
The Mobile Service for Development and Operations, or Admin UI view, opens in a new window.
○ If the application metadata is edited to use a different destination name than what is defined in the
assetmanager.service file, the created destination on the SAP Cloud Platform Mobile Services
must also reflect the service name. For more information on where to find application metadata,
see Step 1 of the Building the SAP Asset Manager Application Client procedure.
○ URL: URL to reach the mobile add-on service through the Cloud Connector
○ The URL specified must use the given host name from the virtual host of the Cloud Connector
regardless of port specification.
○ Include the full URL path of the OData service in the URL. All of the resources are specified in the
ICF nodes that the OData service resides under.
○ If the Cloud Connector connecting to the Mobile Development Kit client is configured to use
HTTPS, you do not have to make the HTTPS specification in the URL. Your on-premise
connections through a properly configured Cloud Connector should specify a URL using an HTTP
scheme, with the HTTP port specified.
○ A sample URL is as follows: http://<cloud connector virtual host>:<cloud
connector virtual port> /sap/opu/odata/<mobile add-on component>/<mobile
add-on service>, with MERP an example of <mobile add-on component> and
SAP_ASSET_MANAGER_<version> an example of <mobile add-on service>.
○ Proxy Type: On-premise (Cloud Connector)
○ Maximum Connections: However many concurrent users are expected for your application
connection
○ Timeout: The timeout for each network transmission between the device and back end system.
Settings are based on the following:
○ The expected timeout requirements for the SAP Mobile Add-On for SAP S/4HANA on-premise
connections to SAP Asset Manager is 600,000ms.
○ The expected timeout requirements for the SAP Mobile Add-On for SAP ERP ECC6.0 EHP 7 SP14
connections to SAP Asset Manager is 1,200,000ms.
○ Rewrite Mode: Rewrite URL. Setting must match the mapping in the Cloud Connector
○ If the virtual host and the port in the Cloud Connector are set the same as the internal host and the
port of the SAP Mobile Add-On OData service, you can set the Rewrite Mode to Rewrite URL.
○ If the virtual host and the port in the Cloud Connector do not match the internal host and the port
of the SAP Mobile Add-On OData service, set the Rewrite Mode to Custom Rewrite URL. Setting
the Rewrite Mode to Custom Rewrite URL properly maps the outgoing URLs from the Cloud
Connector.
○ OPTIONAL If the Custom Rewrite URL is set, add an outbound rewrite URL when you create
system mapping. For more information, see the Rewrite Modes topic.
○ Custom Headers: Not applicable
3. Click the Mobile Applications link on the left, then click Native / Hybrid.
4. Click the New button. When the New Application window displays, fill the fields as follows:
○ Config Templates: Select Mobile Development Kit from the dropdown
○ ID: Whatever your administrator wishes to use that is meaningful to them. The ID is used to control
features on the application and is displayed in branded settings on the client.
○ Name: Name of your application
○ Description: Optional description of your application
○ Vendor: Optional name of your vendor
5. Click Save to create the preliminary cloud application, then click the newly created cloud application.
7. Optional: To debug an existing application, click the Client Policies link and ensure the following logs are
enabled:
Set the log levels for the lowest level you wish to see logs. For example:
○ ERROR: Displays only errors
○ PATH: Displays everything that can show up in the logger
8. Click the Connectivity link.
9. Select the Add Destination button ( ). Then select the appropriate destination that you defined in Step 2
of this procedure.
10. Save your changes. Click back to your new application and click the Security link.
Make a note of the following settings, as you need them during the Building the SAP Asset Manager
Application Client [page 27] procedure:
○ Client ID
○ Authorization Endpoint
○ Token Endpoint
13. Click back to the main application page and click the APIs tab. Make a note of the Server setting, minus the
trailing /, as you need it during the Building the SAP Asset Manager Application Client [page 27]
procedure.
Procedure
1. Using the SAP Cloud Platform Cockpit, navigate to the space you want to work in. If mobile services are
already enabled, navigate to a Service Instance and open it.
Note
2. Click the Service link. Follow the navigation, and click Support to open mobile services on Cloud Foundry.
○ If the application metadata is edited to use a different destination name than what is defined in the
assetmanager.service file, the created destination on the SAP Cloud Platform Mobile Services
must also reflect the service name. For more information on where to find application metadata,
see Step 1 of the Building the SAP Asset Manager Application Client procedure.
○ URL: URL to reach the mobile add-on service through the Cloud Connector
○ The URL specified must use the given host name from the virtual host of the Cloud Connector
regardless of port specification.
○ Include the full URL path of the OData service in the URL. All of the resources are specified in the
ICF nodes that the OData service resides under.
○ If the Cloud Connector connecting to the Mobile Development Kit client is configured to use
HTTPS, you don’t have to make the HTTPS specification in the URL. Your on-premise connections
through a properly configured Cloud Connector should specify a URL using an HTTPS scheme,
with the HTTPS port specified.
○ A sample URL is as follows: http://<cloud connector virtual host>:<cloud
connector virtual port> /sap/opu/odata/<mobile add-on component>/<mobile
add-on service>, with MERP an example of <mobile add-on component> and
SAP_ASSET_MANAGER_<version> an example of <mobile add-on service>.
○ Use Cloud Connector: Selected
○ Cloud Connector Location ID: Set to the location ID designated by the Cloud Connector
○ Maximum Connections: However, many concurrent users are expected for your application
connection
○ Timeout: The timeout for each network transmission between the device and back-end system.
Settings are based on the following:
○ The expected timeout requirements for the SAP Mobile Add-On for SAP S/4HANA on-premise
connections to SAP Asset Manager is 600,000ms.
8. Optional: To debug an existing application, click the Enable Detailed Event Log link in the top-right corner of
each feature. Ensure that the logs for the feature are enabled.
9. Save your changes. Click back to your new application and click the Security tab.
Procedure
1. Log in to the SAP Cloud Platform Cockpit and from Home Region , click the Region in which your
account is based.
2. Select your Global Account. From the Global Account page, select the Subaccounts tab on the left side.
Then select the subaccount where you wish to deploy your applications.
3. Find the SAP Web IDE Full-Stack tile. If it is not Enabled, enable it. Then click Go to Service.
The SAP Web IDE prompts to refresh. Refresh the SAP Web IDE to view the new tile.
6. Click the MDK Development icon. If the Mobile Development Kit icon does not appear, ensure it is enabled.
After enabling, refresh the SAP Web IDE.
Next Steps
Proceed to the Importing Metadata Definitions to the SAP Web IDE Mobile Development Kit [page 22]
procedure.
You can import a project and its resources from your local file system to the SAP Web IDE Mobile Development
Kit workspace.
Prerequisites
Ensure that the SAP Asset Manager 2010 and Mobile Development Kit 4.3.2 installation files are downloaded
from the SAP Download Center .
If an earlier version of the Mobile Development Kit is already installed on your back-end system when
compared to your version of the SAP Asset Manager application that you are attempting to install, you must
also import and deploy the current version of the Mobile Development Kit to the SAP Web IDE.
3. Import your project. Select File Import From File System from the main menu. Alternatively, you
can right-click on your Workspace folder and choose Import from the menu choices.
If you decide to leave the folder name as-is, once the import is complete, hit refresh on your browser to
reload the SAP Web IDE. After refreshing, the folder name shows up and correctly matches the Application
Name in your Application.app file.
The project is imported into the selected folder with the same name as the <Import To> field.
Note
If the target folder already exists in your workspace, you’re prompted to approve the overwriting of the
existing files.
Prerequisites
In the SAP Cloud Platform Cockpit, ensure that the mobileservices destination has the additional property of
WebIDEUseage set with the property of mobile.
Once your desired changes to the metadata definitions for the Mobile Development Kit are complete, use the
Mobile Services app development tools deployment feature to deploy the metadata definitions to your
application in Mobile Services. Then, when you change the SAP Asset Manager application, and redeploy the
metadata files in the Mobile Development Kit editor, a timer looks for new definitions within the bundle.
Procedure
Results
The bundle.js is uploaded from the SAP Web IDE to Mobile Services.
Use the following information as a reference when building your application using the procedure Building the
SAP Asset Manager Application Client [page 27].
Structure of .mdkproject
● BrandedSettings.json: Runtime configurations such as security settings, URLs for connecting to the SAP
Cloud Platform Mobile Services, and more
● MDKProject.json: Build time configurations such as the application name, version, and bundle ID
● App_Resources: Any custom resources used by the application, such as all of your action bar images that
are customized for your application.
● demo: To make an OData service available in demo mode, include the .udb and .rq.udb files for that
service in this directory
Currently the SAP Asset Manager application can’t take the demo UDBs created by the most recent SAP
Cloud Platform SDK and use them with an older SAP Cloud Platform SDK version.
Therefore, use the Android UDBs for demo mode, for both the iOS and Android applications. Failure to do
so results in the inability to perform Update or Create OData actions, such as:
○ Changing the mobile status of any work orders
○ Creating reminders
● extensions: Include any extensions used by the application in this directory
● metadata: Built in metadata for the application
The MDKProject.json file contains settings that you can only configure before running the create-
client.command:
● AppName: Determines the name of the application project and the app as it appears on a mobile device
● AppVersion: The client project application version
● BaseProject: The metadata subdirectory under the .mdkproject structure that contains the main
application metadata. The main application metadata is the MDK application, which includes one or more
component MDK applications. The component applications are only required if you are adding
components to your base application, such as Meter Management or Field Operations Worker.
The Mobile Development Kit client tracks several versions, which you can view in the iOS Settings menu. These
versions are identified as the application version, the definitions version, and the frameworks versions for the
frameworks used in the client build.
When generating a client project, you can specify the application version. Specifying the application version
allows you to version the client itself, which can be useful if you change extension controls or other branded
settings. To specify the application version, specify the AppVersion property in the MDKProject.json file
before running create.client.command.
To further customize the entry of your application in the iOS Settings menu, you can manually edit
<ProjectDirectory>/app/App_Resources/iOS/Settings.bundle/Root.plist after the script has
completed. You can add new entries, but do not remove existing entries or the application may not function
correctly.
Deploy SAP Asset Manager from the out of the box configuration to set the cloud endpoint authentication URL
and the OData service URL. You can also set other configuration values.
Prerequisites
● Verify that your system is set up to build the SAP Asset Manager application by running the MDK
Dependencies Installer. This tool detects all the components to install or update, allowing you to update or
install them instantly.
For more information and instructions on how to obtain the MDK Dependencies Installer, see the Building
Your MDK Client SDK procedure.
● Complete the Creating an Application in SAP Cloud Platform mobile services procedure.
Restriction
Develop any customization on the app as a separate component in a Mobile Development Kit project.
Developing customizations as a component makes it easier to maintain customizations during upgrades,
as it isolates custom code. Isolating your custom code eliminates the chance of overwriting when you
implement a new release.
Use the following procedure to build and brand the SAP Asset Manager application.
Procedure
1. Locate the required installation files from the SAP Download Center and navigating to:
Note
For detailed information on SAP Asset Manager and Mobile Development Kit version compatibility, see
2933065 .
See 2970982 for detailed information when building an iOS client using iOS 14.
2. Download the files found in the MDK PLUG-IN SDK folder. Select the correct version for your installation.
Select either iOS or Android, depending on your installation platform.
3. Download the files from either SAP ASSET MANAGER for iOS devices or MOB ASSET MANAGER AND for
Android devices. Select the correct application version folder. In the version folder, download the SDK file
and the metadata files found in the following subfolders:
○ ASSET MANAGER METADATA: SAP Asset Manager
○ ASSET MGR BRANDING SDK: Branding SDK for SAP Asset Manager, Meter Management, Field
Operations Worker, Crew Management, Customer Service, Quality Management, and Asset Central
○ ASSET MGR CREW METADATA: Crew Management
○ ASSET MGR METER METADATA: Meter Management
○ ASSETMGR ASSETCENTRL META: Asset Central
○ ASSETMGR CUSTOMERSVC META: Customer Service
○ FIELD OPS WORKER METADATA: Field Operations Worker
○ ASSETMGR QUALITYMGMT META: Quality Management
4. Create a folder to contain the installation files (SAPAssetManager).
5. Extract the SAP Asset Manager branding SDK:
a. Unzip the ASSET MGR BRANDING SDK folder.
b. Copy the SAPAssetManager/SAM.mdkproject folder to the SAPAssetManager folder.
c. Set up the SAP Asset Manager Mobile Development Kit project folders:
1. In the SAPAssetManager/SAM.mdkproject folder, create a folder named metadata.
2. In the SAPAssetManager/SAM.mdkproject folder, create a folder named extensions.
1. Unzip the iOS subfolder found in the MDK PLUG- 1. Unzip the Android subfolder found in the MDK
IN SDK zip file. PLUG-IN SDK zip file.
2. Choose your architecture from one of the following 2. Copy the following folders from your Universal
folders: folder to the SAPAssetManager/
○ Release-iphoneos SAM.mdkproject/extensions folder:
○ Release-iphonesimulator ○ extension-Analytics
○ Release-fat (contains both the iphoneos and ○ extension-BarcodeScanner
the iphonesimulator architectures)
○ extension-FieldDataCapture
3. Copy the following folders from your selected ar
○ extension-MapFramework
chitecture folder to the SAPAssetManager/
○ extension-HierarchyFramework
SAM.mdkproject/extensions folder:
○ extension-Analytics
○ extension-BarcodeScanner
○ extension-FieldDataCapture
○ extension-MapFramework
○ extension-HierarchyFramework
By default, the Server API has a / at the end of the endpoint URL. Do not add this / into your
connection settings.
○ Neo:
○ AuthorizationEndpointURL: Set to the oAuth authorization endpoint URL that you created in
Step 12 of the Creating an Application in SAP Cloud Platform Mobile Services - Neo [page 13]
procedure.
○ RedirectURL: Set to the callback URL that is automatically generated with the creation of the
oAuth client in Step 12 of the Creating an Application in SAP Cloud Platform Mobile Services -
Neo [page 13] procedure.
○ TokenURL: Set to the token URL that is automatically generated with the creation of the oAuth
client in Step 12 of the Creating an Application in SAP Cloud Platform Mobile Services - Neo
[page 13] procedure.
○ Cloud Foundry:
○ AuthorizationEndpointURL: Set to the oAuth authorization endpoint URL that you created in
Step 11 of the Creating an Application in SAP Cloud Platform Mobile Services - Cloud Foundry
[page 18] procedure.
○ RedirectURL: Set to the callback URL that is automatically generated with the creation of the
oAuth client in Step 11 of the Creating an Application in SAP Cloud Platform Mobile Services -
Cloud Foundry [page 18] procedure.
○ TokenURL: Set to the token URL that is automatically generated with the creation of the oAuth
client in Step 11 of the Creating an Application in SAP Cloud Platform Mobile Services - Cloud
Foundry [page 18] procedure.
b. Choose your client configuration:
To preconfigure your client to connect to your mobile application, add the information retrieved in the
above step to the ConnectionSettings block. When adding additional entries, include a comma after
the existing EnableOverrides entry. An example is included in the table for reference when you’re
adding entries to your file.
If you want to use SAP Asset Manager against different back-end mobile applications (ex: DEV and
QA), leave the ConnectionSettings as is, and build an onboarding URL for users using the values found
in Step 6a. See the example in the table for further information on how to connect a client using either
of the methods.
Note
If you are using the onboarding URL approach, note that all users must recieve an email with the
onboarding URL to connect applications toSAP Cloud Platform Mobile Services.
To configure the client to connect to a specific applica You can generate an onboarding link to overwrite the val
tion, update the following values in the ues discussed in this substep on a device. Use the follow
BrandedSettings.json file: ing format in a URI:
… samclient://?AppId=<Insert AppID
“ApplicationDisplayName": "<Name value here>
of application>", &ClientId=<Insert ClientID value
"ConnectionSettings": { here>
"EnableOverrides": true, &SapCloudPlatformEndpoint=<Insert
"AppId": "<Insert AppID value cloud platform endpoint URL here>
here>", &AuthorizationEndpointUrl=<insert
"ClientId": "<Insert ClientID authorization endpoint URL here>
value here>", &RedirectUrl=<insert redirect URL
"SapCloudPlatformEndpoint": here>
"https://<Insert cloud platform &TokenUrl=<insert token URL here>
endpoint URL here>", &ServiceTimeZoneAbbreviation=<inse
"AuthorizationEndpointUrl": rt timezone abbreviation here>
"https://<insert authorization
endpoint URL here>",
"RedirectUrl": "https:// Save any changes you make.
<insert redirect URL here>",
"TokenUrl": "https://<insert
token URL here>",
"AllowCerts": <true/false>
},
An internet connection is required. If you’re connecting to the internet through a proxy, configure
your settings before running the ./install.command or ./install.cmd command.
Sample Code
on a Mac
$ ./create-client.command
? Enter the path of the .mdkproject directory. ../SAM.mdkproject
Using ../SAM.mdkproject
Using /Users/.../sdk for out directory
? Would you like to build for iOS or Android or All? ios
Building client for ios
? Would you like to build for device or simulator of iOS? device
Building client for device of iOS
Removing existing directory /Users/.../sdk/AssetManager
Creating application AssetManager
Sample Code
on a Windows PC
>create-client.cmd
? Enter the path of the .mdkproject directory. ..\SAM.mdkproject
Using ..\SAM.mdkproject
Using C:\...\mdk for out directory
Building client for Android
Removing existing directory C:\...\mdk\AssetManager
Creating application AssetManager
Results
After create-client.command for iOS or create-client.cmd for Windows finishes, you’re ready to run
the client either on the mobile device or on a simulator.
Next Steps
Prerequisites
You have built and branded the SAP Asset Manager application. For more information, see the following topics:
Context
Note
The following procedure is applicable for iOS installations only. You do not need to perform this procedure if
you are installing SAP Asset Manager on Android.
By default, iOS allows third-party apps to specify a limited set of URI schemes:
● http:
● https:
● mailto:
● tel:
● sms:
● facetime:
Other applications, such as Microsoft Edge, can support custom URI schemes. For example, if the application is
installed, microsoft-edge-https://www.google.com, opens up Google in Microsoft Edge for iOS.
However, it will only work correctly from a non-third-party iOS application such as Safari.
For additional information on iOS URI schemes, see the Launch Services Keys documentation from Apple.
To allow SAP Asset Manager to open custom URIs, use the following procedure.
Procedure
In the following example, the custom schemes microsoft-edge-https and microsoft-edge-http are
added. If Microsoft Edge is installed on the mobile device, these custom schemes allow the client to open
HTTP and HTTPS URLs in Microsoft Edge.
Results
Any custom URL attachments associated with your newly added schemes now open as expected.
The offline OData feature of the SAP Cloud Platform SDK allows for an always-available application that can
respond quickly to changes in its connection state.
Instead of calling OData services directly, the OData service call is redirected to the offline OData feature, which
mimics a response using the latest synchronized data.
Note
The configuration files are always needed, even if you don’t plan to change the default behavior of the
application.
If you change the OData model to add or remove entity sets, update the corresponding configuration file to
reflect the new data distribution rules associated with the model change.
If you change the OData model to add or remove entity sets, update the corresponding configuration file to
reflect the new data distribution rules associated with the model change.
These offline OData settings are created by the corresponding back-end program listed in the Mobile Add-On
Installation guide specific to your back end. As the oData model in the Mobile Add-On Integration Framework
(MAIF) configuration panel changes, the file generated by the program reflects the changes in that system. You
must regenerate the file anytime you change the model.
Additional Information
See the following topics for additional configuration information needed for your offline settings:
● For detailed information on developing and modifying offline applications on the SAP Cloud Platform SDK,
see the following guides:
The INI configuration file found on the SAP Cloud Platform Mobile Services defines the order in which the
defining requests are sent to call entity sets.
Detailed information on the INI configuration file settings are found in the Application Configuration File topic.
Sync Lead
Order # Entity Set Name Batched Priority Entity Type Mobile OData Object Entity
Entity Set Name Sync Priority Entity Type Mobile oData Object Lead Entity
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.