EUT Information

From RadiWiki
Revision as of 07:49, 22 February 2006 by Joro (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

RadiMation version 4.4 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. This request should make it possible to have the possibility to add and remove other ‘information’ fields. 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..

The implementation of this wish should make it 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 a information item should be unique compared to all other names in the information items list.

The current tab-window already includes a list of information items. These textboxes can be removed, and should be included in the list of ‘Customizable information items’

Each value of ‘customizable information item’ is a string. No other types are possible like: ‘Date’, ‘value’, ‘boolean’, ‘hyperlink’, etc…

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 will be edited in-line. Multi line values are allowed. If a name needs to be changed, the name will be edited in-line. It is not possible to specify a name that is already available.

Three buttons will be 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. Single Clicking on the information item value will activate the edit-point in the value field. If the file containing the ‘Information item list’ is marked as ‘read-only’, the contents of the information item list are not editable. Also no new information items can be added.

The list box will automatically adjust the separator bar just after the widest ‘Information item name’. The height of each line of the information item list is depending on the height of the value of the information item. All texts that are too long to fit on the width of the value-column, will be auto-wrapped. ‘Hard enters’ will always wrap to the next line. Clicking on the 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>||. 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.

No parent-child relation is possible in the Information item list. A parent-child relation can be ‘simulated’ by using the . as a separator in the information item names. (See the Firefox configuration window)

No value checking will be done on the ‘value’ of a information item. It is however possible that other parts of the software are using the specified values. In this situation, the part that is using a set value should perform the validation of the set value.

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 the ‘EUTInformationItems’ setting that is included in the EUTINFO.INI file. This settings is a ‘;’ separated list of Information item names. All INI-keys described below are included in the “[EUTInformation]”-section in the EUTINFO.INI file. The EUTINFO.INI file is included in the configured CONFDVDR directory. 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>;…. In this key, as part of the <NAME>, all characters other than “A-Za-z0-9” 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 a EUT Information item, then it will assume that only “<CUSTOM>” is specified. A default value can be selected by using: EUTInformationItem<NAME>Default=<VALUE> In this key, as part of the <NAME>, all characters other than “A-Za-z0-9” 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: 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>