Data Flow - Complex Table

The complex table definition defines a table of records containing multiple fields stored on the SAP Client in a structured and searchable format. A complex table can contain large amounts of data with records numbering in the thousands. Included in the complex table are the fields for its records and indexes on fields to provide search functionality and structure to the overall data in the table. The complex table definition also defines how its data is synchronized.

The following diagram and steps depict what happens when the Agentry Client must load or reload a complex table.

1. The complex table's initialize() method is called.
2. The initialize() method calls a ComplexTableStepHandler build() static method passing the User object.
3. The ComplexTableStepHandler build() method constructs the necessary CTBAPI class, passing the User object and clientLastUpdate parameter to it.
4. The CTBAPI constructor retrieves the JCo function object from the repository, using the connection on User.
5. CTBAPI sets BAPI import parameter IS_BAPI_INPUT.
6. CTBAPI adds IT_xxx record(s) to ComplexTableObject import tables for search criteria or other input parameters.
7. ComplexTableStepHandler build() method calls getNumRows() method in CTBAPI.
8. CTBAPI getNumRows() method calls the execute() function and checks for exceptions.
9. CTBAPI getNumRows() method reads ET_RETURN table in the BAPI class for error messages.
10. CTBAPI getNumRows() method iterates over ET_COMPLEX_TABLE and reads records from the table.
11. For each record, CTBAPI getNumRows() method calls the appropriate constructor in the appropriate SAPObject subtype.
12. The SAPObject subtype constructor maps the JCo record column names to field names.
13. CTBAPI getNumRows() method collects the SAPObjects in ComplexTableIterator and passes them back to ComplexTableStepHandler.
14. ET_EXCHANGE_ACTION_DELETED is read and follows the same steps as 10 - 13. These SAPObjects populate another ComplexTableIterator.
15. ComplexTableHandler passes the iterators back to ComplexTable dataIterator() and deleteIterator().
16. ComplexTable initialize() stores the iterators in ComplextTableIterator and returns them to Agentry in dataIterator() and deleteIterator.
17. Agentry application defined in the SAP Mobile Server parses these iterators and sends table rows up to Client.