Show TOC

App Extensibility: Track ShipmentsLocate this document in the navigation structure

Use

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

Add Customer Field

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 Start of the navigation path Transportation Next navigation step Track Shipments End of the navigation path.

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 Start of the navigation path Extensibility Information for SAP Fiori Next navigation step Extending the UI Layer Next navigation step UI Extensibility Workflow Next navigation step  Next navigation step Checking the SAP-Enabled Extension Options Next navigation step Extension Points End of the navigation path.

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 Start of the navigation path Extensibility Information for SAP Fiori Next navigation step Extending the UI Layer Next navigation step UI Extensibility Workflow Next navigation step  Next navigation step Checking the SAP-Enabled Extension Options Next navigation step UI Controller Hooks End of the navigation path.

More Information

For a general description of the extensibility options and procedures of SAP Fiori apps, see http://help.sap.com/fiori_implementation Start of the navigation path Extensibility Information for SAP Fiori End of the navigation path.