Important Notice

This public repository is read-only and no longer maintained. For the latest sample code repositories, visit the SAP Samples organization.

Integration Between SAP IoT with SAP Field Service Management

Description

This IoT reference application is meant to make it simpler for you to build your own IoT application. It walks you through all of the steps and provides you with all configuration and source code required for you to be able to reproduce the application 1:1.

It features the use of SAP IoT, SAP Field Service Management, and a Web-based UI.

We used Robot4000 at SAP as the example devices to be monitored and facilitate the below usecases.

• Enabling SAP IoT to automatically create the service call in SAP Field Service Management based on the conditions on device measurements and aggregates.
• Enabling Service Technical to access equipment specific content from SAP IoT in SAP Field Service Management Mobile Application (iPhone) from a Service Call view.

Prerequisites

• SAP Cloud Platform Account with a neo sub-account and a cloud foundry sub-account
• A subscription to SAP IoT and an instance of iot (service) for cloud foundry.
• A subscription to SAP Cloud Platform Integration.
• HTML5 Application Repository (SAP Help Portal)
• An optional subscription to SAP Web IDE Full-Stack. WebIDE can be used to build Multi Target Applications ( HTML5, FLP) in almost code less environment and to publish them to Cloud Platform.
• A subscription to SAP Field Service Management License (SAP Help Portal)
• JDK 1.8.0 ( Java Development Kit)

Download

Download the files from GitHub as a zip file, or clone the repository on your desktop.

Installation

Refer to the documentation.

As the source code needs to be deployed in cloud platform account, Please follow the typical approach for managing source code, Building MTA applications and Deploying MTA applications to cloud platform.

Configuration

We provided some example configuration for e.g. the Connected Silo in the source files that might be helpful to get you started. We also illustrated the Thing Model and you can configure it in SAP IoT via the Thing Modeler apps.

Version Compatibility

SAP IoT

Release : 1905

SAP Cloud Platform Integration

Release : 4.0 ( 1904 ).

SAP Field Service Management

• Release : 1905
• Service Call API Version : V2
• Mobile Application Support : iPhone, iOS 12.3.1, Protocal Version : 5
• Coresuite 6.1.1.0
• DTO's
  • Equipment : 17
  • Service Call : 17

SAP UI5

• Release : 1.66.1

HTML5 Application Repository

• Release: 1905

Limitations/ Boundary conditions

• Consumption of SAP IoT content is only supported in FSM Mobile Application of iPhone ( iOS 12.3.1 ).
• All Service Technicians are expected to have same level of authorizations for consuming IoT content
• Role Collection assignments to Service Technicians at Cloud Identity Provider would not have any impact on data authorization while accessing the content from FSM Mobile Application.
• IoT Application used in the Web Container configuration can consume content only from SAP IoT service amd APIs from other business services or other applications can't be consumed.

Documentation

We provided the complete documentation inside docs folder.

• Modeler Configuration
• iFlow Definitions
• One time Setup of Proxy & Approuter
• How to build HTML5 applications from WebIDE
• Simulating Service Call creation through iFlow by Postman collection

Support

The content is provided "as-is". There is no guarantee that raised issues will be answered or addressed in future releases.

License

Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE in this repository.