|
Functionality This function module enables you to set values of characteristics of aninstance within a configuration.
- You have to specify the configuration via the CONFIG_ID parameter.
- The instance whose characteristics shall be set is given via the INST_ID
parameter.
- The values which shall be set, are passed via the
VALUES_TO_SETparameter, which expects a table with tuples ofcharacteristics and values. This means multiple characteristics andvalues can be set with one call.
- For the characteristic you should specify the language independent name.
For the value you can choose if the given value is language dependentvia the FORMAT_VALUE of each value set structure you pass. If nothing isspecified at this level the FORMAT_VALUES import parameter of thefunction module, will be taken into account.
- FORMAT_VALUES is set to false by default.
Notes
- If you try to set a value which is not in the domain of the
characteristic, the command will return success, it will set theerroneous value at the characteristic which will lead to a inconsistentconfiguration.
- If you try to set a characteristic which does not exist within the given
instance, the function module would run into a COMMAND_EXCEPTION.
- A characteristic value can be deselected by overwriting it with a empty
string value.
- See also function module CFG_API_DELETE_CSTICS_VALUES, it works similar.
|