Adding Custom Fields using Key User Extensibility for Project System in SAP S/4HANA
Adding custom specific fields is one of the most common requirements in customer projects. In Project System predefined User Fields are available that can be adjusted by customers, however in case the customer needs additional or different fields, these fields had to be added by the IT department.
SAP S/4HANA Key User Extensibility has been introduced as an easier way to add additional fields to objects and include them into the respective Fiori UIs just using configuration. This enables key users to make simple adjustments to user interfaces without having to reach out to the IT department. For more details on the Key User Extensibility, check out this blog series by the S/4HANA Regional Implementation Group.
For Project System Key User Extensibility is supported for Fiori Apps and with SAP S/4HANA 2020 FPS2 for most relevant maintenance transactions, such as Project Builder or single maintenance transactions.
In this blog, I will show an example how to extend the Project System maintenance transactions with a new field for WBS elements.
To define a custom field, use the SAP Fiori app Custom Fields and Logic. For Project System in S/4HANA the following Business Contexts are relevant
- Project Definition Details
- WBS Element Details
- Order Master Data (i.e. Network Header)
- Network Activity Details
- Project Milestone Details
- Project Material Component Details
To add the example field ZWBSLocation to the WBS Element, the relevant business context is WBS Element Details. I define field properties such as Label, ID, Tooltip, Type and Length for the new custom field, in this example ZWBSLocation is a Text Field with 20 characters length.
When the field is created, I select in which UIs the custom field shall be displayed via the Tab UI and Reports. In this example I only enable the usage of the new field for the maintenance transactions, i.e. WBS Element Details GUI.
Once I publish the new field it will be available in the extension include and the enabled user interface.
In the WBS Element details screens a new Tab Custom Fields is available, displaying the custom fields created via Key User Extensibility. The tab is e.g. available in Project Builder as displayed below, but also in other maintenance UIs such as Change WBS (CJ02) or the details popup in the Project Planning Board.
Key User Extensibility fields are also included in archiving, substitution and validation and project versions/simulations. For Project and WBS Element the extensibility fields can be exposed via the published read API, but not via the BAPIs.