ECC Lean Order: Adding a field to the LORD API
This blog describes an example for integrating a standard sales order field from ECC into the Lean Order Interface so that it can be displayed in the CRM Web UI.
There are essentially 5 steps required:
- Extend the ECC communication structures
- Configure the ECC mapping table
- Register the field in PAI logic to allow save of changed data to ECC
- Extend the CRM structures
- Configure the CRM layout
In the following example we want to display the ‘Your reference’ field of the order (VBKD-IHREZ) in the Web-UI, however the same process can be used to trensfer bespoke fields.
1. Extend the ECC communication structures
First of all we need to identify the correct communication structure of the LORD interface. The following options are available:
- This contains fields that could be changed
- This contains read only fields
- This is a CHAR 1 indicator for each field that is used to derive the correct input status and flags the fields as changed
is variable depending on the data you are dealing with. In our case we are dealing with header data that need to be able to be changed and therefore we will be applying our enhancements to TDS_HEAD_COMV and TDS_HEAD_COMC.
The following append structures were added to the respective data types in ECC:
2. Configure the LORD Mapping Table
The next thing we need to do on ECC is to tell the system which field needs to be mapped to our communication structure. This is done by maintaining table LORD_MAPPING.
In here you need to reference the VA03 screen and set the display attributes which are picked up by the *_COMC structure and passed back to CRM to determine the input-readiness.
3. Extend the PAI logic in ECC
Despite the fact that we are dealing with a standard ECC field, we still need to register the fields for PAI processing. This essentially allows the data to be updated in ECC when passed in via the APIs. If this step is not done the changes will be passed to ECC but the new data will be ignored and no update will take place for your field.
There is a BADI available to implement this – BADI_LORD_DO_PAI. Implementing Method IF_BADI_LORD_DO_PAI~ADD_SUPPLY_LIST allows you to register ‘new’ fields to the processing logic.
data: ls_supply type tds_field_supply.
if iv_object_id eq ‘HEAD’.
ls_supply-field = ‘ZZIHREZ’.
ls_supply-check = ‘N’.
append ls_supply to ct_supply.
4. Extend the CRM structures
The next step is to use the AET (Application Enhancement Tool) to automatically extend the ERP order header field in the UI configuration.
5. Configure the layout
Once you have the field available you can configure the layout as normal to display the field in the Web UI.
And then the ECC value is automatically displayed in the UI