[2017-02-17] Update with the latest features for S/4HANA Cloud 1702 and S/4HANA 1610 (on premise version).

S/4 HANA comes with a new extensibility concept. SAP has announced the new extensibility concept in a white paper published some weeks ago (S/4HANA Extensibility – The new White Paper). A major pillar of the extensibility concept is the key user extensibility tool set that is part of S/4 HANA. Other extension scenarios are supported by SAP HANA Cloud Platform (HCP), e.g., integration of SAP- and non-SAP cloud solutions or development of Fiori like UI’s using Web IDE. You will find an overview in the white paper mentioned above and many more useful links here:Extensibility of S/4HANA – Helpful Links.

In this article, I want to share some insight into the key user extensibility tools. But at first, let me summarize the most important facts.

The S/4HANA key user extensibility tools follow the principle of leading cloud services (see for example the SAP cloud services of SuccessFactors, Ariba, Cloud for Customer and SAP Business ByDesign, but also services of SAP’s competitors). So they are designed for the cloud, but also made available in the on-premise edition:

  • They are completely web-based (developed along the Fiori principles and technology) and targeted for the key users and therefore easy to use.
  • The artifacts created with key user tools are lifecycle-stable. This means, they are based on public, stable APIs and technology so that they will continue to work without adaptation after the next upgrade.

After this short introduction, let me introduce the tools in detail:

UI Flexibility

As a key user you can change the layout of you tables and forms directly in the running UI in the UI Adaptation Mode. You can:

  • Hide fields in a form, table, or filter
  • Rename labels
  • Add field to UI from field repository
  • Move form field or UI block
  • Define new filter and table variants
  • This feature is available as of S/4HANA version 1506 (cloud) for selected UIs

AdaptationMode.png

Figure: UI Adaptation Mode – Adaptation Mode with Drag&Drop Configuration

 

UI_AdaptationMode.png

Figure: UI Adaptation Mode – Form-based Configuration UI

 

The UI adaptation mode has two different implementations:

  • A drag-and-drop “runtime adaptation mode”, in which you can configure the UI via drag and drop. The following video https://youtu.be/-0W_fvzpJZk and the related document http://scn.sap.com/docs/DOC-68081 nicely shows the features of the adaptation mode. You can start the adaptation mode from the menu under your account information under “Adapt UI”.
  • A form-based configuration UI in which you can configure your tables, forms, etc.. You can start this UI with the “gearwheel” icon. The form-based configuration will be replaced by the drag-and-drop “runtime adaptation mode”, but may be still in place for more advanced configurations in the future.

Custom Fields

In the Custom Fields and Logic Fiori app, you can add and edit custom fields. You can

  • Create and edit custom fields (extend the SAP table, application, CDS views and OData services)
  • Manage the usages of a custom field such as other UIs, reports, forms, service interfaces, processes (data flows), search.

The Custom Fields and Logic Fiori app completely hides the technical details of the underlying software stack (for example database table, CDS views, OData services) from you as a key user. Together with the UI adaptation mode, you can simply add a new field end-to-end with a few clicks.

This feature is available for released SAP business contexts. As of version 1702 SAP offers more than 100 extensible business contexts (including business partner, product, sales document, project, …). Additional SAP business contexts will be enabled for custom field extensibility in subsequent versions.

See also the video in the SAP user assistance: https://cp.hana.ondemand.com/dps/d/preview/1a93686c176845f0832a2a73221dd90b/1603%20500/en-US/frameset.htm?3ccb50e724b045508fea8b2cf1774b2b.html (-> Extensibility Scenarios -> Creating Extension Items and Transporting Them)

 

CustomFields.png

Figure: Custom Fields Fiori App

 

Custom Business Logic

In a state-of-the-art Web editor in the Custom Fields and Logic Fiori app, you as a key user can easily add business logic to existing enhancement options.

The Web editor completely hides the technical details of the underlying enhancement technology (e.g. SAP BAdIs) from you as a key user. It provides an easy way of exploration of APIs with key user documentation, and syntax check, syntax highlighting, code completion. Testing capabilities are included.

As programming language wit use a Cloud- and key user enabled version of the ABAP language optimized for:

  • Robustness / security / data consistency: For example, the following statements are not allowed: any DB operation except selects from released views, spawning new tasks, dynamic programming, code generation
  • Simplicity: For example, obsolete ABAP statements are removed from the syntax

Selected SAP business contexts are enabled for business logic extensibility. See also the video in the SAP user assistance: https://cp.hana.ondemand.com/dps/d/preview/1a93686c176845f0832a2a73221dd90b/1603%20500/en-US/frameset.htm?3ccb50e724b045508fea8b2cf1774b2b.html.

 

CustomLogic.png

Figure: Custom Business Logic Fiori App

 

Custom Business Objects

With the Custom Business Objects Fiori app, you can create and manage custom business objects. A custom business object is a hierarchical set of database tables with an API for creation, retrieval, update and deletion of data. You can provide business logic in a Web editor using the Cloud-enabled version of ABAP (same as for Custom Business Logic).

In the Custom Business Objects app you can:

  • Create your own business objects and the corresponding database tables
  • Add fields to business objects, delete fields and business objects that have not yet been transported to your production system
  • Create CDS views, OData services and UI to enter data through a UI or data load from other customer systems
  • Create multiple sub-nodes for one business object
  • Implement custom logic on node level
  • Publish business objects, Edit business objects that have already been published, reset business objects to their last published version

For additional information, see: General Functions for the Key User. See also the video in the SAP user assistance.

 

CBO.png

Figure: Custom Business Objects Fiori App

 

In S/4HANA Cloud Marketing edition, you can fill data into Custom Business Objects using an OData service (e.g. from a third-party system) and use the Custom Business Objects as Segmentation worksets in the Segmentation Modelling app to filter contact data with SAP HANA views.

As of version 1608 (Cloud) you can expose Custom Business Objects as OData Services for consumption in SAP HANA Cloud Platform of other external clients.

KPI Design

With the KPI design Fiori apps, you can define new KPIs for your organization based on CDS Views / ODATA Services:

  • Modify SAP delivered KPIs by copying them and adjusting to your business needs
  • Define drill downs to analyze the KPIs to better understand your business situation
  • Apply filters on the drill down to narrow down to your area of interest.
  • Save the filtered analysis to launch the same analysis at a later point in time
  • Define associations between KPIs so that they are available during analysis at runtime.
  • Navigate to transactional apps to take action based on your analysis

Custom Analytical Queries (Query Builder)

With Version 1605, the Query Builder app was renamed to Custom Analytical Queries. With the Custom Analytical Queries Fiori app, you can create and manage analytical queries:

  • Copy a query from a SAP delivered standard analytical query
  • Add or remove or customize field defined in the query (defining new labels for a field, display data as key or text, show or hide result rows etc.)
  • Add or remove filters (pre-configured fixed value filters or user input values filters)
  • Create parameters to read the values from the user
  • Create custom fields such as restricted measures or calculated measures
  • Testing included: Preview the results by executing the report

You can build custom analytical queries on top of:

  • Released cube views of the SAP delivered Virtual Data Model (VDM).
  • You own custom CDS cube views (created with the Custom CDS Views app, see below)

See also the SAP user assistance:

https://cp.hana.ondemand.com/dps/d/preview/1a93686c176845f0832a2a73221dd90b/1603%20500/en-US/frameset.htm?3ccb50e724b045508fea8b2cf1774b2b.html

QueryDesigner.png

Figure: Query Builder Fiori App

 

Custom CDS Views

If you need access to data in your system in a way the system does not offer so far, you can create your own data access by making use of a Core Data Service view (CDS view). CDS views allows you to model the data access without changing the underlying database tables. They are used to combine and arrange the table fields of multiple data sources. The same time you can add metadata like semantics or a just define a new label for a certain field.

With the Custom CDS View app, you as a key user can model company-specific data access on top of public CDS views. You can build Custom CDS views on top of:

  • Released views of the SAP delivered Virtual Data Model (VDM). As of version 1702 SAP offers more than 350 released views (including business partner, product, sales orders, project, …).
  • You own custom CDS views

Custom CDS views can be used in various extensibility scenarios like in analytics (see next section).

The Custom CDS View app allows you to:

  • Display a list of all pre-delivered data sources (VDM CDS views) and already existing custom CDS views
  • Preview the available data sources (CDS views)
  • Create new custom CDS views
    • Choose a primary data source
    • Add one or more associated data sources according to your needs
    • Select the fields and associations that should be used in the new custom CDS view
    • Perform changes on the properties of the new fields
    • Display the parameters of the selected data sources if they contain such
  • Delete custom CDS views

As of version 1702 (Cloud) you can expose CDS views as OData Services for consumption in SAP HANA Cloud Platform of other external clients.

For additional information, see https://cp.hana.ondemand.com/dps/d/preview/1a93686c176845f0832a2a73221dd90b/1603%20500/en-US/frameset.htm?3ccb50e724b045508fea8b2cf1774b2b.html

 

CDS.png

Figure: Custom CDS Views Fiori App

 

Custom Forms

With the Adobe Forms Designer and the Maintain Form Template Fiori app, you can create new form templates:

  • as a copy of a SAP standard form
  • based on an existing data source (ODATA service)
  • based on an extended ODATA service using already existing fields and associations from published CDS views

With the Maintain E-Mail Templates Fiori app you can create new e-mail templates

  • based on an existing data source (CDS View)
  • based on an extended SAP data source (CDS View)

The forms extensibility tools are available as of S/4HANA version 1506 (cloud) and 1511 (on premise). Selected SAP forms scenarios are enabled for creating new forms for version 1506 and in subsequent versions. See also the video in the SAP user assistance: https://cp.hana.ondemand.com/dps/d/preview/1a93686c176845f0832a2a73221dd90b/1603%20500/en-US/frameset.htm?3ccb50e724b045508fea8b2cf1774b2b.html

EMailDesigner.png

Figure: Maintain E-Mail Templates Fiori App

 

Custom Catalog Extensions

With the Custom Catalog Extensions Fiori app, you can extend SAP Fiori catalogs. As of 1605, two use cases are supported:

  • Add custom business object UI to a SAP Fiori catalog
  • Add a Smart Business KPIs to a SAP Fiori catalog

By extending the Fiori catalog the respective custom Fiori tile is assigned to to the selected Fiori catalog, and the tile appears in the Fiori Launchpad. in the Fiori Launchpad, you can use the “Personalize Home Page” feature to add custom tile to one or more launchpad groups.

Custom Communication Scenarios

With the Custom Communication Scenarios Fiori app, you can expose custom OData services for consumption in SAP HANA Cloud Platform of other external clients. You can expose OData services for:

  • Custom Business Objects (created with the Custom Business Objects Fiori app)
  • Custom CDS views (created with the Custom CDS Views Fiori app)

To expose custom OData services SAP HANA Cloud Platform of other external clients, you have to do three steps:

  1. When creating a Custom Business Object or a Custom CDS Views, select the „OData Service“ flag in the respective Fiori app
  2. Create a custom communication scenario in the Custom Communication Scenarios Fiori app. You can combine multiple OData services in one scenario.
  3. Create a communication arrangement in the Custom Arrangement Fiori app. In the communication arrangement, you maintain the technical user that is used by the client. By activating the communication, the system activates the service endpoint and authorizes the technical user for the services that are bundled in the communication arrgangement.

The OData Service and the custom communication scenario is created in the Q system and tranported to the P system (see section Lifecycle Management). The communication arrangement is a system configuration setting that is maintained separately in the Q system and in the P system.

For additional information, see my blog: https://blogs.sap.com/2016/10/19/s4hana-extensibility-connect-sap-s4hana-cloud-sap-hana-cloud-platform-hcp/

Lifecycle Management

As mentioned in the introduction, key user tools are available in cloud and on premise (based on the feature roadmap). However, lifecycle management is different for the objects created with the key user tools.

In the cloud version, the transport of adaptations from the test to the production system is performed by the key user with Fiori apps without interaction with the service provider and outside of the maintenance window of the service provider. The extensibility transport tools are available as of S/4HANA version 1506 (cloud). See also the video in the SAP user assistance:

https://cp.hana.ondemand.com/dps/d/preview/1a93686c176845f0832a2a73221dd90b/1603%20500/en-US/frameset.htm?3ccb50e724b045508fea8b2cf1774b2b.html

In the on-premise version, customer manages SAP updates and customer transport with “classical” transport tools (correction and transport system, CTS).

 

CustomTransports.png

Figure: Manage Software Collections  Fiori App

 

SAP S/4HANA Cloud

In the Cloud edition, the system is completely pre-configured. Fiori catalogs, tiles and roles are pre-configured and can be assigned immediately in the “Maintain Business Users” Fiori app. To get access to the key user extensibility tools, assign the the following catalog roles to the rspective users:

  • Extensibility (SAP_BCR_CORE_EXT)
    • UI Flexibility
    • Custom Fields and Logic
    • Custom Business Objects
    • Custom CDS Views
    • Custom Catalog Extensions
    • Custom Communication Scenarios
  • Query Design (SAP_BCR_BW_AQD)
    • Custom Analytical Queries
  • Output Management (SAP_BCR_CORE_OM)
    • Maintain Email Templates
    • Maintain Form Templates
  • Manage Software Collection
    • Manage Software Collection,
  • Import Software Collection
    • Import Software Collection

 

SAP S/4HANA On Premise

In the on-premise version, you have to create your own roles, catalog and tiles according to the documentation. For details, see http://help.sap.com/s4hana_op_1610 > Product Assistance (English) > SAP S/4HANA Enterprise Technology > SAP NetWeaver > General Functions for Key Users > App-Specific Implementation and Configuration Information

 

The following extensibility tools are available in the on-premise version:

  • UI Flexibility
  • Custom Fields and Logic
  • Custom Business Objects
  • Custom Analytical Queries
  • Configure Software Packages
  • Register Extensions for Transport
  • Custom CDS Views
  • Maintain Email Templates
  • Maintain Form Templates

Links to Documentation and Additional Information

For more useful links on S/4HANA extensibility, see Extensibility of S/4HANA – Helpful Links

 

 

 

To report this post you need to login first.

36 Comments

You must be Logged on to comment or reply to a post.

  1. Clemens Kopfer

    Hi Thomas,

    cannot find any further links on:

    SAP_BCR_BW_AQD

    The “add query” fiori app.

    I guess it was not included in 1511 on-premise release. But strange is the fact that I cannot find any reference. –> Removed?

    (0) 
    1. Thomas Schneider Post author

      Hi Clemens,

      as mentioned in the Query Builder section, the query builder is not available in the on-premise version. So you cannot find this role. Second: I forgot to mention that the roles in the Catalog Roles and Tiles table are for cloud only (in the cloud version, Fiori catalogs, tiles and roles are preconfigured and can be used immediately). In the on-premise version, you have to create your own roles, catalog and tiles according to the documentation. I will add a section on the difference!

      Best regards,

      Thomas

      .

      (0) 
          1. Clemens Kopfer

            Thanks a lot

            Yes indeed section is short AND I do read your excellent post, but even your excellent post cannot make up a fully fledged documentation… 😉

            (0) 
            1. Thomas Schneider Post author

              + if you start the Query Designer and click the (?) icon, you get the inline user assistance which contains much more information. Unfortunately this info did not make it to the current release of the help portal. Colleagues are working closing this gap.

              (0) 
              1. Mohit Chopra

                Hello Thomas..

                Thanks for sharing very useful information on tools.

                I have one question regarding Extensibility of On Premise S/4 HANA Deployment..

                I saw in white water its clearly mentioned that all classic extensions which we use to perform in Business Suite will be valid in on premise version as well.

                Actually I have couple of S/4 HAna systems and i can see some enhancement points in that system but when i try to create new Implicit Enhancement I get Error message that S/4 Core cannot be enhanced. Now some colleagues of mine are telling that Enhancement spots and implementations will not be allowed in S/4 HANA Onpremise. I am confused whether these enhacements are allowed or not.

                I understand that HCP and Key User Extensibility are preferable approaches even for On Premise but just wanted to understand that Classis Enhacements Implicit and Explicit are allowed in S/4 HANA On premise version of not?

                It will be really helpful if you can clear this doubt.

                (0) 
                1. Clemens Kopfer

                  S4Core: I suppose 1511, correct?

                  Can you name a few BAdIs you were successful/unsuccessful?

                  In my opinion you are correct, BAdIs or customer exits or modifications should continue to work. However, it might be that a few BAdIs or customer exits are not valid anylonger, however, some “artefacts” remained in system and documentation might be outdated…

                  (0) 
                  1. Mohit Chopra

                    Hello Clemens,

                    Thanks for your reply.

                    I am not talking about BADIs and Customer Exits. My question is reagrding Implicit Enhacements points. If you open any standard FM and on Tool Bar there is one Enhance Button and on clicking that you can create Implicit Enhacements any some defined points.

                    When I Click on Enhance I get message that Software Component cannot be enhanced.

                    Need to understand if we are allowed to use this feature or not in S/4 HANA On premise extensions.

                    Best Regards,

                    Mohit

                    (0) 
                    1. Clemens Kopfer

                      clear – was not reading your post carefully enough and “enhancement spot” lead me to BAdI…

                      Curious to reading Thomas answer.

                      By the way, could not find any document which mentions that this very specific enhancement concept will not be supported anylonger…

                      (0) 
                2. Thomas Schneider Post author

                  Hi Mohit,

                  implicit enhancement are not forbidden in S/4HANA. Have you checked the system change settings for SAPSCORE (SE03 -> Administration -> Set System Change Option)?

                  Best regards, Thomas

                  (0) 
                  1. Mohit Chopra

                    Hello Thomas,

                    Thanks for your reply.

                    I dont see Administration Drop Down in any of the 2 systems which i have. Is there any other way in which i can check or change these settings?..

                    Or if you can share some document where its mentioned that Implicit/Explicit Enhacements will be supported in S/4 HANA On premise will be really helpful?

                    (0) 
                    1. Thomas Schneider Post author

                      Hi Mohit,

                      please talk to your system administrator about the change settings in SE03. This is the same game as for Business Suite systems. Please understand that I cannot talk about how to bypass standard SAP authorizations.

                      Best regards, Thomas

                      .

                      (0) 
  2. Atul Mishra

    Hi Thomas,

     

       We have S4 HANA 1511 On premise system. I am trying to set up key extension.

       Could you please provide the Roles and catalog required for On premise version?

    Best Regards,

    Atul

    (0) 
  3. Roger Sainsbury

    H Thomas, thanks for the great blog.

    I’m working with a customer where we are implementing S/4 HANA 1511 FSP1 on premise. This was going to be a question, but I just solved it myself so it’s now an experience to share…

    We want to use the ‘Add Custom Fields and Logic’ app – I’ve successfully activated all the appropriate parts and got it on my Fiori launchpad. I’ve also run ATO Setup in my backend S/4 HANA system.

    When I run the app I get an error message to say ‘Editing not allowed in this system’. This I realised was because in our S/4 HANA (dev) system we have a client 400 for configuration and development, and a separate client 410 for unit testing. Our Fiori System Alias had been set up to point to our unit test client, as there’s where our data is. However for this app, and other extensibility apps, I need it to point to our configuration client. So I just created a new RFC destination for client 400, and a System Alias to go with it. In transaction /IWFND/MAINT_SERVICE I then had to delete the entries I’d created previously for this app, and then recreate them with the new System Alias. Having done all that the app now opens – I just need to learn how to use it now…

    Roger

    (0) 
    1. Roger Sainsbury

      Okay so now I have a question 😉

      When I run the Custom Fields and Logic App, in either tab it’s mandatory to pick a Busines Context. However for Custom Fields I have a very limited selection available – just 11 aside from EPM Demo contexts. For custom logic its even worse – there the only option is EPM Demo. The app I actually want to extend is ‘Revise Payment Proposals’.

      So is there something additional I need to do to make more Business Contexts available for selection? Or is this functionality not yet fully released for S/4 HANA on-premise?

      (0) 
      1. Thomas Schneider Post author

        Hi Roger,

        you are right, there are very few contexts available in the 1511 version because the coding needs to be adopted (“instrumented” and released) by the applications. More contexts will be available in subsequent releases.

        Best regards, Thomas

        .

        (0) 
    2. Chang Eric

      Hi Roger and Thomas,

      I got the same message ‘Editing not allowed in this system’ when opening the ‘Add Custom Fields and Logic’ app. I rechecked the service APS_CUSTOM_FIELD_MAINTENANCE_SRV and SBLE_BADI_CTX_REGISTRY_SRV corresponds to configuration system alias in transaction /IWFND/MAINT_SERVICE. Is there any other point I should take care?

      Regards,
      Eric
       

      (0) 
  4. Daniel Klein

    Regarding the “UI Flexibility” section:

    As a key user you can change the layout of your tables and forms directly

    Does this also impact other users, or is this change only visible to the key user that performed the customization?

    If the answer to the first question is “yes”, I fear that there will be “uncontrolled growth” of these customization tasks if multiple LoB keyusers are able to perform them.

    (0) 
    1. Thomas Schneider Post author

      Hi Daniel,

      a key user change is visible for all users.

      Regarding “uncontrolled growth”: I would recommend that you allow UI changes in a dev or Q system only and review them there. Changes can be transported in ABAP with CTS (normal transport handling).

      Best regards, Thomas

      .

      (1) 
  5. santhosh sivanathan

    Hi ,

    Do we have any standard SAP Guide reference to list the Business contexts available  in the ‘Custom fields and Logic’ fiori application for S/4 Onpremise 1511 sps02 for extensions?

    I have only 18 business context in my application . Other have different numbers, and  the business context ‘TPM customer Invoice’ what is shown in screenshot of this blog  is also not present on mine.

    thanks,

    santhosh

    (0) 
    1. Thomas Schneider Post author

      Hi,

      unfortunately not. We  do not have a central place where you can see the business contexts. We are working on this and I expect that you get this information as part of the documentation soon.

      (The contexts containing “TSM” in their name belong to demo apps. So they are available in demo systems only.)

      Best regards, Thomas

      .

      (0) 
  6. Tom Kornfeld

    Hi Thomas,

    Are there any plans to add the Query Designer and Custom CDS Views apps to the on-premise editions in the (near) future? If so can you give an indication which release these are planned for?

    Kind regards,

    Tom

    (0) 
    1. Thomas Schneider Post author

      the availability for on-premise is definitely planned. I provide updates of the availability in this blog as fast as possible, but unfortunately I cannot communicate this before the official statements

      (0) 
      1. Tom Kornfeld

        Hi Thomas,

        Thanks a lot. The indication to making these apps available for the on-premise editions is definitely planned is valuable enough for the moment. I will keep a watchful eye on this blog.

        Kind regards,

        Tom

        (0) 
  7. Bob van Hees

    Given the following scenario: Utilizing the custom fields and logic application I want to add two new fields to the Business Partner business context. The custom fields and logic application allows me technically add these fields to the BP-table. However, since the Business Partner view is not yet a Fiori/UI5 view but rather a transaction launcher. I cannot see these additional two new fields in the Web UI. The only option I have to read and populate these two fields is through custom logic or OData services. Is that a correct assumption? Or is there an option through CDS? Will this change in the future?

    (0) 

Leave a Reply