RadiMation Application Note 132
EUT Information[edit]
RadiMation contains an EUT Window, which includes a tab-screen on which 'EUT information' can be set. This list of information items is a general list of items that affect almost all EUT’s. However some customers do not need certain fields. And other customers always need some additional fields. This list of information items is fixed, and cannot be extended. In some situations, it is imaginable that for a certain EUT extra information fields are included. Some examples of additional information fields that can be needed:
- Motor capacity
- Microcontroller board Firmware
- Website name of product
- Responsible engineer
- Name of account manager
- Market on which the product will be solved
- etc..
It is possible for end-users to specify 'Customizable EUT Information items'. The end-user can add an unlimited number of information items, and for each Information item a 'string' value can be specified.
Each name of an information item should be unique compared to all other names in the information items list.
The list of information items will be represented as a 'list control' with two columns: 'Name' and 'Value'. If a value needs to be changed, the value can be edited in-line. Multi-line values are allowed. If a name needs to be changed, the name can be edited in-line. It is not possible to specify a name that is already available.
Three buttons are available below the list; 'Add', 'Edit' and 'Remove':
- 'Add' will create a new row, and will insert the edit point in the name of the information item
- 'Edit' will set the edit-point in the value of the information item
- 'Delete' will remove the selected information items. A confirmation will be asked!
The 'Edit' and 'Delete' buttons are enabled when only one information item line is selected The 'Delete' button is enabled when multiple information item lines are selected The 'Add' button is always enabled.
Double clicking in the information item name will activate the edit-point in the name field, then the name of the information item can be changed. Single Clicking on the information item value will activate the edit-point in the value field, the value of the information item can then be changed.
Clicking on a column header will sort the contents of the listbox in alphabetic order. If the same column header is clicked again, the sorting will be reversed. The information item list will be alphabeticly sorted on the information item name, when it is first shown.
All Information items can be included in a report. The report generator code is similar to: ||EUT|<INFORMATION ITEM NAME>||. Where the <INFORMATION ITEM NAME> should be the name of the requested information itme. The report generator will check the list of information items as last. This means that other Report generator codes of the EUT file will have a higher priority to be included in the report.
A '|' is not allowed in the information item name to prevent confusion of the report templates. Valid characters in the information item name are: 'a-zA-Z0-9' and the dot '.', dash '-', underscore '_', hash '#' and plus '+'. Spaces are allowed, but not at the begin or the end. Other characters are not allowed in the information item name. All characters are allowed in the value of a information item.
Predefinition of information items[edit]
When a new EUT is created, the list of information items will be pre-filled with a list of information items. This list is generated from information that is configured in the EUTINFO.INI file. The EUTINFO.INI file is included in the configured CONFDVDR directory. Based on the INI-keys that are included in the '[EUTInformation]'-section of the EUTINFO.INI file, the list of information items can be customized.
RadiMation will only read this configuration file during the startup, and it will never write any information to this file.
EUTInformationItems=<ParamName1>;<ParamName2>;<ParamName3>
Each Information item can have a list of values, which can be configured like
EUTInformationItem<NAME>List=<Value1>;<Value2>;<Value3>
The '<NAME>' in this key is a reference to the name of the Information item. As part of the '<NAME>', all characters other than 'A-Za-z0-9' will be removed, also spaces will be removed! If one of the values is "<CUSTOM>" than the end-user is also allowed to specify any other value, not included in the list. If no List is specified for an EUT Information item, then it will assume that only "<CUSTOM>" is specified, and the end-user can specify any value. If only a list of values is specified (without the "<CUSTOM>" part), then the end-user can only select one of the specified values.
A default value can be selected by using:
EUTInformationItem<NAME>Default=<VALUE>
The '<NAME>' in this key is a reference to the name of the Information item. As part of the '<NAME>', all characters other than 'A-Za-z0-9' will be removed, also spaces will be removed! If no <VALUE> is specified or the key is not available, an empty string will be assumed. No cross-checking will happen with the list of allowed values. So it is possible to specify a default value that is not included in the list of values.
An example:
[EUTInformation] EUTInformationItems=Motor Capacity;Number of Doors;Trunk;Gearbox;Length;Chassis Width EUTInformationItemNumberofDoorsList=2;3;4;5 EUTInformationItemNumberOfDoorsDefault=5 EUTInformationItemTrunkList=Yes;No;<CUSTOM> EUTInformationItemGearboxList=Manual;Automatic;<CUSTOM>