Ultra Format Converter(3.3)
- Jenni Wallin
When an Ultra Format Definition is updated, the  system by default automatically updates persistent data when it is accessed, in order to reflect changes. The automatic conversion can either be completely disabled, or enabled only for a selection of formats. It is also possible to set default values for added fields. The access group is permitted to launch and maintain the data in the Ultra Format Converter.
The following list of  applications shows agents able to handle persistent data, and how they handle historic (outdated) UDRs when the automatic conversion is enabled (or the specific format is part of the selection in the Ultra Format Converter).
| Application | Handling |
|---|---|
Database Collection Agent | Collected UDRs are updated. |
Decoder (using MZ Tagged) | Processed UDRs are updated. |
Aggregation Sessions | All UDRs belonging to the same format definition - historic and updated - will be considered valid for comparison. If historic UDRs exist within old sessions, or the session format itself has been updated, the session and its content will be updated the next time it is accessed. |
ECS | UDRs will be updated whenever they are read from ECS by the ECS collection agent or accessed through the ECS Inspector. |
Note!
Attempts to collect, process or update historic UDR data when the automatic conversion for a specific format is disabled causes the workflow to abort (or an exception, when done outside workflow processing).
Conversion Rules
Fields removed from the format definition are deleted and cannot be retrieved. Added fields are by default either set to 0 (zero) (numeric types), false (boolean types), or null (all other types). Changing the type of existing fields may cause the field content to be deleted. For instance, changing from string to int sets the field to 0 (zero), provided that no valid default value is defined.
Only numerical types (int, long, etc) are directly interchangeable. If a numeric value exceeds the number of bytes allowed in the new type, it will be truncated.
Disabling Automatic Conversion
It is possible to disable the automatic conversion to new format versions, and instead define default values for UDR fields added in the new version. This is done from the Ultra Format Converter which is accessed by clicking the Tools button in the upper left part of the   Desktop window, and then selecting Ultra Format Converter from the menu.
| Setting | Description |
|---|---|
Convert | Indicates the UDR types for which the conversion is enabled. There are two options:
|
UDR Types | A list of the formats included as valid for conversion (provided that Selected Only  is the selected Convert option). |
Default Values | Selecting a UDR Type will activate this option. If fields have been added to the format, or the type of an existing field is changed, default values can be defined. The latter case is especially useful since the old field values are reset if the types are not interchangeable. Note! It is not possible to assign values to old, already existing fields (it can be configured, however will have no effect upon update.) |