Show TOC

App Extensibility: Look Up Retail ProductsLocate this document in the navigation structure

Use

You can extend Look Up Retail Products according to your business needs and control how much product information store associates can see. For this purpose, the following extensibility options are available:

  • You can show or hide the following information in the product detail view:

    • Product number, EAN/UPC code, product weight, and quantity available

    • Promotion information

    • Quantities expected in incoming shipments

    • Quantities available in nearby stores

    • Style, color, and size variants

  • You can add a new section to the Information tab of the product detail view and add new fields to it.

  • You can add a new section to the Promotions tab of the product detail view and add new fields to it.

  • You can add a new tab to the product detail view, and extend it with new sections and new fields.

Enhance Product Detail View

To enhance the product detail view,, the extensibility entities listed below are available on the different software layers. You have to extend each of these entities according to your specific business needs:

Display of UI Controls

To show or hide specific product details on the app, the following UI controls can be hidden on the app UI. You implement the control by setting the Visible attribute to True or False in the Components.js file, in the section where customization points are set. For more information, see sap.ui.viewModifications in the implementation.

View

Control ID

Use

retail.store.productlookup.view.ProductDetails

ARTICLE_DETAILS_ITF

Allows you to hide the Product Detail tab and prevent navigation to that information on the app.

retail.store.productlookup.view.ProductDetails

PROMOTIONS_ITF

Allows you to hide the Promotion tab and prevent navigation to that information on the app.

retail.store.productlookup.view.ProductDetails

STOCK_ITF

Allows you to hide the Stock tab and prevent navigation to that information on the app.

retail.store.productlookup.view.ProductDetails

AA_ITF

Allows you to hide the Similar Items tab and prevent navigation to information about product variants on the app.

For more information about hiding UI controls, 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 Hiding UI Controls 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

ProductDetails.Controller.js

extHookOnProductDetailsDataReceived

Allows you to execute code after successfully receiving product data to enrich or validate product details

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.

Add New Fields to Information Tab in Product Detail View

To add new fields to the Information tab of the product detail view, the following extensibility entities are available on the different layers. You have to extend each of these according to your specific business needs:

UI

Back End/ABAP

View

Extension Point

Design Time: Gateway Entity

Design Time: Extension Include (in DDIC Structure)

Runtime: Superclass/Method to Be Redefined

ProductDetails.view.xml

Product_Information_Form_Ext

To add new fields in the Information tab page

Article entity in the RETAILSTORE_PRODUCT_LKP project

RETAIL_ST_ARTICLE_INCL

CL_RETAILSTORE_PRODUCT_DPC methods:

  • ARTICLES_GET_ENTITY

  • ARTICLES_GET_ENTITYSET

  • ALTERNATIVEARTIC_GET_ENTITY

  • ALTERNATIVEARTIC_GET_ENTITYSET

You must copy the code from the original class and use the enhanced structure where needed. The enhanced structure is available in the redefined method signature as the ER_ENTITY type.

Business Add-Ins (BAdIs)

The following Business Add-In is available for extensibility purposes:

BAdI: Enhancement of Information Displayed in Product Details

RETAIL_ST_PL_PRODUCT_ENH

You can use this BAdI to provide additional product information. This BAdI uses the GET_PRODUCT_SUPP_DATA method to retrieve data from the back-end system when a product list is first displayed or refreshed, or when a product is searched. It provides data to the additional product information fields.

Add New Section and New Fields to Promotions Tab in Product Detail View

To add a new section and new fields to the Promotions tab of the product detail view, the following extensibility entities are available on the different layers. You have to extend each of these according to your specific business needs:

UI

Back End/ABAP

View

Extension Point

Design Time: Gateway Entity

Design Time: Extension Include (in DDIC Structure)

Runtime: Superclass/Method to Be Redefined

ProductDetails.view.xml

Product_Promo_Sections_Ext

To add new fields in the Information tab page

Promotion entity in the RETAILSTORE_PRODUCT_LKP project

RETAIL_ST_PROMOTION_INCL

CL_RETAILSTORE_PRODUCT_DPC methods:

PROMOTIONS_GET_ENTITYSET

You must copy the code from the original class and use the enhanced structure where needed. The enhanced structure is available in the redefined method signature as the ER_ENTITY type.

Business Add-Ins (BAdIs)

The following Business Add-In is available for extensibility purposes:

BAdI: Enhancement of Information Displayed in the Promotions Tab

RETAIL_ST_PL_PROMOTION_ENH

You can use this BAdI to provide promotion information for a product. This BAdI uses the GET_PROMOTION_SUPP_DATA method to provide data to the product information when a product is selected in the product list and the promotion information is loaded.

Add New Tab Pages

To add a new tab page to the product detail view, and add new sections and fields to it, the following extension points are available:

Extension Points

In addition to the extension points described above, the following extension points are available:

View

Extension Point

Use

ProductDetails.view.xml

Extension_Product_Detail_Tab

To add a new tab to the product detail view

You can add fields from the standard delivered back-end ABAP service, or from your extended back-end ABAP service.

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.

Business Add-Ins (BAdIs)

The following Business Add-Ins are available for extensibility purposes:

  • BAdI: Enhancement of Information Displayed in Product Details

    RETAIL_ST_PL_PRODUCT_ENH

    You can use this BAdI to provide additional product information. This BAdI uses the GET_PRODUCT_SUPP_DATA method to retrieve data from the back-end system when a product list is first displayed or refreshed, or when a product is searched. It provides data to the additional product information fields.

  • BAdI: Enhancement of Information Displayed in the Promotions Tab

    RETAIL_ST_PL_PROMOTION_ENH

    You can use this BAdI to provide promotion information for a product. This BAdI uses the GET_PROMOTION_SUPP_DATA method to provide data to the product information when a product is selected in the product list and the promotion information is loaded.

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.