BAPI wrappers are an element type within the Agentry SAP Framework. The BAPI wrappers are the elements through which calls are made by the SAP Agentry Server to the elements configured in the MDOs, (i.e., the GET, CREATE, UPDATE, and DELETE methods). A BAPI wrapper is assigned to an MDO in the Agentry SAP Framework. The BAPI wrapper defines the inputs and outputs for the calls made to it and the data it returns to the SAP Agentry Server.
When making modifications or configuration changes to MDOs, and when a copy of the MDO is made in the customer namespace as a a part of the modification, the assignment settings of a BAPI wrapper must be changed to reference the new copy.
Changing the MDO Assignment of a BAPI Wrapper
Once an MDO is created, it must be assigned to a BAPI wrapper. During runtime, the MDO invoked is determined based on the BAPI wrapper assignment. This procedure describes the steps needed to change a BAPI wrapper’s MDO assignment.
1. Open the Syclo Agentry SAP Framework Configuration portal through SAP. 2. Click the BAPI Wrapper Configuration menu item.
3. Navigate to and highlight the BAPI wrapper that will use the new or modified MDO or
4. Click the Assignment tab. 5. Click Change.
6. Use the Add button in the Mobile Data Object Assignment List panel to add the new Z-
MDO.
7. Click the arrow to the right of the Mobile Data Object ID field and select the desired MDO
from the drop-down list.
8. Change the Method Type field to select the MDO method to be called by the BAPI
wrapper.
9. Highlight the original MDO in the Mobile Data Object Assignment List table and click Delete.
The original is no longer assigned to the BAPI wrapper, leaving the newly-added Z-MDO.
Changing MDO Filter Rules
Many of the common configuration changes made for an implementation involve the modification or addition of one or more filter rules within an MDO. In SAP, each user is assigned a role-based profile with authorization permissions on viewable data and available activities. For example, a user working in one plant should not be able to view data for another plant. When business activities performed by a user are mobilized through the mobile application, the ability to extend the same restrictions to the mobile application is necessary. Data filter rules provide the function to restrict data access for mobile applications.
This procedure describes the steps necessary, in general, to modify a data filter rule for an MDO. The specific settings of a given rule will vary depending on the overall nature of the change being made. Subsequent procedures will reference this process and provide the detailed values and settings for the filter rules involved in the specific change.
1. Open the Agentry SAP Framework Configuration portal through SAP.
2. From the ConfigPanel Home page, click the Mobile Data Object Configuration menu
item.
The Mobile Data Object Configuration page displays.
3. Expand the Mobile Data Object tree in the Data Object Navigation Tree section and
highlight the MDO created earlier in this procedure.
4. Expand the desired method in the Defined Filters list.
5. Under the method are listed all current filters defined for the method. Select the filter
whose rules should be modified.
The current rule filter settings are displayed in the Rule Editor section. All existing rules for the filter are displayed in the Rule List table.
6. To add a new rule, edit an existing one, or delete a rule from the filter, click Change at the
top of the page. Many of the fields in the Rule Editor section become editable, and two new buttons are displayed to the right of the Rule List field, Create and Delete.
7. To delete a rule from the filter, select that rule in the list and click Delete. If no further
changes are to be made, click Save at the top of the page to completely remove the rule from the filter. If additional changes are still needed, the filter can be saved after all changes are complete.
8. To add a new rule to the filter, click Create to the right of the Rule List. To edit an existing
rule within the filter, select it in the Rule List. This will display the current settings for the rule in the DOF Rule Type, Sign, Option, Low Value, High Value, and Active Flag fields within the Rule Editor section.
9. Set or modify the editable fields according to the needs of the application. For a detailed
10. Be sure the Active Flag field is set to true for each added or edited field before saving
changes. Inactive filter rules will have no effect on the synchronization processing. An Active Flag is set by clicking in the box in order to display a checkmark.
11. When all desired changes have been made to the filter rules click Save to apply those
changes.
Creating a New Filter Rule
1. Click the BAPI Wrapper Settings in the Navigation Panel.
2. Navigate to the BAPI Wrapper that uses the MDO you are modifying, in the BAPI
Wrapper List.
3. Click the Assignment Tab and click the Change Button.
4. Use the Add button to add ZMDO version of the complex table, with the newly created
field. Use the delete button to delete the original complex table.
5. Click the Save button to save the changes.
6. From the SAP user menu, click SMART Mobile Suite Configuration.
This will launch a web browser, which will log into the SMART Mobile Suite Configuration Site.
7. Click the Mobile Data Object Settings.
This will display the Mobile Data Object Settings Drop down menu:
8. Expand this Menu and select desired Data object for the data filter. 9. Select the Data Filter Tab.
10. Click the Create button near the top of the screen. 11. Use the filer settings to define the new filter. 12. Click the Save button to save your changes.
13. Use the ATE to verify the filters perform as expected on the client. Validate the expected
material is fetched to the device, by paying attention to the transmit log as it completes.