After the connector initializes the original business object, what remains is the top-level business object containing the business object name and business object verb, but no attribute value data. The attribute value data must be transferred from the flat structure from the ABAP handler. The logic for transferring the returned data is simple, but the data must be transferred in the exact order that the connector expects it.
The connector matches the application-specific information in the returned data to an attribute's application-specific information in the business object definition. The connector attempts to set every attribute that is in the returned business object data. If any attribute cannot be set, the connector returns FAIL to the connector infrastructure.
In order for the returned data transfer to execute successfully, the connector expects the following to be true of the returned data:
When the connector rebuilds the application-specific business object, the connector loops through the business object twice, beginning with the top-level business object.
Attention: If the conversion of a flat structure to a business object fails, the connector reports a failure to the integration broker. However, the data is already posted in the SAP application and, therefore, cannot be rolled back at this stage. While the rules are simple, implementing a complex, hierarchical business object with many attributes can be difficult to manage.
Once the business object is successfully rebuilt with new business object data, the connector returns it to the integration broker.