Interface for special data treatment within grid management. A grid
item can provide a "databag". A databag is a String, in which certain values
are listed in the format: name1:value1;name2;value2;...
The best way for building the string is to use
ValueManager.encodeComplexValue(java.util.Map),
because this method takes care of handling the characters ":" and ";", if they
occur within the value strings.
The components in the grid now may refer to data of a databag by using the
value "@cc_db:
@". The resolution of this value from the databag is done
on client side.
Example: the databag returns "firstName:Captain;lastName:Casa". The grid item
in this case is built in the following way:
GRIDCOL TEXT="..." SORTREFERENCE="..."
LABEL TEXT="@cc_db:firstName@" ...
GRIDCOL TEXT="..." SORTREFERENCE="..."
LABEL TEXT="@cc_db:lastName@" ...
On server side for each grid item there is only one "get-ing" of the databag,
the distribution of data into the components is done on client side. There is
no individual "get-ing" of data by component as with normal expression assignment
on component level.