Adding a New Data Object

Adding a new data object to the application requires four main tasks:
  • Redefine methods in SAP to allow for the new data object.
  • Using the Agentry SAP Framework Configuration portal to create a new MDO or Z-MDO.
  • Creating new data object Java class, stephandler and POJO for the new data object in the the Java editor in Eclipse.
  • Using the Agentry Editor to modify the application to make use of and support the new data object.
  1. Redefine methods in SAP
    1. Redefine the get_field_selector_tables method for the class handler to enable field selector function for the mobile data object.
    2. In the get_field_selector_tables method, list the database tables supported by the class handler GET method for the result set field selection ET_FLDSEL_TABLE_LIST.
    3. List out the mandatory key fields from the required tables and pass them to the output table ET_REQ_FIELD_LIST to ensure that all key fields are included in the output selection.
    4. Redefine the get_data_filter_list method to enable data filter function for the class handler and define the necessary filter rules to control what data can be viewed by the mobile application.
    5. List the filters supported by the get_data_filter_list method along with the table and field names and pass them to the output table ET_DATA_FILTERS. Take the data object filter (DOF) name from the technical properties of the field.
  2. Create a new data object in the Configuration portal
    1. Create a new mobile data object in the Z namespace, referred to as a Z-MDO.
    2. Create a new subclass in the Z namespace from /syclo/cl_DO_Handler_base.
    3. Override the GET, CREATE, UPDATE, and DELETE methods as needed to retrieve data from SAP.
    4. Create a new BAPI Wrapper in the Z namespace using the BAPI include template: /syclo/core_bapi_template_incl. Or, assign the Z-MDO to an existing BAPI wrapper.
    5. Assign the new Z-MDO to the new BAPI wrapper if it was not assigned to an existing BAPI wrapper.
  3. Configure Java synchronization between the data object and Agentry
    1. Create new steplets for fetchs and transactions.
    2. Create the associated stephandlers.
    3. Create the new POJO for the data object.
  4. Add the new data object definitions to Agentry
    1. Open the SAP project in Agentry.
    2. Create the new data object to represent the business object from SAP.
    3. Create the transactions and read steps of the data object.
    4. Create any necessary fetches or transactions associated with the data object.
    5. Publish the application to the SAP Agentry Development Server in preparation for testing. Restart the Server as changes were also made to the Java logic in support of the new data object.
Next
  1. Perform a transmit from the Agentry Test Environment and verify that the new data object and all related functionality are producing desired results.
  2. Publish the application, including the supporting Java synchronization logic, to the SAP Agentry Production Server for deployment.
Parent topic: Agentry SAP Framework