Show TOC

Adding a New Field to a Fact SheetLocate this document in the navigation structure

Use
Note

Before changing the annotation file manually, check whether you can use the fact sheet editor in SAP Rapid Development Environment (SAP RDE) to add a new field. For more information, see Fact Sheet Extensibility under Start of the navigation path Activities Next navigation step Extending a Fact Sheet Using the Fact Sheet Editor End of the navigation path..

To use a new field in your fact sheet, you can change the corresponding annotation file by copying the suitable lines and replace the properties of the relevant annotation with new properties provided by the OData service.

Example

The following example describes how an additional data field of the OData service can be added to the LineItem annotation:

  • <Annotation Term="UI.LineItem"> <Collection> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.Low"/> <PropertyValue Property="Value" Path="CompanyCode"/> </Record> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.Low"/> <PropertyValue Property="Value" Path="Currency"/> </Record> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.Low"/> <PropertyValue Property="Value" Path="TaxCode"/> </Record> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.High"/> <PropertyValue Property="Value" Path="ZSalesUnit"/> </Record> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.Low"/> <PropertyValue Property="Value" Path="IsReconciliationAccount"/> </Record> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.High"/> <PropertyValue Property="Value"> <Apply Function="odata.concat"> <Path>ChartOfAccounts</Path> <String>&#160;</String> <Path>ChartOfAccountsName</Path> </Apply> </PropertyValue> </Record> <Record Type="UI.DataField"> <PropertyValue Property="Importance" EnumMember="UI.Priority.Low"/> <PropertyValue Property="Value" Path="IsOpenItemManaged"/> </Record> </Collection> </Annotation>

  • As a prerequisite, the corresponding OData service contains the fields ZSalesUnit, ChartOfAccounts, and ChartOfAccountsName.

  • On the fact sheet, the system provides these additional fields defined by <PropertyValue Property="Value" Path="ZSalesUnit"/>, <Path>ChartOfAccounts</Path>, and <Path>ChartOfAccountsName</Path> in the line item view, which is determined by the first row <Annotation Term="UI.LineItem">.

Prerequisites

  • You have extended the search model with the required field.

  • The field to extend the fact sheet is provided by an OData service.

  • You have found the appropriate BSP application in your system, in transaction SE80.

Activities

To adapt your fact sheet according to your needs, you change the annotation file as follows:

  1. Copy the complete annotation file into any editor.

    Check the OData service for the required new fields for your fact sheet in the SAP NetWeaver Gateway, in parallel.

    For more information, see Checking the Properties of an OData Service.

  2. In the copied annotation file, search for the appropriate area to extend it with a new field.

    For example, you can search for the entity type found in the OData service.

  3. Duplicate the lines of the annotation file, which you want to adapt, tat is the lines defining the Record of the search model field.

  4. Replace the Path, or several paths in case you want to concatenate fields, of the copy according to your requirements.

    For example, copy one <Record Type=”UI.DataField”>.....</Record> area and change the Path to Path="ZSalesUnit" to display the additional field ZSalesUnit on the fact sheet.

  5. Save the annotation file.

Result

The new annotation file is ready to be attached to your own BSP application.

More Information