CL_EAMS_BO_VB - Business Object Visual Business
SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up Fill RESBD Structure from EBP Component StructureThis documentation is copyright by SAP AG.
Functionality
This class provides address determination process when geo coordinates needs to be searched from several external data sources.
Relationships
Address determination process
After reading technical object's master data, its maintained address should be checked for incompleteness.
Its partners' addresses should be used whenever there is no address maintained. Multiple partners' addresses should be ranked based on customizing of partner function priority.
Based on retrieved address, technical object's geo coordinates should be fetched. Search sequence of data sources: ERP backend and ESRI "GeoCode" web service.
If technical object has no address maintained, then geo coordinates should be retrieved from ESRI "MapServer" web service based on internal-external object ID mapping.
After these steps if technical object has no geo coordinates then its superior technical objects should be inspected.
GET_GEOLOC_TECHOBJ provides geo coordinates for technical object and embraces the following functionalities.
GET_ADDRESS incorporates the following steps: GET_TECHOBJ_ADDRESS gets technical object's address basedon its master data provided by GET_TECHOBJ_DATA. GET_PARTNER_ADDRESS provides partners' addresses of technical object. Then addresses are checked by CHECK_ADDRESS for incompleteness.
Geo coordinates can be retrieved from different data sources with GET_LOC_FROM_ERP, GET_LOC_FROM_GEOCODE_SRV and GET_LOC_FROM_GEODB_SRV.
GET_NEXT_HIGHER_TECHOBJ provides superior technical object(s) if technical object has no address maintained.
GET_GEOLOC_ADRNR provides geo coordinates for PM notifications.
Customizing how to retrieve geo coordinates from ERP backend and ESRI GeoCode web service
There are three different web services provided by ESRI for different areas in the world, therefore three GeoCode service should be used in customizing for North America, EU and World.
In transaction SM59 under „HTTP Connection to External Server” create RFC connection withthese data above and proxy settings might be required. Example for RFC connections’ names are: EAMS_VB_GEOCODE_ESRI_EU,
EAMS_VB_GEOCODE_ESRI_NA and
EAMS_VB_GEOCODE_ESRI_WORLD
In SPRO under SAP NetweaverGeneral SettingsSet Geocoding / „Register Geocoding Program in the System” enter data source ID, class object and RFC connection e.g.:
EZR1, CL_GEOCODER_ESRI_NAZ, EAMS_VB_GEOCODE_ESRI_NA,
EZR2, CL_GEOCODER_ESRI_EUZ, EAMS_VB_GEOCODE_ESRI_EU,
EZR3, CL_GEOCODER_ESRI_WORLDZ, EAMS_VB_GEOCODE_ESRI_WORLD
In SPRO under SAP Netweaver - General Settings - Set Geocoding / „Assign Geocoding Program toCountries” assign the proper data source ID for proper countries. One country may be assigned to more than one data source ID and the field „Sequence” is used for ranking of those data sources.
Under SAP Netweaver - General Settings - Set Geocoding / „ Assign Relevant Address Fields for Geocoding” you can determine which address fields are relevant per geocoder.
The „SAP0” built-in geocoder service provides country- and region-wide geo coordinates.Under „Assign Geocoding Program to Countries” you can rank SAP0 with other geocoder service, so it can be used whenever other external geocoder service is not available
Customizing partner function priority
Maintain EAMS_CVBPARVWPRI in SM30. If technical object has many partners with address maintained, youcan decide which partner function at which priority level should be considered when using partners’ addresses for geo coding.
Example
Notes
·,,ESRI web service is queried using JSON form.
·,,Point geometry like data as geo coordinates measured in WGS 84 (WKID: 4326).
Further information
ABAP Short Reference BAL_S_LOG - Application Log: Log header data
This documentation is copyright by SAP AG.
Length: 4148 Date: 20120526 Time: 142535 triton ( 185 ms )
