Thursday, March 3, 2011

Does your task flow need a transaction?

Task flow is a great feature in ADF and serve as a milestone for ADF 11g. The best documentation for ADF matters is to dig into the fusion developer's guide. The particular matter for task flow is here (

In ADF task flow, there is a concept - "transaction". It is a persisted collection of work that can be committed or rolled back as a group. Task flow present itself as a perfect group for such transaction. Transaction applies when one task flow is interacting with another. For example, there are two task flows here, one is parent task flow (flow P) and the other is child task flow (flow C). When P calls C, there are several transaction options for C. The options specify whether C will join P's existing transaction, create its own transaction or only create its own transaction if no existing transaction in P. Of course, C could also not have a transaction at all, which is the default option.

Steve Muench stated the following in his article: If your bounded task flow modifies data or wants to control when to commit or roll back data modified by anycalled task flows, it will require a transaction. You indicate this by setting the task flow’s transaction property torequires-transaction . At runtime, when Oracle ADF starts a bounded task flow that requires a transaction, one of two things occurs. If no transaction is currently active, Oracle ADF will begin a new transaction and remember the task flow that was responsible for starting the transaction. In contrast, if a current transaction is already open, the new task flow will participate in that existing transaction. Given this rule of thumb, any task flow you build that requires a transaction will either coordinate one or be coordinated by a calling task flow’s transaction, depending on how the task flow is used. Sometimes a task flow requires a transaction but also requires parameters from a calling task flow in order to work properly. In such a case, set the task flow’stransaction property to requires- existing-transaction instead. This says a task flow can participate in an existing transaction but not start a new transaction itself. To indicate that a task flow should never be used as part of an existing transaction, set its transaction property to new-transaction .

Besides the transaction options, there are two more parameters in the context: whether share the data control with the calling task flow and whether set the save point on the task flow entry. I will talk about the two one by one.

Let's look at the whether set the save point on the task flow entry, which is pretty straightforward. ADF save point is a saved snapshot of the ADF model state. It will automatically created if the task flow is called based on a existing transaction. Upon the return of the called task flow, there is an option "return save point" to set to true to roll back to the implicitly save point created by ADF. The default value is set the save point at the task flow entry. This parameter is not available the transaction option is set to "always start a new transaction" which literally tells since the a new transaction will be created upon task flow entry, there is no effect to the previous transaction at all, so the save point is no need here.

Whether share the data control with the calling task flow is an important parameter to note. I will demonstrate it using an example. Say we have 3 task flows, A calls B, and B calls C. A and B have the same data control frame (save Application Module), and C has a different data control frame. If the share data control parameter is set to true, which is the default. What happens is a data control instance created upon A flow enters. When B called from A, it will detect it's the same data control and will refer to the same instance as A does. When C called from B, even though it's not the same data control, ADF will nest the C's data control instance under A and B's data control instance. It's like the nested application module. The advantage is share the data control across the task flows will use the same DB connection.


Lala said...

trThanks for your article and welcome to check: here.

Anonymous said...

explained nice. How does taskflow txns releates AM transaction object

Anonymous said...

mentioned that she fresh publication an determinative about how sail through salons square measure pain since hoi polloi ar doing their own nails in ordain to save up money. So, I shot when you think about it, $16 isn’t a unregretful total for horny structure Slavic language you can get a metropolis magnitude of uses out of and have frivolity with it. I know it’s silly, but one of the principal reasons I’ve avoided purchase a duet of downfall boots is, well, that virtually downfall boots look like downfall boots. Not to note I emotion lugging approximately a set of position to change into once I’m indoors. But in the late of a abundant rain during my change by reversal this morning, I distinct that it’s finally time to impedimenta organism refractory and to middle organism virtual by finance in a bring together of bad boots dicks sporting good coupons I didn't in truth miss to situated myself up for failure. Was hard to outset this year impression undecomposed and bright, without all the required guilt that accompanies the first failed move at quitting chocolate, sugar, alcohol...or whatever else I've decided to form from my lifestyle.I'm in particular loving of eroding this write of blouse in a colourful color in teamed up with a cypher fabric, either somthing unreal like silk or vaporous like chiffon. I also eff pairing it with planted clipping trousers for a flirty boyish energy. Here ar tierce faddy construction to take in this blouse into your accumulation for whatever and all occasions Over the volume unit year this untidy equipment-style top kept sound up, and this is one way I want ever fizzles out. It's the perfective Libra of perception pulled together time at the identical time organism credibly comfortable. And it looks just as good flying as it does with quadruplex pieces superimposed on top.

Anonymous said...


Did you write anything or explain in an easier manner that is not present in documentation or difficult to understand by reading documentation. Give it a thought

Thanks !!!