Product Information
Flow Builder: Understand the difference in trigger mechanisms: manually created job, event based job and technical job
This post describes the trigger mechanism used in Flow Builder 1.0. For Flow Builder Plus in OP2021 or higher releases, please refer to my post Flow Builder Plus: Understand the difference in integration (job trigger) mechanisms | SAP Blogs
One Exposure is the central storage which targets to all actual and forecast operational business transactions, it plays as the single source of truth for all financial risks from operations. The SAP Cash Management is using One Exposure as it’s storage for the apps.
Flow Builder is one of the available programs, tools that will generate flows by parsing accounting documents (via document chain). With respect to the data volume of the real business, the flows generated by Flow Builder is the majority among all source application.
Flow Builder provides the running type ‘Delta Run’ which targets to handle the new posted or modified accounting document. The integration point between Accounting Document is via traditional RWIN modules. With this design and given an ideal environment (all configuration are correct and no Flow Builder is running), once an accounting document got posted, Flow Builder shall be triggered as a background job to perform Delta Run.
This blog tries to reveal all three different trigger mechanisms used by Flow Builder cross different releases:
- When we introduce Flow Builder first time in Simplified Financials 200, the trigger mechanism is actually the ‘manually’ created jobs. We provided a utility program which allows you to control the job’s creation:
The checkbox ‘Trigger Job Automatically’ is the switch. Via other parameters, it can control the delay times, job variant, and background job for authority checking.There is also one kind of famous job for Flow Builder with suffix ‘_SUB‘. It’s a designed behavior for ‘manually’ created job mechanism. Those ‘SUB’ jobs are triggered by Flow Builder itself. The logic behind this is, Flow Builder (with Delta Run) will take seconds to finish the flow generation, it could happen that there are new accounting documents posted in the same period. Flow Builder will recheck the delta table after it finished the current task, if there are new entries, Flow Builder will trigger one ‘SUB’ job for itself. Imagine a very busy system in which documents got posted each second, the ‘SUB’ job will be keep triggered by Flow Builder itself.
- Within S/4HANA OP 1610, we updated the previous manually created job to event-based jobs via SAP Note 2256759.And another Note 2560395 was provided to guide setup the event manually. The change applied in that Note use event SAP_FCLM_FLOW_BUILDER to control the Flow Builder’s startup. And, as the influence of the change of trigger mechanism, Flow Builder won’t provide job control anymore. Please be aware that, this Note only applies to OP1610, it won’t impact the higher release.
- Since S/4HANA OP 1709 and higher releases, we decided to use ‘Technical Job‘ as the trigger mechanism for Flow Builder. The new defined Technical Background Job FCLM_FLOWBUILDER_JOB is also event-based one, we use a different name SAP_FCLM_FLOWBUILDER_TRIGGER to avoid misuse of event-based job mechanism above. We also define the new created technical job as scope dependence to reflect the facts not all clients need Flow Builder. Therefore, after you upgrade to OP1709 or higher, you need to define the scope to enable Flow Builder in the specific client.
Ensure the FCLM_FLOWBUILDER_JOB was inserted into scope as following:
Please be aware that the standard ‘Technical Job’ defined here using the default program variant for Flow Builder: ‘SAP&BG4’, which using the chain step 4. If you need a different chain step, you have to perform: (a) Do NOT insert scope as showing above and (b) create a manual job for program FCLM_FLOW_BUILDER and your preferred variant via SM36, and ensure the newly created job started condition is ‘After Event’, use Event SAP_FCLM_FLOWBUILDER_TRIGGER and use the current client as its parameter.
Hope this blog can help understand the different trigger mechanism of Flow Builder. Feel free to leave a comment here in case there is something unclear in this post.
HI,
what is the oss note that detail step by step how activate the job flow_builder? I have the job with status GREY et not green so FCLM_BSEG_DELTA is not empty and the job not work, we are in 19.09 release.
Thank a lot
Daniele
Hi Daniele,
We had the same issue. Please check if the user SAP_SYSTEM is existing in the system. For more information see the Note 2339022-Maintain Default Step User for SAP S/4HANA Job Repository (On-Premise scenario).
Hi,
This blog was useful.
I have one query: Is it possible to execute Flow Builder on the background job in the real time when FI/MM document is posted?
Hi,
Yes, Flow Builder can be triggered as 'real time' for FI/MM posted. Actually by default, it is triggered in real time in most cases.
Hi,
Thanks for your help. I have a follow up question:
Where can I check real-time settings? I'd like to know configuration point.
HI
use tx SJOBREPO - Job Repository check if there is job FCLM_FLOWBUILD_JOB with two status green and flag job scope=x
if Status job on le right is grey try
try to regenerate the loading classes as note 2369432 - Flow Builder- Generate and Assign Loading
check the table FCLM_DELTA_BSEG if it is empty or with document, after a payment made by f110, if you see the document fi payment number in table FCLM_DELTA_BSEG hte job don'to work.
Finally create a manual schedulate the job as indicate in the following blog by tx SE36
https://blogs.sap.com/2019/03/29/how-to-set-up-the-ff7an-flow-builder/
In this way you can configure the Job of transaction FF7AN, so that it is updated automatically.
check if job work by tx sm37 after you have to make a F110 payment and FCLM_DELTA_BSEG if empty
BR
DS
Dear Hongjun,
Thanks a lot for your blog. This blog did help me to troubleshoot issue. Kindly make a note of typo in 'Scope switch of technical background job' at below section.
Thanks a lot.
Regards,
Anand Raichura
Thank you very much, Anand.
Typo has been created.
Best regards, Hongjun