Show TOC

Function documentationValue Mapping Maintenance

 

In the SAP Application Interface Framework, you can maintain a value mapping table.

Integration

Before you can maintain a value mapping, it is necessary that a value mapping has been defined by the interface developer when creating the value mapping during Customizing. This setting is made in Customizing for SAP Application Interface Framework (transaction code /AIF/CUST) under Start of the navigation path Interface Development Next navigation step Define Value Mapping End of the navigation path.

You have to have the corresponding authorizations to display and maintain value mappings for a given namespace.

To define a date range for a validity period number for a value mapping, you can access validity period maintenance (transaction /AIF/VPN) from the SAP Easy Access menu under Start of the navigation path SAP Application Interface Framework Next navigation step Interface Development Next navigation step Maintain Validity Periods End of the navigation path.

SAP GUI

You can access the maintenance of value mappings from the SAP Easy Access menu by choosing Start of the navigation path Cross-Application Components Next navigation step SAP Application Interface Framework Next navigation step Value Mapping End of the navigation path.

You can navigate directly to Maintenance of Value Mappings from the Log Messages view of the main screen of Monitoring and Error Handling. If an error resulted from a faulty value mapping, you can select the log message and choose Value Mapping (Value Mapping) to maintain the value mapping.

Web-Based UI

You can navigate directly to Value Mapping from the Log Messages view of Monitoring and Error Handling. If an error resulted from a faulty value mapping, you can select the log message and choose Maintain Value Mapping (Maintain Value Mapping) to maintain the value mapping.

Features

SAP GUI

In Database Type, whether or not the values can be changed in the production system is displayed. This setting is made by interface developers in Customizing for SAP Application Interface Framework under Define Value Mapping.

In Value Mapping Type, which one of the following 2 value mapping types has been specified in Customizing is displayed:

  • Single value mapping

    If the value mapping is defined as a single value mapping, one external value is mapped to one internal value.

  • Multiple value mapping

    If the value mapping is defined as a multiple value mapping, up to five external values can be mapped to one internal value. The number of external values is maintained by the interface developer in Customizing for SAP Application Interface Framework under Start of the navigation path Interface Development Next navigation step Define Value Mappings End of the navigation path.

In Sending System, you can specify the name of a particular business system that is to be used for the value mapping. The selected value mapping is only valid for the specified sending system.

Missing Values is only displayed if you access Value Mapping from Monitoring and Error Handling. Missing Values shows the values missing according to the error message in Monitoring and Error Handling. You can enter the values into the value mapping table by choosing Insert Values.

The value mapping itself is displayed in a table. The first column is always an index, which you cannot edit. In the following column(s), the external values are defined. The last column where values can be entered is for the internal values.

Web-Based UI

In Value Mapping, the first column in the table displays the value mapping number, which you cannot edit. In the following column(s), the external values are defined. In the IntValue (Internal Value) column, you can enter the internal values.

Activities

SAP GUI

To maintain the value mapping, choose Switch between display and change mode (Switch between display and change mode). The transaction also provides you with a Where-used (Where-used ) function that enables you to check where the value mapping is used. If you have the authorization, double-clicking on an entry in the provided list opens a new window and the Customizing where the mapping is used is displayed.

To enter new empty lines into the table, choose Append (Append) and select the number of lines you want to enter.

To delete single or multiple lines from the table, select the lines and choose Delete (Delete).

If the value mapping was already defined for at least one sending system, you can enter those values into the current value mapping. To do this, choose Import Value Mappings (Import Value Mappings), select the business systems of the value mapping you want to use, and choose OK. The values are automatically entered into the current value mapping.

A filter option is available for the value mapping. If you filter for a certain value and choose Append, the selected filter values are automatically entered into the new lines. If Read Only was selected during filtering it is not possible to change those values.

Insert Values is only displayed if you access Value Mapping from Monitoring and Error Handling. To insert a new value mapping using the missing values from Missing Values, choose Insert Values.

You are able to export data, for example, to a spreadsheet, by choosing Export (Export).

You are also able to copy data from Microsoft Office Excel cells. Copy the data you want to insert to the clipboard. Select the first cell the data is to be inserted into in the value mapping table and Paste. The lines are inserted into the value mapping table. If the lines inserted exceed the number of available lines, then additional lines are appended automatically.

Web-Based UI

If you have the authorization, in the ValMap (Value Mapping) column of the line with an error status, double-clicking on Maintain Value Mapping (Maintain Value Mapping) navigates to Value Mapping. Once you have maintained the value mapping, choose Save and Back (Save and Back) to save your correction and navigate back to Monitoring and Error Handling.

Validity Period

You can define the validity period type that should be used, that is, either the validity period number and/or the validity dates, depending on the settings in Customizing for SAP Application Interface Framework under Start of the navigation path Interface Development Next navigation step Define Value Mappings End of the navigation path, where the following are available to define a validity period:

  • The Use Validity Period checkbox

    Select to make the Validity Period Number field visible

  • The Use Valid To Date checkbox

    Select to make the Valid To Date and Valid From Date fields visible

For a value mapping, you can maintain either the validity period number or the dates or both of these.

Uniqueness of Internal and External Values

In Customizing for SAP Application Interface Framework under Start of the navigation path Interface Development Next navigation step Define Value Mappings End of the navigation path, you can specify whether or not the system checks the uniqueness of the external values, the internal values, or a combination of both before saving the entries in value mapping. You have the option of specifying whether you are alerted by an error or a warning if duplicate values are detected.