Show TOC

 UI Extensibility for Fact Sheets

 

A fact sheet is created based on the semantic and object structure information coming from an annotation file in XML format. Technically, a fact sheet is represented by a combination of:

  • A search model

  • An OData service derived from the search model.

    The OData service provides the back-end information to the UI.

  • A BSP application that contains an annotation file.

    The annotation file determines which information from the OData service is represented on the UI, and how.

There are different ways for you to adapt fact sheets to your specific needs:

  • You can add information to the fact sheet that is already available in the search model, but has not been represented on the UI so far. In this case, you must change only the annotation file.

  • You can add a new object such as an additional date, or an internal, or external key figure. In this case, you must extend both the search model and the annotation file.

  • You can hide existing fields from a fact sheet, change their labels, or move them to another place. In this case, you must change only the annotation file.

Activities

You can use SAP Web IDE to extend the annotation file, or you can extend the annotation file manually. Some extensions, such as adding geographical maps, can only be performed manually. Note that to use SAP Web IDE, you must have a separate license.

For more information about editing annotation files with SAP Web IDE, see Start of the navigation path https://help.hana.ondemand.com/Information published on SAP site Next navigation step SAP Web IDE Next navigation step Use Plugins Next navigation step Fact Sheet Editor End of the navigation path.

Note Note

Unless you use XSLT (see Using XSLT Documents to Extend Fact Sheets), the fact sheet extension process requires you to modify the annotation file delivered by SAP. After an upgrade, SAP recommends that you use transaction SPAU in order to merge your changes with the changes delivered by SAP. For more information, see http://help.sap.comInformation published on SAP site under Start of the navigation path Technology Next navigation step SAP NetWeaver Platform Next navigation step SAP NetWeaver <release> Next navigation step Application Help Next navigation step Function-Oriented View Next navigation step Application Server Next navigation step Application Server ABAP Next navigation step Application Development on AS ABAP Next navigation step ABAP Customer Development Next navigation step Changing the SAP Standard (BC) End of the navigation path.

End of the note.
Extending a Fact Sheet Using the Fact Sheet Editor
  1. If necessary, that is, if you want to add fields to the fact sheet that are not yet available in the search model:

    Extend the search model with the required fields. For more information, see Extending the Search Model Layer.

    The corresponding OData service is enhanced automatically.

  2. Use the fact sheet editor in SAP Web IDE to extend the fact sheet.

  3. Retrieve the BSP application for your fact sheet in the App Implementation documentation for your fact sheet at http://help.sap.com/fioriInformation published on SAP site under Start of the navigation path SAP Fiori Apps Next navigation step <your SAP Business Suite product> Next navigation step <your SAP Business Suite application> Next navigation step <your SAP Fiori app> Next navigation step App Implementation: <your SAP Fiori app> End of the navigation path. You find the BSP application in the Extensibility section.

  4. Search for your BSP application in transaction Object Navigator (SE80) on your front-end server.

  5. Copy the content of the fact sheet that results from the change process performed with the fact sheet editor. Paste the content into the annotation file relevant for your fact sheet, which is included in the BSP application (see point 3.).

Extending a Fact Sheet Manually

You can also extend fact sheets manually, for example to add key facts, geographical maps, or line items. To do so, proceed as follows:

  1. If necessary, that is, if you want to add fields to the fact sheet that are not yet available in the search model:

    Extend the search model with the required fields. For more information, see Extending the Search Model Layer.

    The corresponding OData service is enhanced automatically.

  2. Retrieve the BSP application for your fact sheet in the App Implementation documentation for your fact sheet at http://help.sap.com/fioriInformation published on SAP site under Start of the navigation path SAP Fiori Apps Next navigation step <your SAP Business Suite product> Next navigation step <your SAP Business Suite application> Next navigation step <your SAP Fiori app> Next navigation step App Implementation: <your SAP Fiori app> End of the navigation path. You find the BSP application in the Extensibility section.

  3. Search for your BSP application in transaction Object Navigator (SE80) on your back-end server.

  4. Retrieve the annotation file relevant for your fact sheet, which is included in the BSP application (see point 3.). Edit the annotation file manually. For more information, see Extending Fact Sheets Manually.