Show TOC

Using XSLT Documents to Extend Fact SheetsLocate this document in the navigation structure

Use

You can use XSL transformation (XSLT) documents to extend SAP Fiori fact sheets, for example, by adding new fields.

XSLT documents work in conjunction with annotation files.

The original, SAP-delivered annotation files remain unchanged. When the web browser calls the BSP application for the fact sheet, the XSL transformation generates a new temporary annotation file in response. The fact sheet is rendered based on this transformed annotation file.

Caution

After having implemented any SAP-sided changes to annotation files, for example, after an upgrade, you must test that the fact sheets you have extended using XSLT are still displayed correctly.

To activate changes from an XSLT document for the related fact sheet, you must assign the XSLT document to the annotation file.

As an alternative to using XSLT documents, you can edit an annotation file directly to extend the resulting fact sheet. For more information, see Editing Annotation Files Directly to Extend Fact Sheets.

Prerequisites
  • The application class CL_CBN_ANNO_EXTENSION must be assigned to the BSP application containing the annotation file.

  • The following comment must be displayed in the annotation files you want to extend: <!-- This is a Fact Sheet Annotation Spec Version V4 -->. (The comment is displayed in the last line of the annotation file.)

Procedure

To assign your XSLT document to the related annotation file, perform the following steps:

  1. Create a transformation in transaction Object Navigator (se80):

  2. Right-click on the package in which you want to create the transformation. Choose Start of the navigation path Create Next navigation step Other 1 Next navigation step Transformation End of the navigation path.

    Write the XSLT coding you require for modifying your fact sheet and save the transformation.

    Note

    In SAP Note 2083543 Information published on SAP site, you find extensibility patterns - in the form of exemplary XLSTs - for different use cases.

    Recommendation

    We strongly recommend that you stick to the patterns given in SAP Note 2083543 Information published on SAP site.

    Once your coding is complete, proceed as follows:

  3. In transaction Maintain Table Views (sm30), open view CEBN_AN_XLT_A_CV for editing.

  4. Make the following entries in this view:

    • Under Application, enter the BSP application that contains your annotation file.

    • Under Page, enter the technical name of the annotation file in XML format.

    • Under Transformation, enter the transformation object that you have created in step 1.

  5. Mark the table entries as active.