Screen Configuration Android



Intro

A number of screens in the SAP Field Service Android application can be configured and customized according to customer needs.


Configurable Mobile Screens

The following table shows whether the mobile screen is configurable for the SAP Field Service Mobile Android application, 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 iOS Android Windows Full Support with Screen Configurator
Activity ActivityList Activity List Mobile Configuration for Activity List on Mobile X X X X
Activity Activity Activity Details Mobile Screen for Activity Details on mobile X X X X
Expense Expense Expense Mobile Screen for Expense details on mobile X X X X
Mileage Mileage Mileage Mobile Screen for Mileage details on mobile X X X X
Effort Effort Mileage Effort Screen for Effort details on mobile X X X X
Equipment Equipment Equipment Mobile Screen for Equipment details on mobile X X X
Sales Order SalesOrder Sales Order Mobile Screen for Sales Order details on mobile X X X
SalesQuotation SalesQuotation Sales Quotation Mobile Screen for Sales Quotation details on mobile. X X X
SalesOpportunity SalesOpportunity Sales Opportunity Mobile Screen for Sales Opportunity details on mobile. X X X X
ServiceCall ServiceCall Service Call Mobile Screen for Service Call details on mobile. X X X X
ServiceCheckout ServiceCheckout Service Checkout Mobile Screen for Service Checkout details on mobile. X X
VisitorReport VisitorReport Visitor Report Mobile Screen for Visitor Report details on mobile. X
Material Material Material Mobile Screen for Material details on mobile. X X X X
ServiceContract ServiceContract Service Contract Mobile Screen for Service Contract Details on mobile. X X
Person Person Person Mobile Screen for Person details on mobile. X X X
BusinessPartner BusinesssPartner Business Partner Mobile Screen for Business Partner details on mobile. X X X X
Item Item Item Mobile Screen for Item details on mobile. X X X

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: