Configuring the Mobile Application Integration Framework

Objective

After completing this lesson, you will be able to configure MAIF

SAP Service and Asset Manager Configuration Changes in MAIF

Mobile Application Integration Framework (MAIF) provides a highly customizable framework for managing data synchronization between SAP systems and mobile devices. In this section, we look at some of the common configuration changes when implementing standard SAP Service and Asset Manager.

1. Adjust Data Distribution Rules in oMDO Configuration (Mandatory)

Tools – IMGMobile Application Integration Framework ConfigurationoData Integration SettingsoData Mobile Data Object Definition.

  • Work Order Data Distribution

    Configuration Settings: Work Order Data Distribution

    Configuration SettingChange Description

    oMDO ‘SSAM2205_WORK_ORDER_GENERIC’ operation ‘READ’ filter ‘WO_ASSIGNMENT_TYPE

    Select one of the supported work order assignment type, based on customer’s work management business process.

    oMDO ‘SSAM2205_WORK_ORDER_GENERIC’ operation ‘READ’ filter ‘ORDER_TYPE

    If customer server order data distribution is required, enable filter handler rule with input parameter ‘CS.’

    Other filters

    Add or adjust filter rules for extra restriction of data distribution of work order.

    For more details, refer to the SAP Help Portal: https://help.sap.com/viewer/f15c174c3c3647088d38fb220e42c006/2005/en-US/a136bfef81f94989ba5eb9fa7f130754.html

  • Notification Data Distribution

    Configuration Settings: Notification Data Distribution

    Configuration SettingChange Description

    oMDO ‘SSAM2205_NOTIFICATION_GENERIC’ operation ‘READ’ filter ‘NOTIF_ASSIGNMENT_TYPE

    Select one of the supported notification assignment type based on customer’s work management business process.

    oMDO ‘SSAM2205_NOTIFICATION_GENERIC’ operation ‘READ’ filter ‘NOTIF_TYPE

    If customer service notification data distribution is required, enable filter handler rule with input parameter ‘CS.’

    Other filters

    Add or adjust filter rules for extra restriction of data distribution of notification.

    For more details, refer to the SAP Help Portal: https://help.sap.com/viewer/f15c174c3c3647088d38fb220e42c006/2005/en-US/d132db00048f42f185187e7f6933a2cf.html

2. Select Document Management Service (Optional)

Tools – IMGMobile Application Integration Framework ConfigurationoData Integration SettingsoData Mobile Data Object Definition.

SAP Service and Asset Manager can support attachment management using SAP Document Management System (DMS), SAP Generic Object Services (GOS), or SAP Business Document Service (BDS). Select the relevant document service.

Settings: Attachment Management

Configuration SettingChange Description

oMDO ‘SSAM2205_DOCUMENT‘ operation ‘READ’ filter ‘DOCUMENT_SWITCH

Adjust the relevant document service for each type of objects (PM work order, PM notification, service order, service notification, Functional Location, Equipment.

oMDO ‘SSAM2205_WORK_ORDER_GENERIC‘ operation ‘READ’ filter ‘ABS_DOC_TYPE

Adjust the relevant document service for work order.

oMDO ‘SSAM2205_NOTIFICATION_GENERIC‘ operation ‘READ’ filter ‘ABS_DOC_TYPE

Adjust the relevant document service for PM notification.

oMDO ‘SAM2005_EQUIPMENT‘ operation ‘READ’ filter ‘ABS_DOC_TYPE

Adjust the relevant document service for equipment.

oMDO ‘SSAM2205_FUNCLOC‘ operation ‘READ’ filter ‘ABS_DOC_TYPE

Adjust the relevant document service for functional location.

oMDO ‘SSAM2205_DOCUMENT ‘ operation ‘CREATE_MEDIA’ filter ‘DOCUMENT_SWITCH

Adjust the relevant document service for each type of objects (PM work order, PM notification, service order, service notification, Functional Location, Equipment.

oMDO ‘SSAM2205_DOCUMENT‘ operation ‘CREATE_MEDIA’ filter ‘OBJECT_DOC_TYPE.’

Specify document type, storage category for different business objects, such as equipment (EQUI), functional location (FLOC).

3. Define ESRI Map Control Setting (Optional)

Tools – IMGMobile Application Integration Framework ConfigurationoData Integration SettingsoData Mobile Data Object Definition.

SAP Service and Asset Manager supports ESRI map control on mobile client. ESRI license is not included with SAP Service and Asset Manager license. Customer must have a valid ESRI license to use the ESRI map functionality.

Settings: ESRI Map Control

Configuration SettingChange Description

oMDO ‘SSAM2205_GIS_MAP_CONTROL’ operation ‘READ’ filter ‘INI_PARAMETER

Find row with param. Group = ‘CONFIG’, param. Name = ‘EsriClientID’, specify ESRI Client Id using customers’ ESRI GIS license.

 

Find the row with parent param. Group = ‘BASEMAP’, param. Group = ‘1’, param. Name = ‘name’, specify a valid ESRI base map name.

Repeat for param. group 2~4.

 
  • Find row with parent param. Group = ‘FEATURELAYER’, param. Group = ‘1’, param. Name = ‘name’, specify a valid feature layer name.

  • Find the row with parent param. Group = ‘FEATURELAYER’, param. Group = ‘1’, param. Name = ‘URL’, specify a valid URL for the feature layer.

Repeat for param. group 2~4.

4. Choose PM Confirmation for time recording (Optional)

Tools – IMGMobile Application Integration Framework ConfigurationSystem SettingsDefine Mobile Applications.

SAP Service and Asset Manager supports time recording using either PM confirmation or CATS timesheet. Only one option can be enabled on the client, not both. By default, CATS timesheet is enabled by standard SAP configuration.

Enable PM confirmation and disable CATS timesheet using mobile application definition parameters setting.

Settings: PM Configuration

Mobile App Parameter

Change Description

Mobile application ‘SAP_SERVICE_AND_ASSET_MANAGER_2205,’

parameter group ‘TIMESHEET’, parameter name ‘Enable

Set the parameter value to ‘N.’

This disables CATS timesheet on the client.

Mobile application ‘SAP_SERVICE_AND_ASSET_MANAGER_2205,’

parameter group ‘PMCONFIRMATION’, parameter name ‘Enable

Set the parameter value to ‘Y.’

This enables PM confirmation on client.

5. Enable Mobile Status Lifecycle Management for Local Object (Optional)

Tools – IMGMobile Application Integration Framework ConfigurationSystem SettingsDefine Mobile Applications.

By default, work orders or notifications created from SAP Service and Asset Manager mobile client must be posted to SAP system first, before any work can be recorded against them, such as START the work order or notification.

If customer business process requires that mobile user can START work on locally created work order or notification without first post to the SAP back-end system, make the following change to enable the process on SAP Service and Asset Manager client.

Settings: To Start Processes Locally

Mobile App Parameter

Change Description

Mobile application ‘SAP_SERVICE_AND_ASSET_MANAGER_2205,’

parameter group ‘MOBILESTATUS’, parameter name ‘EnableOnLocalBusinessObjects

Set the parameter value to ‘Y.’

6. Notification Catalog Type Adjustment (Optional)

Tools – IMGMobile Application Integration Framework ConfigurationSystem SettingsDefine Mobile Applications.

  • Define Custom Notification Catalog Type

    By Default, SAP Service and Asset Manager supports standard catalog types such as A–Activities, B–Object Parts, C–Defects, ans so on. However, customers might have configured some custom catalog types and want to incorporate them into the mobile application. See the following sample.

    Screenshot of the Moblie Application Info screen. The Parameters tab is selected.

    Settings: Define Custom Notification Catalog Type

    Mobile App Parameter

    Change Description

    Mobile application ‘SAP_SERVICE_AND_ASSET_MANAGER_2205,’

    parameter group ‘CATALOGTYPE’, parameter name with pattern ‘CatType<activity>

    Find the parameters, adjust parameter name and parameter value based on desired catalog type following the naming convention ‘CatType<activity>’, or add a new parameter record with custom catalog type.

  • Change Catalog Profile Selection Order

    Settings: Change Catalog Profile Selection Order

    Mobile App Parameter

    Change Description

    Mobile application ‘SAP_SERVICE_AND_ASSET_MANAGER_2205’,

    parameter group ‘CATALOGTYPE’, parameter name ‘CatalogProfileOrder

    Change selection order in parameter value.

Log in to track your progress & complete quizzes