You can extend Track Shipments according to your business needs for different aspects. For this purpose, the following extensibility options are available:
View |
Extension Point |
Use |
---|---|---|
ObjectListItemTemplate.fragment.xml |
ListDetail |
Customer Extension Point shipmentListDetail: Here additional info for a shipment can be displayed on the shipment list |
S3.view.xml |
ShipmentDetail |
Customer Extension Point shipmentDetail: Here additional information for a shipment can be displayed |
To add a customer field to Track Shipments, the following extensibility entities are available on the different software layers. You have to extend each of these entities according to your specific business needs:
UI |
Back End/ABAP |
Optional |
|||
---|---|---|---|---|---|
View |
Extension Point |
Design Time: Gateway Entity |
Design Time: Extension Include (in DDIC Structure) |
BAdI/method to be implemented |
Runtime: Superclass/ Method to Be Redefined |
ObjectListItemTemplate.fragment.xml |
ListDetail |
SRA019_SHIPMENT_TRACKING_SRV/ ShipmentList |
SRA019_S_LIST_INCL |
BAdI: SRA019_SHIPMENT_TRA_DPC Method: IF_SRA019_SHIPMENT_TRA_DPC~ CHANGE_SHIPMENT_LIST_APT |
Superclass: CL_SRA019_SHIPMENT_TRA_DPC_EXT Method: SHIPMENTLISTSET_GET_ENTITYSET |
S3.view.xml |
ShipmentDetail |
SRA019_SHIPMENT_TRACKING_SRV/ ShipmentDetail |
SRA019_S_SHIP_DETAIL_INCL |
BAdI: SRA019_SHIPMENT_TRA_DPC Method: IF_SRA019_SHIPMENT_TRA_DPC~ CHANGE_SHIPMENT_DETAILS_API |
Superclass: CL_SRA019_SHIPMENT_TRA_DPC_EXT Method: SHIPMENTDETAILSE_GET_ENTITY |
Business Add-Ins (BAdIs)
The following BAdIs are available for extensibility purposes:
BD_SRA019_FREIGHT_CHARGE
You can use this BAdI to retrieve the freight charge for a given shipment. It is called when the user executes the OData service to retrieve the header details for the Track Shipments application.
BD_SRA019_IMG_RETRIEVER
You can use this BAdI to retrieve the images for partners. It is called when the user executes the OData service to retrieve the partner image for the Track Shipments application.
BD_SRA019_USR_TO_CUSTOMER
You can use this BAdI to implement a method for associating employees to customers.
SRA019_SHIPMENT_TRA_DPC
You can use this BAdI to change the shipment data that is retrieved from the back-end system and displayed on the user interface of the Track Shipments app.
SRA019_SHIPMENT_TRA_MPC
You can use this BAdI to enhance the entities (the OData model) of the SRA019_SHIPMENT_TRACKING SAP NetWeaver Gateway service of the Track Shipments app. This allows you to add your own fields.
These BAdIs are available in Customizing for Logistics Execution under
.Extension Includes
In addition to the extension includes described above, the following extension includes are available:
DDIC |
Extension Include |
Use |
---|---|---|
SRA019_S_LIST |
SRA019_S_CONTACT_INCL |
Allows you to add fields for contacts |
SRA019_S_CUSTOMER |
SRA019_S_CUSTOMER_INCL |
Allows you to add fields for customers |
SRA019_S_ITEM_DETAIL |
SRA019_S_ITEM_INCL |
Allows you to add fields for the item detail |
SRA019_S_LIST |
SRA019_S_LIST_INCL |
Allows you to add fields for the shipment list entries |
SRA019_S_SHIPMENT_PARTNER |
SRA019_S_PARTNER_INCL |
Allows you to add fields for the partner data |
SRA019_S_PO_DETAIL |
SRA019_S_PO_DETAIL_INCL |
Allows you to add fields for the PO detail |
SRA019_S_SHIP_DETAIL |
SRA019_S_SHIP_DETAIL_INCL |
Allows you to add fields for the shipment detail |
If there are additional fields available in the OData service, you can display these fields on the UI. For more information, see the extensibility documentation for the respective SAP NetWeaver release on your front-end server at http://help.sap.com/fiori_implementation .
UI Controller Hooks
To plug in and execute custom code, the following hooks are available in the controller code:
Controller |
Hook |
Use |
---|---|---|
S3.controller.js |
extHookOnDetailDataReceived |
Allows you to check and change the shipment detail data. |
If there are additional UI controller hooks available in the controller code, you can add own code. For more information, see the extensibility documentation for the respective SAP NetWeaver release on your front-end server at http://help.sap.com/fiori_implementation .
For a general description of the extensibility options and procedures of SAP Fiori apps, see http://help.sap.com/fiori_implementation .