data:
myattrname type string,
myunitattrname type string,
myuservalue type string.
myuservalue =
s10getuservalue(
exporting
attrname = myattrname
unitattrname = myunitattrname ).
Parameters
Name
Type
Description
attrname
string
Attribute name
unitattrname
string
Unit or currency
uservalue
string
Value in user format
Description
The s10getuservalue() method is called by the S10 framework whenever the
value of an attribute is displayed to the user. But the method can also be
called directly, for example to insert values in user format in a message text
or a generated document. The type of formatting is the same as for ABAP
"Write", i.e. the user settings regarding decimal and date representation as
well as a possible conversion exit are taken into account. The conversion exit
can generate different outputs for different logon languages, for example, "Pce"
is output for unit of measure "ST" for logon language French and "PC" for logon
language English.
If necessary, a "build" method defined in the ABAP class
for the attribute is called before the value is output.
If the name of the
associated unit or currency attribute is stored in the ABAP class for the
attribute to be displayed, the number of decimal places is selected
appropriately for the output.
Example: ABAP
data:
kwmeng type vbap-kwmeng,
vrkme type vbap-vrkme.
constants:
* assign unit attribute
unit_kwmeng type string value 'vrkme'.
If "vrkme" has the value "ST", i.e. piece, the output of "kwmeng" is without
decimal places.
You can also provide the name of the attribute
containing the unit as a parameter in the method call itself.>The
attribute containing the unit is not always stored in the same database table
as the quantity field. For example, the warehouse stock is stored in table
"MARD" in the field "LABST", but the corresponding warehouse unit of measure is
contained in table "MARA" in the field "MEINS" (base unit of measure).
If you now create a class for the database table "MARD", e.g. "db_mard" or
generate it in the S10 Uitilities, the unit of measure is missing there. To get
a correct output also for this case, you can proceed as follows:
You
include the unit field as another attribute in the "db_mard" class and
implement a "build" method that reads the unit from database table "MARA". The
S10 framework will automatically call the build method of the corresponding
unit of measure before displaying "LABST" whenever the material number has
changed and the display will be correct according to the base unit of measure
of the material:
ABAP
* Class db_mard
data:
matnr type mard-matnr, " Material
werks type mard-werks, " Plant
lgort type mard-lgort, " Storage Location
labst type mard-labst, " Unrestricted
umlme type mard-umlme, " Stock in transfer
insme type mard-insme, " In Quality Insp.
retme type mard-retme. " Returns
meins type mara-meins. " Base unit constants:
* assign unit attribute
unit_labst type string value 'meins',
unit_umlme type string value 'meins',
unit_insme type string value 'meins',
unit_retme type string value 'meins'.
* declare method and dependency
methods:
build_mara_data
importing
matnr type mara-matnr
exporting
meins type mara-meins.
* implement method
method build_mara_data.
select single meins from mara into meins
where matnr = matnr.
endmethod.