PaPM - Business Events

[chayan_chattaraj]

Can somebody please help with some documentation on what are the exact steps to set up Business Events in PaPM Functions so that when a PaPM Function fails in the Process it raises an event and that can be handled via Business Event Manager?

We are using PaPM Processes and we would like to set up some rules so that if Allocations produces some errors due to unallocated balances then they can be ignored or some actions taken depending on the unallocated balances.

[alex_marasigan]

Hi Chayan,

Good day.

We have documentation for the Business Event topic on our Help portal. I am providing you the link below for your reference:

https://help.sap.com/viewer/56471df1959f4cfd9e3bf7a6d2d5be42/3.8/en-US/d50e82842c9a4069a713343d91769...

To address the question that you have raised, we need to create and configure the allocation function, create a process and activity on the calculation unit, execute the allocation function, process the unassigned items on My Events and lastly check the result.

Now I am going to ask you to log in to your PaPM environment and follow the steps below.

Configuration

Allocation Function

1.Create an allocation function with its Event handling set to “Management”.

Note: if the event handling is set to “Logging” the unassigned items will not be transferred to My Events for further processing.

2.Proceed with your allocation function configuration:

1. Assign an input function on the sender tab
2. Assign an input function on the receiver tab
3. Assign fields on the signature tab
4. Assign the following on the rules tab:

• i.Rule
• ii.Configurations on the sender rule tab
• iii.Configurations on the receiver rule tab

3.Activate the function

Calculation Unit Function

4.On the Calculation Unit function assign a Process

5.On the Activities tab assign the allocation function that you created and assign a Performer and Reviewer.

6.Activate the Calculation Unit.

Execution

via Environment

7. Run the Allocation function

Note:

• If you encounter unassigned items on your allocation run there will be 2 errors that will appear - Processing Message "Unassigned Items" for Volume=XXXX and Quantity=Y

- Function=ZZZZZ has unprocessed Business Events of Volume=XXXX and Quantity=Y

Where:

XXXX - is the aggregate value of all key figures

Y- is the number of unassigned items

ZZZZZ – is the function ID

• Please save or take note the results of the run, as you will need this later for checking.

Via Deploy and Process

8.Choose the Processes tile and create a new process.

9.Choose the Add button, Create process Instance window will appear.

10.Search for the process that you have assigned on the calculation unit (steps 4 - 6), choose the process and click on Create button.

11.Process ID and Description window will appear, assign the following:

• Process – choose your process name
• Description – assign a description of your process name

Choose the Create button.

12.Generate New Report window will appear, assign the following:

• Report ID – Your report consisting of alphanumeric ID
• Report – Description of your report ID

Choose the Generate button.

13.Choose the created process then choose the Deploy button.

14.Once the process has been deployed, go to My Activities by choosing the My Activities tile from the Fiori.

15.Search and choose for your deployed process.

16. On the right part of the screen select the activity and choose the Run button, notice that the state of the run is “Errors”

17.To handle the errors, choose the Go To button and select Business Event Management.

Business Event Processing

Note: if you execute the allocation function both on the environment and via process and deploy, you would notice that there are two events that will appear on My Events, the reason is that the system creates an entry for each process instance.

18.My Events and Rules window will appear, choose the allocation function with unassigned items,

19. Choose the Edit button located on the upper right corner of the screen.

20. The Selection section on My Events represents your sender data or unallocated data, while the Assignment Section represents the receiver data. You may set the values on the Assignment section on which you want to the unallocated amount be assigned.

21.Once the configurations are done, choose the Event Type button and change it to Adjustment.

• Event – the event will not be handled and left in an open status
• Adjustment – The user can adapt and correct the underlying data for this event and run the corresponding activity again. This step can be repeated until the situation has been resolved and the quantity and volume show 0. The business event handling applies a one-time rule to adjust the data accordingly.
• Transmit – the erroneous record will be moved directly to the result without adjustment.
• Ignore – if the event is not material or otherwise important, the event can be ignored. No partial restart of activity is necessary in this case.

22.Click on the Run button and choose Partial Restart.

23.Go back to My Activities, notice that the state is now “OK”

Checking the results

You may check your result by going back to the Environment, choose your allocation function then choose the Show button. You can see that the unassigned amount/items are already distributed. The Y table for the allocation function is updated after each process on Business Events.

[ManojJ]

I am trying to set up the rules in 'My Events'. I can manually adjust the 'unassigned error', but I want to automate this process using the rules option. However, I'm having trouble resolving the error automatically. I am using perfect selection and assignments in rules. But error is not resolved in my activities. Has anyone successfully managed events using rules? I would appreciate your advice.