S4HCKS27 How to handle varied multi-level approval processes and leverage a Business Rules like Framework

Some organisations have somewhat straight forward approval rules in place. By that I mean that there is a well defined structure where for example based on amount ranges and cost assignment types, one or more approvers will need to be determined to approve a spend. The approval process can span across several levels and the only variable that determines how many levels of approvals will be required are usually determined by the amount to be approved.

Then there are some organisations, where the approval  process is much more complex. For example a first level could be determined based on the account assignment, the second level could be based on the material type (service vs stock material), the amount of the spend, etc… you get the point, there are many more variables in play, that make the process more complex as more business rules need to be catered for….and the last thing that you want is for those rules to exist in your code! It is OK for the logic to embedded in code, but the rules (i.e whether John or Jane should approve) should be maintained by your business users. When the rules change or when employee leaves the organisation, such changes to your approval rules should be the responsibility of the business users to maintain.

Thankfully in SAP S/4HANA Cloud, especially since 1805 with the introduction of new functionality that allows you to keep track of approval levels in your custom logic, things just got a whole lot simpler!

In this simple example shown in the video, we will create a 2 item purchase requisition. As we are also performing the approval process at the item level, we will fire off 2 work items – one for each purchase requisition item. In this example, we are wanting to route the approval to a person that is neither the person responsible for the cost object, nor the manager of the person that created the requisition. We will therefor use the workflow approval Badi to define the logic to determine the approver(s). However as I said previously, we do not want to code in the logic the person that will receive the workflow approval request. No – we want to leverage a Business Rules like structure to hold this information.

To do so, we have created a custom business object – an approval table, as shown below.

The table that we added is simple in structure. For it we track the approval level, the cost object (the cost centre) and the approver of this combination. For the sake of simplicity, we will use the same table for the 2 approval levels that we have, but you can imagine, that you would have a different table for each approval level (if the structure was different of course).

From a coding point of view, there are two key elements in our logic.

The first one is retrieving the cost centre that was indicated as the cost assignment of the requisition items. To retrieve this information we directly call an API –> i_purreqnacctassgmt_api01. The code used here is:

SELECT SINGLE costcenter FROM i_purreqnacctassgmt_api01 INTO @data(lv_purchasereqcostcenter)
WHERE purchaserequisition = @purchasingdocument AND
purchaserequisitionitem = @purchasingdocumentitem.

Then the next piece of code is that which we use to retrieve the user that will become the approver. As I said, we do not want this in the code – so we need to go and fetch that information from our custom business object. The code used here is:

SELECT single approvinguser FROM yy1_approvalstable INTO @ls_badi_approver
WHERE CostObject = @lv_purchasereqcostcenter AND
ApprovingLvl = 1.

Essentially we are retrieving the business user ID of theApprover , for which the cost centre and approval level match where we are in the purchase requisition approval process.

Video: Varied approval process supported by a Business Rules like Framework

Update 19 July 2018

By request, I am also adding the full custom logic code which I used to illustrate this determination.

DATA:

ls_badi_approver TYPE if_mmpur_workflow_agents_v2=>bd_mmpur_s_badi_approver,
lt_badi_approver TYPE if_mmpur_workflow_agents_v2=>bd_mmpur_t_badi_approver,
ls_previous_approver TYPE if_mmpur_workflow_agents_v2=>bd_mmpur_s_previous_approver,
ls_new_approver TYPE if_mmpur_workflow_agents_v2=>bd_mmpur_s_badi_approver.

SELECT SINGLE costcenter FROM i_purreqnacctassgmt_api01 INTO @data(lv_purchasereqcostcenter)
WHERE purchaserequisition = @purchasingdocument AND
purchaserequisitionitem = @purchasingdocumentitem.

SELECT single approvinguser FROM yy1_approvalstable INTO @ls_badi_approver
WHERE CostObject = @lv_purchasereqcostcenter AND
ApprovingLvl = 1.

APPEND ls_badi_approver TO lt_badi_approver.
ls_badi_approver-approvallevel = 1.

SELECT single approvinguser FROM yy1_approvalstable INTO @ls_badi_approver
WHERE CostObject = @lv_purchasereqcostcenter AND
ApprovingLvl = 2.

APPEND ls_badi_approver TO lt_badi_approver.
ls_badi_approver-approvallevel = 2.

** remove the previous approvers from the list of BAdI approvers
LOOP AT previousapproverlist INTO ls_previous_approver.
READ TABLE lt_badi_approver INTO ls_badi_approver
WITH KEY businessuser = ls_previous_approver-businessuser.
CHECK sy-subrc = 0.
DELETE lt_badi_approver WHERE approvallevel = ls_badi_approver-approvallevel.
ENDLOOP.
*
** determine the next approval level and appropriate approvers
READ TABLE lt_badi_approver INTO ls_badi_approver INDEX 1.
LOOP AT lt_badi_approver INTO ls_new_approver
WHERE approvallevel = ls_badi_approver-approvallevel.
APPEND ls_new_approver-businessuser TO approverlist.
ENDLOOP.

If you want to replicate my custom business object, here is its structure.

Lastly, I am also adding the ‘After modification’ logic that I used in my custom business object. This logic is used to increment the ID number of the custom object entries as well as retrieve the name of the user id entered (useful to confirm that the entered code is a valid one).

* After Modify Determination for Node ID APPROVALSTABLE
*
* Importing Parameter : association (Navigation to Parent/Child/Associated Node Instances)
* write (API for creating and updating Custom Business Object Node Instances)
* Changing Parameter : APPROVALSTABLE (Current Node Data)

* set ID
IF approvalstable-entryid IS INITIAL.
SELECT MAX( entryid ) FROM yy1_approvalstable INTO @DATA(current_max_id).
approvalstable-entryid = current_max_id + 1.
ENDIF.

IF approvalstable-approvinguser IS NOT INITIAL.
approvalstable-approvername = cl_abap_context_info=>get_user_formatted_name( approvalstable-approvinguser ).
ENDIF.

If you enjoy this post, please consider subscribing to our youtube channel and follow the hashtag #S4HCKS on twitter.

Version used in recording 


S4HCKS26 Extend S/4HANA Cloud with a native iOS SAPFiori app with the iOS SDK

In this SAP S/4HANA Cloud Knowledge Snippet (S4HCKS), we will be exploring how easily you can extend your SAP S/4HANA Cloud system by building a native iOS app for your users. You might ask the question why? After all my S/4HANA Cloud system is consumed via a web browser so why would I want to build an app for that? I take your point, but:

  • Not all apps can be consumed on a phone size screen (either the app is not available or the user experience would be terrible)
  • With a native app, the GUI elements reside in the app on the phone (if you are in an area where mobile charges are steep, this is important)
  • With a native app, you can have offline capabilities which is mighty helpful when there is no cellular coverage
  • You might want to create a mashup app that interacts with your S/4HANA cloud system as well as other external systems (without needing for the user to log on to multiple apps)
  • Maybe you have a predominantly nomadic workforce and it makes sense to build a native app that integrates with other functions on your device (camera, phone, GPS, etc…)
  • ….and many more.

So in this snippet, we will use a custom business object as the starting point, expose the data from this custom object as an Odata service, consume it as a service that is registered as a destination on the SAP Cloud Platform – and all that on an native iOS app built with the SAP iOS SDK. Why? Because I want to demystify the preconceived idea that this is too complex and in fact show how easy it is to do all this with the tools that SAP provides. I am by no stretch of the imagination a developer, so if I can do it, then so can you. Furthermore, all the tools used in this snippet are free, so there really is no excuse to not give it a go! You just need an Apple Mac!

There are certain things that are not covered in this movie, such as creating a communication arrangement in S/4Cloud, or what you need to do on the SAP Cloud platform, where to download the iOS SDK, etc…. There are plenty of blogs, videos and tutorials out there to help you for that. I have however listed a few choice ones below that I found very helpful during my explorations.

Lastly, I would like to point out that I was damn impressed with how much the development team was able to pack in this SDK! As you will see in the video, after having indicated just the web service that I want to consume, the app that is built out of the iOS SDK is just so complete! Sure you cannot put that in the hands of your users, but the amount of functionality that is delivered in this app, without needing for me to type a single line of code is just mind blowing. It sets the stage for you to be able to, with minimal changes, to build an awesome app to your users.

Video: Extend SAP S/4HANA Cloud with a native iOS SAPFiori app with the SAP iOS SDK

If you enjoy this post, please consider subscribing to our youtube channel and follow the hashtag #S4HCKS on twitter.


S4HCKS22 User Authorizations in SAP S/4HANA Cloud

In this S/4HANA Cloud Knowledge Snippet, we will be going back to basics and look at a topic that is too often considered as an after thought : Authorizations. In other words who can see and do things in your system. Whilst it is understandable that you want to go straight to the heart of the action and explore all the great features of SAP S/4HANA Cloud, I can only recommend that you give this topic its due attention – as not doing so could be prejudicial to your organization.

This snippet will begin with a introduction to the topic, explaining the authorisation concept in SAP S/4HANA Cloud, and then move on to a concrete use case in the system – showing you how to create a role, maintain the authorisations that you want this user to have and then see if that user is indeed able to do what I want to do. Toward the end of the snippet I also show you some additional features that are available to you when working with roles, and in particular how to move them from your testing environment to your production landscape.

For those of you that want to jump right to a topic, I have below indicated the time markers:

Introduction to authorizations in SAP S/4HANA Cloud – how things hang together  00:45
The apps to work with to manage roles 01:30
From authorization to user and everything in between 03:00
A concrete example – Setting it up in the system 10:22
Topic round offs 36:00
If you enjoy this post, please consider subscribing to our youtube channel and follow the hashtag #S4HCKS on twitter.