Technical Articles
SAP Geographical Enablement Framework (SAP GEF) – Technical Setup on SAP S/4HANA
Introduction
In this blog post I describe the steps I followed to prepare an SAP S/4HANA 1909 system for SAP Geographical Enablement Framework (SAP GEF) functional configuration. This blog post only addresses the technical pre-requisites to be able to handover to an EAM consultant for GEF configuration.
References
Geographical Enablement Framework 1909 FPS02 (May 2020)
Creating a Connection Between Enterprise Search and SAP HANA
Reference Note (requires a access to SAP ONE Support Launchpad):
2878649 – HANA Update to 1909 Fix for Data Type Date Fields Update
Software Installation
ABAP Layer
Addon
Component | Release | Current SP | Target SP | Password | Add-On Installation |
UIGEF001 | 100 | N/A | 7 | N/A | SAPK-100AGINUIGEF001 |
SAP HANA
HCO_GEF_DATA 100 Deployment Unit
SAP Notes
Install the following notes using transaction SNOTE ensuring manual actions are also performed where necessary:
2835403 | GEF Explorer Get Metadata Fields Without Domains | CA-EPT-GEF |
2922384 | GEF Explorer – UI Update fixes when moving map | CA-EPT-GEF |
2940000 | GEF REST Services and API Corrections | CA-EPT-GEF |
2959177 | GEF Fix Outstanding REST Issues | CA-EPT-GEF |
2962542 | GEF UI Fixes and Italian language support | CA-EPT-GEF |
2983640 | GEF Fix Search by Date Issue | CA-EPT-GEF |
SAP HANA User Provisioning
User: GEF_USER
Roles: sap.gef.data::gef_user AND sap.gef.data::gef_admin
Help Page:
Service Roles and Authorizations in SAP HANA Platform
User: ESH_USER
Role: This user must be assigned the object authorizations sys.trexviadbsl and sys.trexviadbslwithparameter. The database user also needs authorization to execute the following SQL commands on the SAP database schema (SAPSID): SELECT, INDEX, ALTER
NOTE: Set passwords to never expire, once created can you please email me with the passwords
Create DBCO Entries
GEF Connector
DB Connection: <SID>_GEF
DBMS: HDB
User Name: GEF_USER
DB Password: xxxxxxxxxx
Conn Info.: <FQHN of the DB Server>:<HANA Port> (eg ob7db.myorg.com:30015)
Permanent: Checked
ESH Connector
DB Connection: <SID>_ESH
DBMS: HDB
User Name: ESH_USER
DB Password: xxxxxxxxxx
Conn Info.: <FQHN of the DB Server>:<HANA Port> (eg ob7db.myorg.com:30015)
Permanent: Checked
Testing
SE38 -> ADBC_TEST_CONNECTION
IMG Configuration
Fix for 1909 Upgrade Defect
Reference Note (requires a access to SAP ONE Support Launchpad):
2878649 – HANA Update to 1909 Fix for Data Type Date Fields Update
/nGEF_CRT_TAB
- Run transaction GEF_CRT_TAB
- Use the default values or change to match the custom values used in a prior execution of the report (when creating tables/view for local SRID deployment)
- Set a new value for the View Suffix if view already exists
- Set the Create View Only parameter value to “X” and execute. A new view will have been created in the SAP_GEF schema
- Run transaction GEF_FRW_CONFIG and select the “System Settings” Node
- Replace the GDB View Name entry with the name entered in the View Suffix of step 3
- Save configuration changes
GEF Configuration Check
Before handing over to the functional team it’s worth checking the following. Success means that the ‘Supports History’ flag is checked in the below screen
/nGEF_FRW_CONFIG
GIS Providers
/nGEF_GIS_CONFIG
SICF Activations
NOTE: This needs to be done manually as the build migrates through the landscape:
ESRI & Rest Services
GEF UI Services
Enterprise Search Setup
/nesh_cockpit
Equipment
Functional Location
Locator Search
SM30 -> GEFV_LOCATOR
Ensure the following entries are inside this view:
Summary
Upon completion of all the technical setup activities above you will be able to handover to the EAM functional consultants to complete GEF configuration. There is also some work for the UX team to setup a Fiori tile which will include odata activation, group assignment and security role assignments.
Please don’t hesitate to share feedback or thoughts in a comment or ask questions.
Hi Warren,
We did the technical setup. Now we're busy configuring the scenario for Functional Location in GEF_FRW_CONFIG.
In the Geo Objects definition, we use CL_EAMS_GEF_SRV_FL as class & EAMS_S_GEF_SRV_FL as structure. Is that correct ?
Would you have another example than BP (set up by default in our system) or more info than the help.sap.com ? It's not always obvious for us what's the use of the steps in the config..
Thanks
Aurélien
Hi Warren,
very useful blog.
Only thing is missed is about business function activation, please refer to SAP documentation:
https://help.sap.com/viewer/86dbe289f813483abd78de6a52458bff/2021.001/en-US/7430ad5789cfca02e10000000a4450e5.html
I run on S/4 HANA 2020 and had to activate business function and related BC sets
Kind regards,
Giuseppe
Thanks Warren- Very informative. I am having couple of issues with GEF, if you help with those.
Dear Warren,
thank you for your advices.
May I ask you a clarification for a S/4 HANA 2021: is component UIGEF001 still need as could be understood by SAP oss note 2383937, or is no more needed as written in SAP oss note 3149622.
Thank for any help you can provide.
Best regards,
Silvia