Hierarchy
SAP_BASIS (Software Component) SAP Basis Component⤷
BC-SRV-UKM (Application Component) Standardized Key Mapping⤷
S_UKM_PI (Package) Multi-Backend Key Mapping Service
IMG Activity
| ID | UKMPI_VC_SETTINGS | Configure Key Mapping |
| Transaction Code | S_BCE_68002393 | (empty) |
| Created on | 20080313 | |
| Customizing Attributes | UKMPI_VC_SETTINGS | Configure Key Mapping |
| Customizing Activity | UKMPI_VC_SETTINGS | Configure Key Mapping |
Document
| Document Class | SIMG | Hypertext: Object Class - Class to which a document belongs. |
| Document Name | UKMPI_VC_SETTINGS |
Use
In this IMG activity you create different key mappings for each message and namespace. You assign a mapping ID for each key mapping.
These settings can be used by the mapping processor for connecting Unified Key Mapping Service (UMKS) to SAP NetWeaver Process Integration (SAP NetWeaver PI) for routing (determine receiver) and key mapping (find or create). You make the technical connection in SAP NetWeaver PI.
Requirements
Standard settings
Activities
You make the settings in the following views:
- In the view Key Mapping you can define element mappings for any elements or attributes of the XML message for each mapping ID entry. You assign an ID for each element mapping. You also assign the element mapping a number range interval, number range object, prefix and main context.
The number range and prefix are used to generate a new object key if the object was not yet created in the receiver system. A prefix should be used, for example, if the receiver system does not permit a purely numeric key for externally assigned numbers. The main context is used to store or find the key mapping in the Unified Key Mapping Service (UMKS).
- In the view Path you can restrict the key mapping to certain subtrees of the XML message by defining the mapping path.
You can enter all the path elements, starting with a subordinate element of the root element of the XML message up to the required element. You specify the level of the particular element. The first element of the path has the level 1. The levels of the path elements must be numbered sequentially.
If a path was entered, the mapping processor is limited to the subtrees (fragments) that are localized with the path.
Restricting to one path can improve the runtime of the mapping processor.
- In the view Conditions you can select subtrees. There can be more than one subtree with the element name of the highest level in the path. A subset of these subtrees can be selected based on the conditions for key mapping.
For a condition, you enter an ID, the element or attribute, and a value. The system searches in the subtrees for the element or attribute having the same value.
If there is more than one condition for the same element or attribute, these conditions are linked with OR. If there are conditions with different elements, they are linked with AND. A subtree is selected for the mapping if the link of all conditions for the subtree results in a true event.
It is necessary to specify conditions, for example, if the object key is identified with an object type. For example, in the message for addresses, the type and key define to whom the address belongs (customer, vendor, employee, bank, etc.). In this case the condition defines the type for which a key mapping should be performed (e.g. for customers only).
Further information
For more information and an example of the UKMS connection to SAP NetWeaver PI, see Help -> SAP Library -> SAP NetWeaver Library -> Function-Oriented View -> Application Server ABAP -> Miscellaneous Services of AS ABAP -> Business Services -> Unified Key Mapping Service -> Connecting to SAP NetWeaver Process Integration.
Business Attributes
| ASAP Roadmap ID | 204 | Establish Functions and Processes |
| Mandatory / Optional | 2 | Optional activity |
| Critical / Non-Critical | 2 | Non-critical |
| Country-Dependency | A | Valid for all countries |
Assigned Application Components
| Documentation Object Class | Documentation Object Name | Current line number | Application Component | Application Component Name |
|---|---|---|---|---|
| SIMG | UKMPI_VC_SETTINGS | 0 | B200003018 | Standardized Key Mapping |
Maintenance Objects
| Maintenance object type | C | Customizing Object |
| Assigned objects | ||||||
|---|---|---|---|---|---|---|
| Customizing Object | Object Type | Transaction Code | Sub-object | Do not Summarize | Skip Subset Dialog Box | Description for multiple selections |
| UKMPI_VC_SETTINGS | C - View cluster | SM34 |
History
| Last changed by/on | SAP | 20080313 |
| SAP Release Created in | 711 |
