SAP Fieldglass

SAP Fieldglass is a Software-as-a-Service solution that offers services for external workforce management and services procurement. SAP Fieldglass integrates seamlessly with SAP on-premise solutions via webservices, SAP PI or SAP Cloud Platform Integration.

Technical Prerequisites

The following technical prerequisites have to be met in order to monitor this scenario:

  • To collect single exceptions in the SAP Fieldglass you need at least SAP Solution Manager 7.2 SP08
  • To create alerts via Web Service Monitoring you need at least SAP Solution Manager 7.1 SP14
  • Import Cloud Service SSL Certificate into SAP Solution Manager

Import Cloud Service SSL Certificate

In the context of Hybrid Scenarios, data collectors are connecting from Solution Manager to the Cloud Service provider in order to collect exceptions and/or statistical data. To allow this outgoing connection from Solution Manager, the SSL Certificate of the Cloud Service provider has to be imported in Trust Manager (STRUST).

  1. Open the cloud service URL in your web browser.
  2. Click on the padlock next to the Cloud Service URL (within the address input field).
  3. When using Firefox, click on ‘Show Connection details', ‘More Information', 'View Certificate' and select the ‘Details' tab.
  4. When using Microsoft IExplorer, click on ‘View Certificate' and select the 'Certificate Path' tab.
  5. When using Google Chrome, click on ‘Certificate' and select the 'Certificate Path' tab.
  6. In the displayed certificate hierarchy select the Certification Authority (CA) certificate you plan to trust.
  7. When using Firefox, press ‘Export…'.
  8. When using Microsoft IExplorer or Google Chrome, press ‘View Certificate' and in the displayed pop-up navigate to the ‘Details' tab, to press ‘Copy to File…'.
  9. Select an export format you would like to use and that is supported by STRUST transaction, and export the certificate.
  10. Now, log on to SAP Solution Manager and go to transaction STRUST.
  11. Switch to Edit.
  12. Double click on entry 'SSL client SSL Client (Anonymous)'.
  13. Import the previously exported CA certificate, by pressing – within section ‘Certificate' – the icon ‘Import Certificate'.
  14. Press ‘Add to Certificate List'.
  15. Finally ‘Save' this modification.

Available Monitoring Content

Fieldglass integration happens in two ways, batch integration and real-time integration. Batch integration is mainly used for master data like user data, organizational data and so on. Real-time event-driven integration is used for data that needs to be exchanged, based on workflows and in real-time like work orders, invoice etc.

The following SAP Fieldglass scenarios are currently covered in public cloud operations with SAP Solution Manager:

  • Subscription Activity: Errors that happen during the data exchange for the batch integration
  • Integration Audit Trail: Errors that happen after the delivery during the data consumption
  • Real-time Event-driven data: Errors that happen during the data exchange of workflow based information

SAP Fieldglass integrates with on premise systems via different technologies. Depending on which one you use for your scenario you have to also monitor the integration solution to ensure end-to-end monitoring coverage for the cloud scenario.

The following integration scenarios are possible (and which monitoring objects they have):

  1. Integrating ABAP backend with the SAP Fieldglass in a direct connectivity scenario: 1, 5
  2. Integrating ABAP backend with the SAP Fieldglass mediated via SAP CPI: 1, 3, 5
  3. Integrating ABAP backend with the SAP Fieldglass mediated via SAP PI (Web Service based): 1, 2, 4, 5

Please, select...

For the SAP Fieldglass scenario the following monitoring content is relevant (depending on you integration solution):

Scenario Component Monitoring Object Description Monitoring Template Since SP
On premise  Web Service  Web Services exposed on the ABAP on-premise system used by the SAP Ariba Network scenario. This template is also used to monitor the number of application log errors for the integration add-in. Web Services ABAP 7.1 SP05*
On premise ABAP Proxy Messages in error status in the ABAP proxy framework

Process Integration (PI - ABAP only)

7.1 SP12
Integration Exceptions in SAP CPI  Exceptions in integration flows in SAP Cloud Platform Integration  Cloud (SAP HCI) 7.1 SP12*
Integration PI Messages Errors in PI message send via SAP PI

Process Integration (PI)

7.1 SP12
Cloud Exceptions in SAP Fieldglass Errors that occur in the SAP Fieldglass Cloud (SAP Fieldglass) 7.2 SP08

*) Monitoring content was extended with later support packages (see monitoring template page for details)

For setup information for the single monitoring templates other than Cloud (SAP Fieldglass) please refer to the detail pages for the respective template which you can reach from the https://support.sap.com/en/alm/solution-manager/expert-portal/monitoring-of-integration-scenarios.html start page.

When you set up the exception collection and monitoring you first need to know or identify with PI services, Web Services or SAP CPI iFlows are relevant for each scenario. You can find the setup information and also the relevant web service proxies here: https://api.sap.com/package/SAPS4HANAintegrationwithSAPFieldglass?section=Overview

More information and business process models can be found here: https://rapid.sap.com/bp/#/BP_S4H_FG

Metric Name Description MAI Category Since SP
Single exceptions in SAP Fieldglass

Single exceptions detected in SAP Fieldglass.

Exceptions are retrieved via the Solution Manager Monitoring API from SAP Fieldglass into central Exception Management in SAP Solution Manager.

Exceptions 7.2 SP08 

Configuration

Please, select...

Step 1: Define Cloud Service in SAP Solution Manager

To create the required cloud service in SAP Solution Manager, you shall first request a production access to the SAP Fieldglass Web Service API, following these guidelines:

Maintain Fieldglass Partner

To connect to Fieldglass via any API you need to have a Fieldglass Partner Key. Usually you get this partner key as soon as you integrate with Fieldglass via any WebService API. In most cases this is already done during the Fieldglass Implementation. You can use this same partner key for the Solution Manager integration.

If you didn't integrate via an WebService API with Fieldglass but instead e.g. use file integration, you might not have a Fieldglass partner key yet. To request a partner key for the Solution Manager Integration you can either create a ticket with the SAP Fieldglass Service Desk or contact your Account Service Representative.

You need the following information to create the SAP Fieldglass cloud service:

  • Customer ID: Your customer ID

  • Application Key: Fieldglass Partner Key

  • User: User for login

  • Password: Password for the user

  • Fieldglass API Root URL: Your Fieldglass tenant URL (e.g. https://xxx.fgvms.com)

     

Release Restriction!

Note that you need at least SAP Solution Manager 7.2 SP08 to set up and use the cloud service for SAP Fieldglass.

The Cloud Services configuration is now accessible from the SAP Solution Manager Configuration (SOLMAN_SETUP) → Managed Systems Configuration → Tab 'Cloud Services'.

Create Cloud Service:

  1. Select 'Cloud Service Operations' → Create Cloud Service
  2. Select Service Type: 'SAP Fieldglass' from the drop-down list.
  3. Define Service:
    • Customer ID: Enter your customer ID
  4. Define Root URL: Enter the <Main URL> as Fieldglass API Root URL.
    • You can also adjust the extended service ID (The ID used as SID in LMDB) here.
  5. Confirmation: Check your input values and click 'Finish'

The second step is to create the end-point for the cloud service.

Create the End-Point:

  1. Select your SAP Cloud Platform cloud service from the list and click 'Configure Cloud Service' 
  2. Configure Endpoints: Click the 'Add' button on the 'HTTP Endpoints' tab.
  3. Enter the following information:
  • Description: A meaningful description
  • OAuth URL: Extend your Fieldglass URL with /api/oauth2/v2.0/token?grant_type=client_credentials&response_type=token
  • Application Key: <Application Key>
  • User: <user>
  • Password: <password>
  • If necessary add proxy information to connect to SAP Fieldglass

Step 2: Configure Exception Management

For SAP Fieldglass you have to set up the exception store for the exceptions occurring in SAP Fieldglass.

Exceptions in SAP Fieldglass 

Please note that you need SAP Solution Manager 7.2 SP 08 to set up this exception store.

To access the Exception Management setup please go to transaction SOLMAN_SETUP → Application Operations → Exception Management 

  1. In the step 'Define Scope' select the tab 'Cloud Services' and your SAP Fieldglass cloud service. If you didn't configure the system before make sure to select 'All Cloud Services' in the view drop-down. Click on 'Configure' or click 'Next' two times. You will enter the step 'Exception Configuration'.
  2. Click 'Add / Configure Log Store'. Select either 'SAP Fieldglass from FGSAPT (INTEGRATION)' or 'SAP Fieldglass from FGSAPT (SUBSCRIPTION)'. Select the correct end-point for SAP Fieldglass if you have more than one.
  3. Select the fields for filtering for your log store.  The following filter fields are available:
    • Activity: Upload or Download (select from the drop down box)
    • Message: Filter on the server message
  4. Maintain the filter values for the fields in the Filter Definition panel under the log stores table. You can also add, remove or change filter fields and values later on in the area. You can use different operators for your filter value. You can add more than one filter field combination per log store. To add an additional filter field combination click on the button 'Add Filter' in the 'Configured Log Stores' panel.
  5. Once you are done with the Log Store setup click 'Save'
  6. If you click 'Next' you go to the alert configuration. Don't activate alerts here. The alert configuration is done in the 'Interface and Connection Monitoring' described in the next section.

Step 3: Configure Interface and Connection Monitoring

The last step is the configuration of Interface and Connection Monitoring. The Interface and Connection Monitoring setup can be accessed via SAP Solution Manager Configuration (SOLMAN_SETUP). 

To access the Integration Monitoring setup please go to SAP Solution Manager Configuration (SOLMAN_SETUP) → Application Operations → Integration Monitoring → Interface and Connections.

If you didn't perform the infrastructure configuration yet, please follow the Interface and Connection Monitoring Setup with SAP Solution Manager 7.2.

Configuration for Monitoring Template: Web Services ABAP

This monitoring template is used to monitor the performance and for exceptions happening in the Web Service communication between the SAP on-premise system and SAP Fieldglass or SAP Cloud Platform Integration integrating SAP on-premise or SAP Ariba with Fieldglass.

For detailed setup information how to set up this channel type please refer to the Interface and Connection Monitoring wiki for configuration of Web Service Channels. You can use the template Web Services ABAP (SOAP) or Web Services ABAP (STAD) for the monitoring. Please note if you use the Web Services ABAP (SOAP) template you must activate the Web Service performance monitoring in the ABAP system as per SAP Note 1639329.

Configuration for Monitoring Template: Cloud (SAP Fieldglass)

Please note that you can only set up this channel if you run at least SAP Solution Manager 7.2 SP 08. With this template you can monitor exceptions happening directly in SAP Fieldglass.

Navigate to the step 'Define Scope'. You can create a new scenario for the SAP Fieldglass monitoring or use an existing one. Make sure the on premise system for the SAP Fieldglass scenario and the Cloud Service created for SAP Fieldglass are part of the Interface and Connection Monitoring scenario. If you use the integration via SAP CPI this cloud service should be added as well.

Create the Interface Channel:

  1. Select the scenario and click 'Next'
  2. In step 'Preparation' perform all relevant manual activities and run all automatic activities.
  3. In step 'Configuration' click the 'Add' button.
    • Channel Name: Enter a meaning full name (max. 30 characters)
    • Type: Select 'Cloud'
    • Monitoring Template: Select 'Cloud (SAP Fieldglass)'
    • Description: Enter a description for the channel
  4. Click Next.
  5. Source type:
    • If the source system is the on premise system, please select 'Technical System'
    • If the source system is the SAP Fieldglass cloud service please select 'External Service'
  6. Source: Select the on premise system resp. the SAP Fieldglass Cloud Service from the drop-down list
  7. Target Type:
    • If the target system is the on premise system, please select 'Technical System'
    • If the target system is the SAP Fieldglass cloud service please select 'External Service'
  8. Target: Select the on premise system resp. the SAP Fieldglass Cloud Service from the drop-down list
  9. The measuring point is selected automatically
  10. If more than one client are connected for the on premise system please select the correct client for the monitoring
  11. Click Next.
  12. Click Finish.

Maintain the Interface:

  1. The interface channel type does not have any configurable parameters.

Select Metrics:

  1. On the tab 'Metrics' select the metrics you want to monitor

  2. Enter Metric Parameters:

    • Parameter Set Name: Enter a name for the set of metric parameters

    • Activity: Choose Upload or Download.
    • Category: Choose 'SAP Fieldglass Subscription' or 'SAP Fieldglass Integration'
    • Message: Filter in the server message
    • Type: Filter on the transaction type (e.g. SAPBusinessPartnerPush)

  3. Save your interface channel by clicking on the 'Save' button. 

The filters applied here allow you to filter the exceptions collected by the Exception Management further. However if the filter in Exception Management already removes an exception and it is not collected in the central exception store, you will not be able to find it with a filter here!

You can maintain attributes as described in the Interface and Connection Monitoring Setup on the tab 'Attributes'.

Thresholds and the collection schedule are maintained in the next step of the guided procedure. Once you have maintained all your channels, click 'Next' in the main guided procedure to move to the step 'Activation'.

Maintain Thresholds and Schedule:

  1. Select the Alert for the SAP Fieldglass channel (the alert is the line with the red flash icon next to it)
    • On alert level you can maintain notification and incident message creation
    • Do not remove the flag for 'Do not Group Individual Occurrences' as this flag ensures that an alert is created for each exception
  2. Select the Metrics
    • You can adjust the thresholds on the tab Thresholds.
    • Do not change the data collector type or data collector name on the tab 'Data Collection' as the monitor will not work anymore if this is changed.
    • Only change the collection interval if you know what you do or if advised to do this by SAP.
  3. Click 'Apply and Activate' → <Choose one option> to activate the monitoring

 If not active you can also activate the reporting for the channels by checking the box in the column 'Reporting'. This way you can see a history of the number of exceptions that happened and also place the metric on the OCC Dashboard in Focused Insights.