The control tree in the Fabasoft app.test Recorder is used for recording statements.
It contains all controls available on the web site displayed in the Fabasoft app.test Client Adaptor.
These are the controls that might be displayed.
The WINDOW element indicates a window displayed in the Fabasoft app.test Client Adaptor. If several windows are opened, they are shown in tabs at the bottom of the Fabasoft app.test Client Adaptor. All opened windows are therefore also displayed in the control tree.
The HEADER element represents the header of a window in the Fabasoft app.test Client Adaptor which usually contains the portals and some buttons.
This element contains all portals that are available within the current Fabasoft Folio client.
The elements within the PORTALS element have the Syntax <portal name>.
Note: The PORTALS element is not shown if no portals are currently available.
The PAGES element contains all pages that are available within the user interface currently shown in the Fabasoft app.test Client Adaptor. Each PAGE contains all controls within the page. This means the PAGE element usually contains a CONTROLS element. Additionally a PAGE might contain a BUTTONBAR or TABS.
A BUTTONBAR contains several BUTTON elements and possibly also a CONTROL element (e.g. the drag-into field of the Fabasoft Folio client) or the BREADCRUMBS element.
Note: Please note that if a button is shown as a BUTTON element in the control tree, this does not mean that the button is enabled.
The syntax of a button within the control tree is BUTTON "<button name>".
The BREADCRUMBS element contains the breadcrumbs displayed above an object list. It contains BUTTON elements which represent the single breadcrumbs. The first button ("Navigation Path" opens a menu which is again displayed in the MENU element at the end of the control tree.
The CONTROLS element contains all available controls within the page.
This can for example be a TREE element, which represents an object tree.
Furthermore, the CONTROLS element can also contain a LIST element that represents an object or compound property list.
The third possibility is that CONTROLS contains one or more CONTROL elements that might represent single controls like an input field or a check box (see chapter “Location Syntax”).
A TREE contains NODE elements that represent the nodes within the tree. A NODE might contain other nodes and the button for opening and closing the node.
A node is represented in the control tree by NODE "<node name">.
A LIST element represents an object or compound property list. A list usually contains the following elements: MENUBAR, BUTTONBAR, COLUMNS and ROWS.
In the control tree the syntax of a list is: LIST "<list name>".
The MENUBAR element contains all menus that might be opened within the object list (a compound property list does not contain a MENUBAR element). Sub elements of the MENUBAR are BUTTON elements that represent the menu items within the menu bar.
If a menu is opened, the items can be found at the end of the control tree in the MENU element.
The COLUMNS element contains all columns that are shown in the list. One single column is represented by a COLUMN element; in other words: a COLUMN element is the header of a column. This element therefore contains all buttons that are available within the column.
The column is shown in the control tree by <column name>.
The ROWS element contains all available rows within the list. This element is empty if no rows are available. Each row within the list is represented within the ROWS element as a single ROW element (<text in the first cell>).
Again, the ROW element contains one or more CELL elements. These CELL elements represent the cells within the row which means there are as many CELL elements within a ROW as COLUMN elements within COLUMNS. A CELL element has the same name as the COLUMN element it belongs to (CELL "<column name>"). The cell itself contains a control that is quite often a READONLY element which means the value can only be read but not changed. Within compound property lists it is possible to change the values within the row. In that case the cell might contain other controls like an input field or a drop-down menu.
Note: If you use the "Preview" view within a Fabasoft Folio object list, no object names are available. In addition, no columns are available which means no cells exist either.
In the "Carousel" view of Fabasoft Folio the names of the objects are available, but no cells are displayed because there are no columns in the "Carousel" view.
The TABS element contains the tabs of a page, e.g. in the work list or in the attribute editor.
A single tab is represented by: <tab name>.
A CONTROL element contains a field within the page. The syntax in the control tree is CONTROL "<control name>". A control might contain other controls or different types of elements. These are described below.
An INPUT element represents an input field for entering a value.
The BUTTON element represents a button. This might be a button in a MENUBAR, in a BUTTONBAR, within a CONTROL or within a COLUMN.
The CHECKBOX element represents a check box. This element contains the values the check box might be set to (as options). Here you can either use the text of the label for setting the check box ("Yes", "No" or "Undefined") or Boolean values ("true" or "false").
The SELECT element represents a drop-down list which might either be an enumeration or an object pointer property. The options of a drop-down list can either be selected by a click or by setting the SELECT element to a value. The drop-down list contains values that might be chosen. Object pointer properties furthermore allow performing a quick search.
The READONLY element represents an entry in a field that can only be read and not edited. This READONLY element might either contain a text or an object pointer. An object pointer allows opening a context menu (and performing a double click if the domain allows it, too).
The RADIO element represents a radio button. The radio button can be selected or cleared. Additionally the selection state of the radio button can be saved in a parameter as a Boolean value.
The FILE element represents the "File" control of the web browser where files can be imported to Fabasoft Folio. In a test you can set this field to the path of a file that should be imported.
The MENU element is shown if a menu is currently opened. Within this menu the menu entries are shown as BUTTON elements that can be selected by clicking them.