Show TOC

Sample Customizing and Implementation of Geographical Enablement of Business PartnerLocate this document in the navigation structure

The following example uses a sample business partner (business object) to demonstrate how to geographically enable any given business object. The use case for the geographical enablement of a business partner includes the ability to display persons and organizations on the map.

Organizations can be represented on the map under a Service Area (Polygon) or Headquarter (Point). On different layers of the map UI, we should be able to see representations of headquarters and service areas. You also have the ability to change the transparency of the layers and toggle them on and off.

For persons, you should be able to see one layer on the map where person with type 001 is represented by a different symbol than person with type 002. You also have the ability to edit the geometry for organizations and persons.

The business object ID (BO ID) for Business Partner is defined as BP

The geo object person is defined as PERSON

Filtering criteria is on Business Partner Category (PARTNERCAT), and the value is 1 (Person). One default geometry context is defined as X (Default Location).

Example

Enterprise search on Person.

  • Searchable fields: First Name, Last Name, Business Partner ID, City, State, and Country
  • Search output fields: First Name, Last name, Business Partner ID, and Country

Two business layers are defined for geo object Person.

  • Person (Display Layer)
    • Name: PERSON
    • Geometry: Point
    • Geometry context: X
    • Legend: Layer display type is Unique; use a different icon based on Business Partner Type (value: 0001 or 0002)
    • Fields displayed in info popup: First Name, Last Name, Business Partner ID, Address, Phone Number, Business Partner Category, and Business Partner Type
  • Person (Editable Layer) is necessary for editing the geometry.
    • Name: PERSON_ET
    • Geometry: Point
    • Legend: Different icon based on business partner type (value: 0001 or 0002)
    • Fields displayed in info popup: First Name, Last Name, Business Partner ID, Address, Phone Number, Business Partner Category, and Business Partner Type

Geo object Organization is defined as ORGN.

Filtering criteria is on Business Partner Category, and the value is 2 (Organization)

Three geometry contexts are defined as follows:

  • Default Location defined as X
    Note It’s the same as the geometry context for Person, so they share the same geometry context.
  • Headquarter defined as HQ
  • Service area defined as SA

Enterprise search on Organization

  • Searchable fields: All name fields, Business Partner ID, City, State, and Country
  • Search output fields: Concatenate name field, Business Partner ID, and Country

Four Business Layers are defined for geo object Organization.

  • Default Location (Display Layer)
    • Name: LOCATION
    • Geometry: Point, line, and polygon
    • Geometry context: X
    • Legend: Layer display type is Simple
    • Fields displayed in info popup: Concatenate name, Business Partner ID, Foundation Date, Address, Phone Number, Business Partner Category, and Business Partner Type
  • Headquarter (Display Layer)
    • Name: HDQ
    • Geometry: Point
    • Geometry context: HQ
    • Legend: Layer display type is Simple; use a different icon based on Business Partner Type
    • Fields displayed in info popup: Concatenate name, Business Partner ID, Foundation Date, Address, Phone Number, Business Partner Category, and Business Partner Type
  • Service Area (Display Layer)
    • Name: SERVAREA
    • Geometry: Polygon
    • Geometry context: SA
    • Legend: Layer display type is Simple
    • Fields displayed in info popup: Concatenate name, Business Partner ID, Foundation Date, Address, Phone Number, Business Partner Category, and Business Partner Type
  • Editable Organization Layer
    • Name: ORGN_EDIT
    • Geometry: Point, line, and polygon
    • Legend: Layer display type is Simple
    • Fields displayed in info popup: Concatenate name, Business Partner ID, Foundation Date, Address, Phone Number, Business Partner Category, and Business Partner Type

The sample Customizing has been delivered within three switch BC sets under switch BS_GEF_SFWS_1. The three switch BC sets are CA-EPT-GEF_GIS_CONFIG, CA-EPT-GEF_FRW_CONFIG and CA-EPT-GEF_UI_CONFIG. Besides the Customizing, there are some additional sample ABAP implementations that are delivered in the package BS_GEF_SAMPLES and are required by the sample Customizing.

The sample geographical enablement for business partner delivered with Customizing and sample ABAP implementation will not work exactly as described in the example above. Some additional setup and configuration described in the Customizing section of this document is required. Moreover, you can make additional adjustments on the delivered Customizing according to your business data set.

More Information