Skip to Content
Author's profile photo Jerry Wang

Automatic Delta Handling in Webclient UI

A real case which is related to Automatic Delta Handling

I use a ticket which I am struggling with recently to start this blog. It took me almost the whole day to dig out the root cause.

How to reproduce the issue – Just create a new Product by clicking new Product button:


The strange thing is, after button is clicked, I didn’t see the expected new product creation page. Instead, I saw the weird page below: the whole UI area almost kept unchanged except the page title changed from “Search:Products” to “Product: New”. Why the left product creation page failed to be rendered???


How I find the root cause

Since the UI page didn’t crash, there is no surprise that I didn’t find any related dumps in ST22.

I am 100% sure that there must be some exception occurred in the backend and caught by framework, but unfortunately without any message raised out in UI. So I use the tip described in my blog to start debugging. Several minutes later, I felt really frustrated since the breakpoint for ABAP keyword CATCH is triggered so frequently in UI framework processing. I was completely lost in the debugging. ( At that time I didn’t try conditional breakpoint group since I am not sure whether it could help)

Then I asked for help from one colleague who is an UI expert. He suggested:” Hey, try to switch off delta handling and try again”. Wait, what is the delta handling? After exploring for quite a time I switched it off and retry, here below is the result under delta handling off mode:


Bingo! This time the framework did provide quite useful information to me – something wrong in overview page toolbar processing.

I looked into GET_BUTTONS method and found there is a case that one initial reference variable is being used.


Once that line is executed,


The exception is caught by UI framework.


Here below is something more I want to share with you regarding Automatic delta handling

What is Delta Handling mechanism in Webclient UI?

The Delta Handling is a collection of mechanisms to reduce the rendering time on the client and the network load when transporting the request and response between server and client. It consists of Manual delta handling ( out of scope of this blog) and Automatic delta handling. The Manual Delta Handling bases on the tag library TAJAX. With this library we can define areas on views and rules for updating these areas basing on events.

In most of the case Automatic Delta Handling (ADT) is used. The ADH uses also the technique provided by the tag library TAJAX. Instead of defining complex rules for dependencies between TAJAX-areas, when the page is being prepared for the rendering, ADH detects which areas (e.g. views) of the page have changed. Only such changed areas are then redrawn in the browser. It is nearly transparent for we application developer, as long as there is no too complicated JavaScript used in the UI page. If you are interested with this, you could read the comment on method CL_AJAX_UTILITY->SHOULD_RENDER and debug it.


Where is ADT mode configured

Suppose I log on to UI via business role TPM_PRO, which has DEFAULT as the technical profile:


In the SPRO customizing Customer Relationship Management->UI Framework->Technical Role Definition->Define Technical Profile

Here we can enable or disable the ADT:


How to switch off ADT temporarily

Tcode: SU3, select “Parameters” TAB, and add the following user parameter “CRM_TAJAX_DH_MODE” and set it to “OFF”


Make sure you close the browser and open a new one after the change.

How can I permanently switch off my view for ADH

All UI component views which are not supported for ADH are centrally maintained in view BSPWDV_ADH_DSBL via SM31:


My colleague gave me such suggestion: When you find your UI component works abnormally, it could be helpful to run your UI component with ADT switched off, which sometimes can give you some hint.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Arjun Pawar
      Arjun Pawar

      Very good blog and useful, thanks a lot for sharing

      Author's profile photo j singh
      j singh

      Very well explained...thanks!!

      Author's profile photo Uwe Reimitz
      Uwe Reimitz

      Thanks for sharing this valuable information.

      There is another drawback from ADH. When the client shows old content because of issues during rendering on the server the application might not longer react on pressed buttons. This happens if the view hosting the button is not longer active on the server side. At least such situations can be detected by later versions of the UI framework and a full client sync is enforce.