Screen Configuration for Web Apps



Intro

A number of screens in the SAP Field Service Management web applications can be configured and customized according to customer needs.


Configurable Web Screens / Views

The following table shows whether the mobile screen is configurable for the SAP Field Service Management web applications, and whether that configuration can take place using the Screen Configurator tool:

Attention: for screens which cannot be configured using the Screen Configurator feature, custom screen configurations must be created by uploading the changes in JSON format.

Object Code Screen Name Description Configurable Full support in Screen Configurator Location in web App
ACTIVITY CSPlannerAssignment Planner Assignment Web Configure Assignment / Activity on Planning Board on Workforce Management App X X Planning and Dispatching
ACTIVITY CSActivitySidebar Activity Sidebar Web Screen for Activity Sidebar on Planning and Dispatching App X X Planning and Dispatching
ACTIVITY CSMapActivityDetail Activity Detail Map Screen for Activity Details on Map App X X Map
PROJECT / ACTIVITY CSProjectActivitySidebar Project Activity Web Screen for Project Activity Details on Planning and Dispatching App X X Planning and Dispatching / PM
PROJECT CSProjectSidebar Project Web Screen for Project Details on Planning and Dispatching App X X Planning and Dispatching / PM
SERVICECALL CSServiceCallDetail Service Call Web Screen for Service Call Details on Planning and Dispatching App X X Planning and Dispatching
PERSON CSMDMPerson Person Web Screen for Person Details on Master Data Management App X X MDM
ITEM CSMDMItem Item Web Screen for Item Details on Master Data Management App X X MDM

Metadata Object

Attention: The new metadata object is only available for unedited default screen configurations and custom screen configurations created on or following the 6.18.0 release of the Screen Configuration app. For previously-created/edited screen configurations, the new metadata object will not appear in the JSON configuration.

Screen configurations now include a metadata object, which indicates for which client the screen configuration has been made.

The metadata object’s “platforms” attribute supports multiple values. For example, the following array would be valid

"metadata": {"platforms": ["MOBILE_IOS", "MOIBLE_AND"]},

This would indicate that the screen configuration is valid for iOS and Android but not Windows Mobile.


Supported Platforms

When editing or creating screen configurations using JSON files, the following platform values can be paired with the metadata object’s “platforms” attribute:

Platform Description
MOBILE_GENERIC Any mobile platform
MOBILE_IOS Specific for iPhone
MOBILE_AND Specific for Android
MOBILE_WIN Specific for Windows mobile
WEBAPP Web application
GENERIC Could be used by any platform
UNKNOWN No information about the target platform


Editing Screen Configurations

Attention: Before attempting to configure a supported screen, please ensure that you are familiar with the Known Issues and Limitations of the tool.

The following files can be viewed and customized in Admin > Company > Screen Configurations:



Beside the name of the default screen configuration, the supported clients will also be listed:



By pressing the edit icon , the application will redirect to the Screen Configurator tool, where you can add and adjust fields displayed on cards:



When you have completed editing the screen configuration, you can activate it by changing the screen configuration status from Deactivated to Activated in the top pane and clicking the ✔:




Creating Custom Screen Configuration

Attention: Before attempting to configure a supported screen, please ensure that you are familiar with the Known Issues and Limitations of customizing screen configurations in JSON format.

It may be necessary to create a screen configuration using JSON form if the client isn’t supported by the Screen Configurator.

This is done by selecting the default screen configuration you wish to edit from the Screen Configurations list:



You will then copy the JSON contents contained in the Configuration field:



Note: default screen configurations are subject to updates.

Next, you will need to edit the JSON file using a code or text editor.

When you have completed editing the JSON file, you can select the Upload option from the Screen Configurations screen, and selecting the file you wish to upload: