Expert attributes

Expert attributes provide additional functions to the Intrexx standard ones. You can find out how to integrate Expert attributes into application elements here.

accesskey

Function: Key combination for jumping to input elements or buttons
Data type: text
Default value: Empty
Possible values: Strings

By using a key combination made from the ALT key and the character entered as the value here, you can jump directly to the current edit element or button. If the value is set to 1, for example, you can use the key combination ALT+1 on Windows systems to jump to the input element or button. The action of the button will be triggered in this case. We recommend that you do not use any browser-specific key combinations - if possible, only use combinations with the digits 0-9. Can be used for the following elements:

• File selection

• Edit field

• Checkbox

• Listbox

• Option field

• Button

• Text area

accordion

Function: Show and hide groupings in the freely designed table
Data type: boolean
Default value: false
Possible values: true, false

Applies to buttons with the "Show/hide" action on view pages that are integrated into a freely designed table. The value ""true"" means that only one grouping can be opened at any time. The previously opened grouping will be closed automatically. Can be used for the following elements:

• Button

additionalcheck

Function: Hides or shows buttons when loading a page depending on a value
Data type: text
Default value: Empty
Possible values: Velocity commands, request parameters

An operator and comparative value can be specified with the attribute as additional attributes (type text, Default value ==). The operator is specified with the attribute ""opadditionalcheck"". Possible operators are ==, !=, <, >, depending on the data type of the comparison value. The comparative value is specified with the attribute ""valueadditionalcheck"". The attribute ""valueintadditionalcheck"" must be specified for comparisons with integer data type, and the attribute ""valuebooleanadditionalcheck"" for boolean values, instead of ""valueadditionalcheck"". The button is only displayed if the return value is 1 (the condition is fulfilled). Example: If "$Loader.getDataCollection().getAttribute('textviewcontrol123456')" is used as the value of the additionalcheck attribute, it is compared with the current value of an input field. The attribute ""opadditionalcheck"" can be left out in this case, because they are being compared for the identical value (default). The desired value, with which the comparison should be made, can be entered in the value of the attribute ""valueadditionalcheck"". As soon as the edit field shows this value, the configured button will be shown. Please note that the name of the element whose current value is being compared must be updated when importing an application, as the names of all elements change unless the "Overwrite existing applications" setting was selected during import. Buttons can continue to be displayed even if the result is false with the text-if-addcheck-false attribute, without the jump to the target page being executed when such a button is clicked. Can be used for the following elements:

• Button

adjust-height

Function: Set the height of the tree element
Data type: Boolean
Default value: true
Possible values: true, false

With the value ""true"", the Tree element will be adjusted to its content, without scroll bars. With the value ""false"", the Tree element will only be as high as has been defined in the Applications module. If the content exceeds this height, scroll bars are displayed. Can be used for the following elements:

• Tree

• Tree view

allowInput

Function: Allows or prevents the direct entry of date and time in the input field
Data type: Boolean
Default value: true
Possible values: true, false

With the value "true", the date or time can be entered directly in an input element with the control type "Date & time, date or time". If the value is "false", the entry must be made using the linked calendar for date selection. Can be used for the following elements:

• Edit field

always-trigger-action

Function: Tree folder action
Data type: Boolean
Default value: false
Possible values: true, false

With always-trigger-action="true", the tree folder action can be triggered with every click, even if the node is already selected. By default, the action is executed only when a new tree node is selected.

• Tree view

appmainbutton

Function: Hiding a button in tooltip and pop-up window
Data type: Boolean
Default value: false
Possible values: true, false

The button is only displayed if the page on which it is located is opened in the main window. It is not displayed when the page is opened in a pop-up window or in the tooltip. Can be used for the following elements:

• Button

auto-pagination

Function: Definition of time interval for automatic scrolling in tables
Data type: integer
Default value: 0
Possible values: Time interval in milliseconds

With this attribute, a time interval can be defined. After the time interval, the table will automatically move to the next available table page. A value of 5000, for example, will therefore go to the next page after 5 seconds, because the value is to be entered in milliseconds. Can be used for the following elements:

• View table

• Free layout table

autoreset

Function: Reset fields linked to the data picker
Data type: boolean
Default value: false
Possible values: true, false

With the value true, the fields linked to the data picker are reset if no entry was found. The attribute must be specified in the Data picker. To do that, select the button in the Applications module, open the details dialog with F4, open the XML tab and adjust the XML. Can be used for the following elements:

• Data Picker

autosubmit

Function: Automatically loads the target page when a hit occurs
Data type: boolean
Default value: false
Possible values: false, true

If a search (e.g. using a dynamic filter that is defined in a view table as a triggering control in a dependency) returns only one data record as a result, the jump to the target page is executed automatically. The onclick event of the button, which has the attribute ""autosubmit"" with the value ""true"", is performed. The attribute can be used in all tables and researches. It is entered in the button which loads the target page. Can be used for the following elements:

• View table

• Free layout table

• Research

backgroundcolor

Function: Set the background color of a grouping dynamically
Data type: text
Default value: Empty
Possible values: hexadecimal color specification

This attribute sets the background color for a grouping to the current value of a control that contains a hexadecimal color specification. In the grouping, the expert attribute ""backgroundcolor"" is specified and the GUID of the control, which contains the color information, is entered as the value. Can be used for the following elements:

• Grouping

backgroundimage

Function: Sets the background image for a grouping to the value of a control
Data type: text
Default value: empty
Possible values: GUID of the control that contains the URL to the image

For this function, a control which points to a shorttext data field, which contains the URL to the picture must be created. The attribute ""hidden"" must have the value ""true"" for this control. The expert attribute ""backgroundimage"" can then be set for the grouping, which must also be created on the same page. The GUID of the control created in step 1 will be entered as the value. Related attribute: ""backgroundcolor"". Please note that the URL will not be adjusted. Relative URLs need to start in the htmlroot folder of the portal. Additional background properties such as ""background-repeat"" or ""background-position"" must be specified in the individual styles of the respective grouping. Can be used for the following elements:

• Grouping

barHeight

Function: Defines the height of the bar chart in the survey portlet
Data type: integer
Default value: 11
Possible values: Height in pixels (integer)

On the Polls portlet page in the Polls application you will find a special control which controls the presentation in the portlet. The bar chart displays the current vote distribution in the portlet. The attribute ""barHeight"" defines the height of the diagram in pixels. Can be used for the following elements:

• Polls portlet

barMaxWidth

Function: Defines the width of the bar chart in the survey portlet
Data type: integer
Default value: 120
Possible values: Width in pixels (integer)

On the page "Surveys Portlet" in survey applications you will find a special control that controls the display in the portlet. The bar chart displays the current vote distribution in the portlet. The attribute ""barMaxWidth"" defines the width of the bar which is displayed for a voting result of 100%. The default value ""120"" means the voting result of 100% has a width of 120 pixels. A result of 50% is therefore shown with a width of 60 pixels. The width of a bar is calculated automatically in relation to a voting result of 100%. Can be used for the following elements:

• Polls portlet

bIgnoreSingleResult

Function: Datapicker - Automatic display for a single result
Data type: boolean
Default value: false
Possible values: true, false

If the data picker only finds one result, this is selected automatically. If you set bIgnoreSingleResult to true, this behavior is prevented. Can be used for the following elements:

• Data Picker

buttonIntrexxSmilies

Function: Display of smiley symbols in the HTML editor Data type: boolean
Default value: true
Possible values: true, false

If the "Editor mode" setting is selected on the Options tab in the properties dialog, the element is displayed in the browser as an HTML editor with formatting options. Using the symbol bar, HTML text smileys can be inserted. If this is not desired, the smiley symbol in the toolbar of the HTML editor can be hidden by setting the value to false. Can be used for the following elements:

• Text area

checklinewrap

Function: Suppress line break in view fields
Data type: boolean
Default value: false
Possible values: true, false

If the value is true, no line break is permitted (<nobr> tag). With a value of ""false"", ""checklinewrap"" is dependent on the browser's behavior. This setting can be set via the properties dialog ("Options" tab) with the Line break option. If the setting is selected, the value of the attribute is also automatically set to true. Can be used for the following elements:

• View field

checkuri

Function: Specification of the protocol in URL view elements
Data type: boolean
Default value: true
Possible values: true, false

Checks whether the protocol (e.g. HTTP) was specified in the data field whose value is displayed in the URL view element. If this is not the case, the protocol specification is inserted before the text if the text does not begin with "javascript:". If you want to suppress this behavior, set the checkuri attribute to false. Can be used for the following elements:

• View field

choosereferencefields

Function: Search in reference fields
Data type: boolean
Default value: false
Possible values: true, false

This expert attribute allows you to research in reference fields. If it has the value true, reference fields can be selected for the search in the search function. Can be used for the following elements:

• Research

choosesystemfields

Function: Enables searches in system fields
Data type: boolean
Default value: false
Possible values: true, false

If this attribute is used for the Search view element, system fields for searches are also listed in the data field selection lists. In Intrexx CRM, the attribute can also be applied to the XUnits "Search by customer" and Search by contact person. Can be used for the following elements:

• Customer search (Customer management)

• Research

• Contact person search (Customer management)

closebychange

Function: Closes the pop-up window after editing a data record
Data type: boolean
Default value: true
Possible values: true, false

If a popup is opened with a button and the value of the attribute is true, all buttons in the newly opened popup whose action causes changes in the database (save, delete) close the popup again after the action has been executed. The attribute can be used for the XUnits of the calendar views Day, Week and Month on the Calendar page in the Calendar application. If you click on an appointment in the calendar, the view page of the appointment, via which the input page for editing can be accessed, opens in a pop-up window. If the value of the attribute is true, the pop-up window is closed when the appointment is saved or deleted. If the value is false, the corresponding calendar view is loaded in the pop-up window after saving or deleting. The attribute can also be used for the XUnit ""upResourceVerticalControl"" on the Diagram page in the Resource applications. If you click on a reservation in the diagram, the view page of the reservation, via which the input page can be accessed for editing, opens in a pop-up window. If the value of the attribute is true, the pop-up window is closed when the reservation is saved or deleted. If the value is false, the diagram is loaded in the pop-up window after saving or deleting the reservation. Can be used for the following elements:

• Calendar plugin

• Resource diagram - upResourceVerticalControl

closeOnSelect

Function: Close calendar for date selection after selecting the date
Data type: boolean
Default value: true
Possible values: true, false

Closes the calendar associated with an input field(control type "Date") for date selection after the date has been selected if the value is "true". If the value is "false", the calendar remains open for date selection. Can be used for the following elements:

• Edit field

compareText

Function: Compares with the text of a selection list entry
Data type: boolean
Default value: false
Possible values: true, false

The attribute ""compareText"" is implemented in combination with the attribute ""customdefault"". If the value is false (default), it is compared with the value of a selection list entry. If you want to compare with the text of a selection list entry, compareText must be set to true. Can be used for the following elements:

• Drop-down list

• Listbox

confirm

Function: Suppress the query "Do you really want to delete the data record?"
Data type: boolean
Default value: true
Possible values: true, false

If the value of the attribute is set to false, the query "Do you really want to delete the data record?" is suppressed for buttons with the "Delete" action. Can be used for the following elements:

• Button

cookie

Function: Saves the last setting for the "Show / Hide" button action
Data type: boolean
Default value: false
Possible values: true, false

The last setting of the user is saved as a cookie. If the grouping was displayed when you left the page, for example, it will also be displayed when you reload the page. This setting can be accessed in the properties dialog ("Actions" tab) of a button. If the option "Save last setting in cookie" is selected, the cookie attribute is automatically set to true. Can be used for the following elements:

• Button

css-file

Function: Inclusion of a CSS file (VTL Include and freely designed table)
Data type: text
Default value: Empty
Possible values: Path and name of the CSS file

Own style sheets can be integrated using the attribute ""css-file"". If it is applied to the VTL Include view element, a CSS file can be included in the _head.vm. Multiple CSS files can be integrated by adding the attribute multiple times but in each case with a consecutive number (css-file1, css-file2 ...). The name of the CSS file is to be entered as the attribute's value. If the file is not located directly in the portal directory external/htmlroot/css/, the path from the css directory must also be specified. For example, if the file is located in the portal directory external/htmlroot/css/test/test.css, the name of the attribute is css-file1 and the value is "test/test.css". To design a free layout table, an individual CSS file can be implemented which must be located in the portal directory external/htmlroot/css/custom. As a template, the file external/htmlroot/css/shapedtable.css should be copied. The relevant style classes are then created and can be used as required. Even and odd rows must be designed using the attributes ""evenrowclass"" and ""oddrowclass"". Both of these attributes must be applied in combination. Please note that CSS file(s) included with the css-file attribute are not automatically adopted when exporting or importing an application! Can be used for the following elements:

• Free layout table

• VTL Include

cumulate

Function: Summation in the diagram
Data type: boolean
Default value: true
Possible values: true, false

Adds up values for an existing category and row. Can be used for the following elements:

• Chart

customdefault

Function: Sets a default value when creating new data records
Data type: text
Default value: Empty
Possible values: Velocity, request parameter

The value of a request parameter can be read by entering ""$Request.get('rq_MyParam')"" as the value of the attribute. When creating a new data record, this value is displayed as an editable default in the input element. The attribute has no effect on already saved data record. In order to overwrite the values of existing data records, an additional expert attribute needs to be defined: customdefaultOverwrite = true. For selection lists, list boxes and multiple selection, the default entry can be defined dynamically with customdefault. If the text is to be compared instead of the value (default setting), the additional attribute compareText with value true, type boolean must be used. If a selection list, list box or multiple selection is used for resource lists such as company vehicles or rooms, the ID of the resource can be used with the value $!Request.get('rq_GroupId') to preselect the resource in the list that is marked in the resource diagram. Please note that names of elements that are used in the value of the customdefault attribute must be updated when importing the application. If the "Overwrite existing applications" setting is not selected during import, the names of the elements in the new application will change. Can be used for the following elements:

• Drop-down list

• Edit field

• Listbox

• Resource diagram - upResourceVerticalControl

• Multiple selection

customdefaultcondition

Function: Condition for values in the expert attribute customdefault
Data type: text
Default value: Empty
Possible values: Condition

Defines a condition for the expert attribute ""customdefault"". If this is not fulfilled, the value in customdefault is not set (e.g. $Request.containsKey('rq_Test'))

customdefaultiso

Function: Write values from calendar control to input fields
Data type: text
Default value: Empty
Possible values: see Description

With this expert attribute, the start and end time of an appointment, which is highlighted in a calendar or resource element, can be transferred to edit elements with the type date. For this, both of the request parameters ""rq_DateFrom"" (appointment start) and ""rq_DateTo"" (appointment end) will need to be used for the attribute's value:

$!Request.get('rq_DateFrom') $!Request.get('rq_DateTo')

customdefaulttype

Function:Defines the view of the calendar in the dynamic filter
Data type: text
Default value: month
Possible values: month, year

In a calendar dynamic filter, the calendar will be loaded in the year view when ""year"" is entered as the attribute's value. Can be used for the following elements:

• Dynamic filter

customdefaultvalidateisodateparam

Function: Transfer of ISO date values via request parameter
Data type: text
Default value: Empty
Possible values: Name of the request parameter

If a request value (e.g. rq_myDate) with a date in ISO format is transferred when jumping to an input page, an input field can be filled automatically by setting the Expert attribute customdefaultvalidateisodateparam. The name of the request parameter is specified as the value (e.g. ""rq_myDate""). The date must be transferred in the ISO format (e.g. ""2005-12-25 00:00:00""). Any number of milliseconds can be added to or subtracted from this date: For example, rq_myDate||1800000 would add 1800000 milliseconds or 30 minutes to the date provided by the request parameter rq_myDate.

rq_myDate||-1800000

In this case, 1800000 milliseconds, or 30 minutes, would be subtracted from the date delivered by the request parameter ""rq_myDate"". Can be used for the following elements:

• Edit field

customdescription

Function: Displays the text from the title of a button of type Image on MouseOver
Data type: boolean
Default value: false
Possible values: true, false

Buttons can be shown as images in Intrexx. This presentation is defined by selecting the option ""Image"" in the button's properties dialog. When the mouse moves over a button with this configuration in the browser, a tooltip will be shown. If the value is false (default), the action set for the button is displayed in the tooltip (can be set in the properties dialog, Actions tab). If customdescription is set to true, the title of the button is displayed in the tooltip instead. If the title is stored in multiple languages, the title is displayed in the respective language in the tooltip when the portal language is switched. Can be used for the following elements:

• Button

customdescription-text

Function: Value is displayed as a tooltip for buttons
Data type: text
Default value: Empty
Possible values: Character string

The attribute's value is shown as a tooltip for the button. Can be used for the following elements:

• Button

defaultFilterFrom

Function: Adjustment of the start date in the statistics application on the "Overview" page
Data type: text
Default value: Empty
Possible values: see Description

If no value is set, all data is displayed. The start date can be adjusted based on the pattern Year, Month, Day, Hour, Minute. If, for example, all data from today minus one month and start time 00:00:00 are to be output, the value should be specified as:

defaultFilterFrom ,-1,,0,0,0
defaultFilterFromType=2

The attribute is always used together with the attribute defaultFilterFromType=2. Can be used for the following elements:

• Statistic - upStatisticsAppControl

defaultFilterTo

Function: Adjustment of the end date in the statistics application on the "Overview" page
Data type: text
Default value: Empty
Possible values: see Description

If no value is set, all data is displayed. The start date can be adjusted based on the pattern Year, Month, Day, Hour, Minute. If, for example, all data up to today minus one month and start time 00:00:00 are to be output, the value should be specified as:

defaultFilterFrom ,-1,,0,0,0
defaultFilterFromType=2

The attribute is always used together with the attribute defaultFilterFromType=2. Can be used for the following elements:

• Statistic - upStatisticsAppControl

defaultImageHeight

Function: Set the height of the image
Data type: integer
Default value: Empty
Possible values: Integer

For image buttons with the option ""Image from data field"", the height can be defined by using ""defaultImageHeight"". Can be used for the following elements:

• Button

defaultImageWidth

Function: Set the width of the image
Data type: integer
Default value: Empty
Possible values: Integer

For image buttons with the option ""Image from data field"", the width can be defined by using ""defaultImageWidth"". Can be used for the following elements:

• Button

disabled

Function: Focus for read-only controls
Data type: boolean
Default value: false
Possible values: true, false

Setting the focus for write-protected controls can be prevented, when the attribute ""disabled"" has a value of ""true"". Can be used for the following elements:

• View field

• Drop-down list

• Edit field

• Text area

disposition-type

Function: Display of files
Data type: text
Default value: inline
Possible values: inline, attachment

With this attribute, the view type for FileWalker files can be controlled. With the value ""inline"", the content of the selected file will be shown in the browser. With the value ""attachment"", clicking on the file link will open the browser dialog for saving or opening a file. Can be used for the following elements:

• Filewalker

drag-and-drop

Function: Disable drag & drop in the tree control
Data type: boolean
Default value: true
Possible values: true, false

The value false deactivates drag & drop in the current tree control. Can be used for the following elements:

• Tree view

dynamic

Function: Dynamic width of view fields in a grouping
Data type: boolean
Default value: false
Possible values: true, false

If several view fields are grouped, dynamic = true can be used to ensure that they are displayed one after the other, regardless of the length of the content. The columns are written without width. Can be used for the following elements:

• Grouping

dynamic-param_xxx

Function: Access to data of the current data record in a freely designed table
Data type: text
Default value: Empty
Possible values: GUID of an element

The expert attribute must be defined for the button on the page which is used in the free layout table. The appendix ""xxx"" in the attribute ""dynamic-param_xxx"" stands for the name of the JavaScript variables which are used to read the value later. As the value of the attribute, the GUID of an element on the page used in the free layout table is entered. In the ""onClick"" event of the button, the JavaScript variable ""xxx"" can be used to retrieve the value of the field. The value can then be transferred as a request parameter when jumping to a page. Insert a new expert attribute to do that:

Name: rq_myParam
Value: " + xxx + "
Type: Text

Please take note of the use of quotation marks and plus symbols in value. Can be used for the following elements:

• Free layout table

• Button

empty-string

Function: Change output *empty* if value is missing in view tables
Data type: text
Default value: Empty
Possible values: any character string

In view tables, any field or column can be defined as a link (text buttons) with a jump to the target page. If the underlying data field does not contain a value and the setting "Show *empty* if value is missing" is set in the properties dialog of the column (Options tab), the character string *empty* is displayed in the respective table cell. This string can be edited with ""empty-string"". Enter the text you would like to have as the attribute's value. Can be used for the following elements:

• View table

emptyfilter

Function: Display table unfiltered when filter is empty
Data type: text
Default value: Empty
Possible values: all

If a dependency is defined for a table and the setting "Do not display element initially" is selected, the table is not displayed either when the page is loaded or when the filter is reset (empty filter). The attribute ""emptyfilter"" with the value ""all"" has the effect that the table will be shown without filters in the case of an empty filter. The setting "Do not display element initially" must be set. Can be used for the following elements:

• View table

• Free layout table

encode-title

Function: Switch HTML encoding of the folder title on or off
Data type: boolean
Default value: true
Possible values: true, false

Switch on/off HTML encoding of the folder title. Can be used for the following elements:

• Tree view

encode-vtl

Function: Velocity in the title of a button
Data type: boolean
Default value: true
Possible values: false, true

With this attribute, velocity snippets can be used in the title of a button (e.g. number of articles: ${articleCount}).

encode-vtl=false

Velocity code is performed

encode-vtl=true

Velocity code is not performed

Can be used for the following elements:

• Button

evenrowclass

Function: Sets the CSS class for even rows in the free-form table
Data type: text
Default value: Empty
Possible values: Name of the CSS class

The desired CSS class must be included in the CSS file defined in the attribute ""css-file"". The class name is entered in the value of the attribute ""evenrowclass"" (e.g. SCUP_ShapTab_RowEven_normal_BG). The attributes ""evenrowclass"" and ""oddrowclass"" are logically only implemented for one data record per row. A different table structure is written for a setting of multiple records per table row. This can be activated in the properties dialog on the ""Options"" tab. Can be used for the following elements:

• Free layout table

eventselector

Function: Open appointment tooltip on mouse contact with the surrounding container in the diagram
Data type:
Default value:
Possible values:

In calendar and resource diagrams, a tooltip with additional information about the appointment is shown when the mouse moves of the appointment's title. The attribute with the value ""all"" means that this tooltip is opened when the mouse moves over the container surrounding the appointment. Can be used for the following elements:

• Calendar plugin

• Resource diagram - upResourceVerticalControl

filename

Function: Also displays the file name for the file selection element
Data type: boolean
Default value: true
Possible values: true, false

If the value is true, the file name is displayed in addition to the file type icon. If the value is false, only the icon is displayed. The attribute can be applied to both the file selection and the file selection view elements. Note: Can be set directly in the dialog as of Intrexx 7.0, the attribute is no longer supported after that. Can be used for the following elements:

• File selection

• File selection view

flipflop-all-control

Function: Simultaneously show or hide all groupings
Data type: text
Default value: Empty
Possible values: see Description

A button can be configured in such a way that it opens/closes all of the groupings listed in a free layout table. If the view page that is listed in the table contains groupings that are controlled by a button with the action "Show/hide", the simultaneous closing and opening via the freely designed table can be effected with the settings described below. First create the button with the "Show/hide" action on the view page and select the desired grouping on the Actions tab in the properties dialog. Enter the view page in the properties dialog of the free layout table. On the page, which contains the free layout table, create a button without an action but with a link to the same page. For the attribute's function to work correctly, the button must be positioned directly above the free layout table. Please do not position it to the side of or underneath the table. For this button, enter the attribute ""flipflop-all-control"". The name of the button on the view page is entered as the value. Additionally, the attribute ""flipflop-all-table"" must be inserted. The value here is the name of the free layout table. Please make sure that you use the name specified as the attribute ""name"" on the ""Expert"" tab. In this case, do not use the name which can be found on the Details dialog by pressing F4. Finally, add the attribute ""flipflop-all"" (value ""true"") to the button on the view page. After saving the application, clicking on the button above the free layout table in the browser will open or close, respectively, all of the groupings contained in the table at the same time. Can be used for the following elements:

• Button

getQuery

Function: Output of the SQL query of a table
Data type: boolean
Default value: false
Possible values: true, false

If this attribute is set to true, the SQL query of a table is output above the table. Can be used for the following elements:

• View table

• Free layout table

height

Function: Defines the absolute or relative height of pages and groupings
Data type: text
Default value: Empty
Possible values: see Description

The height of a page in a popup window can be defined with this attribute. Enter this attribute in the page's properties dialog (""Expert"" tab). Absolute entries are entered as an integer, relative entries in the form of a percentage (e.g. ""50%""). If an element on the page has the dynamic-height attribute with the value true, the height attribute has no effect. The height of groupings can also be defined with the attribute ""height"". Can be used for the following elements:

• Grouping

• Page

hiddenfield

Function: The value of an element is written to another, hidden element
Data type: text
Default value: Empty
Possible values: Name of the hidden element

If a value is to be stored in a form field with a specific name so that it can then be queried under this name in the request, the hiddenfield attribute can be used. The name of the hidden form field does not change when the application is imported. Add the attribute to the element which provides the value and is shown in the browser. The data record must already be available; the attribute cannot be used for new data records. Can be used for the following elements:

• View field

• Edit field

history-entry

Function: Page request in the history (back button)
Data type: boolean
Default value: true
Possible values: true, false

In the Ajax layout, every page request is written to the history so that the back button works. If this should not happen (redirect pages), this expert attribute can be set to false in the action control. Can be used for the following elements:

• Button

hourIncrement

Function: Set steps for the hour selection in the calendar for date selection
Data type: integer
Default value: 1
Possible values: Integer

In the calendar for date selection linked to an input field(time control type), the hours can be increased or decreased with a click. With this expert attribute, you can define how large the steps are for the increase and decrease. Can be used for the following elements:

• Edit field

icon

Function: Displays an icon for the file type
Data type: boolean
Default value: true
Possible values: true, false

The icon of the file type can be hidden with the value ""false"". Please note: Can be set directly in the dialog as of Intrexx 7.0, the flag is no longer supported after this version Can be used for the following elements:

• File selection (view)

include-application-script

Function: Include the application.js file
Data type: boolean
Default value: true
Possible values: true, false

On application pages - if there are user-defined scripts in the application - the application.js is always included if the value of the attribute is true. If the application page is in a portlet/iFavorites or similar. the application.js is only included if an event with script is defined on exactly this page. This behavior can be overruled with the include-application-script attribute. For include-application-script=false, the potentially available application.js is not included. This value should only be set if there is no script on this page that uses application.js functions. Can be used for the following elements:

• Page

inline

Function: Display of the calendar for inline date selection
Data type: boolean
Default value: true
Possible values: true, false

With the value "true", the calendar linked to an input field with the control type Date & time, Date or Time is displayed inline for date selection. Can be used for the following elements:

• Edit field

jsobject

Function: Access to values of columns and rows in tables
Data type: boolean
Default value: false
Possible values: true, false

If the attribute is used for a view table or freely designed table, an UpTable object is automatically created. The UpTable object can be accessed using the global object oTableReg. Besides properties like ID and GUID of the table, it contains a list of RecIds of the records displayed on the browser page and a list of the table columns. A column object contains properties such as ID, GUID, displayName and controlType and offers methods for accessing nodes (<a> or <span> tags) or directly to the content of the text nodes. An example for accessing the object oTableReg:

oTableReg.getTableByGuid(Table GUID).getColByGuid(Column GUID).getNodeValue(recid)

For a free layout table, the RecordID of the data record is transferred, for view tables the VelocityCounter. This method provides the value from the column for the transferred column:

oTableReg.getTableByGuid(Table GUID).aRecIds

Here, an array of the RecordIDs from the page is formed(new array(1,2,5)). Additional methods are included in the file object.js. The GUID must be determined using the properties dialog (Expert tab) for free layout tables. Please do not use the GUID from the Details dialog by pressing F4. For view elements, the attribute establishes a bidirectional relationship between the HTML object of the element and the corresponding UP object to be used in JavaScript. For edit elements, the bidirectional relationship the standard method. Thus, for example, calculations can be performed with the value of a date view field, but the control-specific formatting will be taken into account. The value of the view controls can be queried using the function getElement(GUID).oUp.displayValue. For the view element ""View checkbox"", the value can be queried using the function getElement(GUID).oUp.checked. The returned value is either true or false. Please note that the names and GUIDs are changed when an application is imported. if the application is not imported with the Overwrite existing applications option, the element names and GUIDs used must then be replaced. Can be used for the following elements:

• View field

• View table

• Free layout table

• View checkbox

link-alignwith

Function: Aligning the datapicker results list with controls
Data type: text
Default value: Empty
Possible values: GUID of the control for aligning the results list

The Data picker result list will align itself to the element whose GUID is entered as the value here. If no GUID is specified, the list is aligned with the input field of the data picker. Can be used for the following elements:

• Button

link-pollExecution

Function: Display of an alternative input page for voting in the survey portlet
Data type: text
Default value: GUID of the input page Response
Possible values: GUID of an alternative input page

The attribute is applied to the special element on the "Survey portlet" page in survey applications. By default, the "Answer" input page is loaded when a vote is cast. An alternative edit page can be loaded by entering its GUID as the value of this attribute. Can be used for the following elements:

• Polls portlet

link-pollNew

Function: Jump to an alternative input page for new surveys (survey portlet)
Data type: text Default value: GUID of the "Survey new" input page
Possible values: GUID of an alternative input page

By default, clicking on the "Create new survey" button in the survey portlet loads the "New survey" input page. An alternative edit page can be loaded by entering its GUID as the value of this attribute. The "Create new poll" button is only displayed if the showPollButtonNew attribute has the value true (see. Attribute showPollButtonNew). Can be used for the following elements:

• Polls portlet

link-pollResult

Function: Display an alternative view page for the survey result in the survey portlet
Data type: text
Default value: GUID of the view page Survey result
Possible values: GUID of an alternative view page

The attribute is applied to the special element on the "Survey portlet" page in survey applications. By default, the "Survey result" view page is loaded to display the survey result. An alternative view page can be loaded by entering its GUID as the value of this attribute. Can be used for the following elements:

• Polls portlet

link-staPagesTarget

Function: Integration of an alternative view page for page accesses in the Statistics application
Data type: text
Default value: GUID of the application statistics page
Possible values: GUID of an alternative page

By default, the "Application statistics" view page is displayed when you click on an application in the overview list of the statistics application. The individual page accesses are listed on this page. Using a filter, you can specify the start and end date of the period to be analyzed. Alternatively, by specifying the GUID in the value of the attribute, the page "Application statistics without filter" can be used, which does not offer any filter options and only displays the list of page accesses. Can be used for the following elements:

• Statistic - upStatisticsAppControl

link-tooltip-content

Function: Display the content of a view table column as a tooltip in another column
Data type: text
Default value: Empty
Possible values: GUID of the hidden column

The content of a table column can be displayed in another column as a tooltip when the user moves the mouse over one of its entries. The tooltip content is in its own column (in its own data field) which can be managed using an edit page as usual. Add this data field to the list of selected columns (properties dialog). Then select the column where the content of the tooltip column should be shown as a tooltip. Click on the "Format" button and then on the Expert tab. Enter the new attribute ""link-tooltip-content"" here. The GUID of the column which provides the tooltip's content is entered as the value. If desired, the column with the tooltip content can be hidden using the hidden attribute (value: true, type:boolean). Can be used for the following elements:

• View table

mail-checkimage

Function: Use of checkbox symbols when sending e-mails
Data type: boolean
Default value: false
Possible values: true, false

Checkboxes are usually displayed as text in HTML formatted emails. This avoids having to attach two images to each email which some mail clients display in a separate area. If this is desired, the mail-checkimage attribute can be set to true for the view page that is used for sending e-mails. The images from the first checkbox, which uses images, are attached. In the HTML, all checkboxes, which use images, will refer to this checkbox. Can be used for the following elements:

• Page

mailpagesize

Function: Defines the number of data records on a page that is sent by e-mail
Data type: integer
Default value: Empty
Possible values: -1, Number of data records

If the value is -1, all data records are displayed. If no value is set, the same number of data records is emailed as is currently displayed in the browser. Can be used for the following elements:

• View table

maxBarWidth

Function: Defines the width of a bar in the statistics overview
Data type: integer
Default value: Empty
Possible values: Integer values for the bar width in pixels

In the statistics overview, accesses on the "Overview" and "Application statistics" page are displayed in the form of a bar chart. The value of this attribute determines the width of a bar in pixels for a result of 100%. The width of a bar is automatically calculated from this for diverging results. Can be used for the following elements:

• Statistic - upStatisticsAppControl; Statistic - upStatisticsGlobalControl

maxEntries

Function: Defines the maximum number of statistics entries in the Statistics system application
Data type: integer
Default value: -1
Possible values: Integer values for the number of statistics entries

The number of results displayed on the "Overview" and "Application statistics" pages can be limited to the number entered in the value using this attribute. If no value or the value -1 is specified, all entries are displayed. Can be used for the following elements:

• Statistic - upStatisticsAppControl; Statistic - upStatisticsGlobalControl

maxheight

Function: Maximum height of the datapicker results list
Data type: integer
Default value: 0
Possible values: Integers (for the maximum height in pixels)

If the maximum height of a datapicker results list is exceeded, a scroll bar is displayed. If no valid number is specified or the expert attribute is not available (default), the list adapts to the results displayed. Can be used for the following elements:

• Button

maxtext

Function: Character limitation in long text fields in view tables
Data type: integer
Default value: 20
Possible values: Integers

If the value is -1, the text of the long text fields that are included in view table columns is displayed in full. By default, the first 20 characters are shown. The setting can be set via the properties dialog ("Options" tab) of view tables via the "Maximum text length (column width)" option. The value entered here is automatically entered as the value for the attribute ""maxtext"". Can be used for the following elements:

• View table

maxtextHeadline

Function: Character limit for the appointment heading in calendar views
Data type: integer
Default value: Empty
Possible values: Integers

If no value is specified or the value is -1, the text is displayed in full. This attribute cannot be used to restrict the number of characters in the heading of a tooltip. Can be used for the following elements:

• Calendar plugin

minuteIncrement

Function: Set steps for the minute selection in the calendar for date selection
Data type: integer
Default value: 1
Possible values: Integer

In the calendar for date selection linked to an input field(time control type), the minutes can be increased or decreased with a click. With this expert attribute, you can define how large the steps are for the increase and decrease. Can be used for the following elements:

• Edit field

oddrowclass

Function: Sets the CSS class for odd rows in the free-form table
Data type: text
Default value: Empty
Possible values: Name of the CSS class

The attribute can only be used in combination with the attribute ""evenrowclass"". The class name is entered in the value of the attribute ""evenrowclass"" (e.g. SCUP_ShapTab_RowEven_normal_BG). The class name is specified in the value of the oddrowclass attribute (see Description of the css-file attribute). A different table structure is written for a setting of multiple records per table row. This can be activated in the properties dialog on the ""Options"" tab. Can be used for the following elements:

• Free layout table

offsetX

Function: Horizontal offset of the datapicker results list
Data type: integer
Default value: 0
Possible values: Integer values

Defines the horizontal offset of the Data picker result list. Can be used for the following elements:

• Button

offsetY

Function: Vertical offset of the datapicker results list
Data type: integer
Default value: 0
Possible values: Integer values

Defines the vertical offset of the Data picker result list. Can be used for the following elements:

• Button

on-text

Function: Text of the ON/OFF state for checkboxes in iPhone style
Data type: text
Default value: Empty
Possible values: Character string

If a checkbox is displayed in iPhone style (toggle), the text of the ON state can be determined via this Expert attribute. The text for the OFF status is determined using the attribute ""off-text"". This does not apply to the iPhone because iPhone implementation is performed purely with trim CSSs.

• Checkbox

onload

Function: Calls script when loading tables
Data type: text
Default value: Empty
Possible values: Script call

The script entered as the value for this attribute (""MyScript()"") is performed every time the user sorts the table, navigates to the next page of records, changes the preselection etc. The attribute can, for example, be implemented for calculating sum totals via a script. If there are several preselections, the attribute must be entered for the top preselection, i.e. the level that is displayed when the page is loaded. Can be used for the following elements:

• View table

• Research

open-by-html

Function: Display of files or images in popups without fixed window size
Data type: boolean
Default value: false
Possible values: true, false

The File and Image controls are only rendered using HTML. A JavaScript object is not established. A window is opened with "target=_blank". The attribute only has an effect if the attribute open-popup=true is set at the same time (see General tab in the properties dialog of the element - "Open in new window" property). Can be used for the following elements:

• File selection view

open-popup

Function: Opens a pop-up window when a file is opened
Data type: boolean
Default value: true
Possible values: true, false

If the value is true and a browser plugin is used for the mimetype, the file is loaded in the open popup. If a browser without a plugin is used, the file is opened in another window; the pop-up window remains open without content. If the value is false and a browser plugin is used for the mimetype, the file is opened in the current window. If a browser without a plugin is used, the file is opened in another window. Can be used for the following elements:

• File selection view

• Filewalker

optionlink

Function: Defines the display of the options link for setting the calendar views
Data type: integer
Default value: 1
Possible values: 0, 1, 2

Via the link ""Options"" in calendar applications, settings for displaying the calendar views Day, Week and Month can be adjusted. The following values for the attribute ""optionlink"", show/hide the link based on permissions:

• optionlink = 2 --> the link is only visible to administrators of the application

• optionlink = 1 --> the link is visible to all users except the anonymous user

• optionlink = 0 --> the link is visible for all users and the anonymous user

Can be used for the following elements:

• Calendar>

optionMaxLength

Function: Limits the number of characters in an answer in the survey application
Data type: integer
Default value: 30
Possible values: Integer values (number of characters)

If the number of characters in the response is longer than the value specified here, the remainder is truncated and replaced by .... If no value is specified or the value is -1, the answer is displayed in full. Can be used for the following elements:

• Polls portlet

overflow

Function: Defines the height and width of a grouping
Data type: text
Default value: Empty
Possible values: auto, hidden

If the value is auto, the height and width of the grouping defined in the application designer is retained. Scrollbars are displayed for longer content. With the aid of this attribute, the text area view element can, for example, be included in a grouping. If the content of the text field exceeds the height or width of the grouping, scrollbars are displayed. The value ""hidden"" means that too large content will be cut off without displaying scrollbars. Can be used for the following elements:

• Grouping

pattern

Function: Restricts the input to permitted characters
Data type: text
Default value: Empty
Possible values: see Description

A regular expression can be entered as the value. This defines which values may be contained in the edit element. On exiting the element, the input is checked against the regular expression. Example: ^[a-f0-9]{6}With this specification in the value of the attribute, all letters from a-f (A-F) and numbers from 0-9 are permitted. The entry must contain at least 6 characters. The check for the letters is not case-sensitive. Can be used for the following elements:

• Edit field

• Text area

permalink

Function: Copies the link of a button with the type "Button" to the clipboard. The function is not available for the "Text" and "Image" button types.
Data type: boolean
Default value: false
Possible values: true, false

Generates a permalink from a button's link destination. Depending on the browser (and the browser settings), the permalink will be copied to the clipboard. If this is not possible, the permalink is displayed in a text area within the tooltip at the bottom right of the screen. The user can then copy it from here. In Mozilla Firefox, a permission must be defined for copying the text to the clipboard. The following steps need to be performed onetime to define the permission:

1. Enter ""about:config"" as the URL in the browser

2. Search for the entry signed.applets.codebase_principal_support

3. Double-clicking on the row changes the value to ""true""

4. Then close the window

Can be used for the following elements:

• Button

presentationtitle

Function: Show or hide the title bar of the datapicker results list
Data type: boolean
Default value: true
Possible values: true, false

If several results are returned by a button with the Datapicker action, the heading (field name) of the results table can be hidden with the value false. Can be used for the following elements:

• Button

precision

Function: Display of labels and lines when using values with more than two decimal places on the value axis.
Data type: integer
Default value: Number of decimal places
Possible values: Integer

The attribute works only for all lines and vertical bar combinations or bar charts. Can be used for the following elements:

• Chart

popupbutton

Function: A button is only displayed if it is in a pop-up window
Data type: boolean
Default value: false
Possible values: true, false

If the page containing the button is opened in the main window, the button is not displayed. Can be used for the following elements:

• Button

qualifiedUrl

Function: Specifies an alternative directory for buttons on pages that are sent by e-mail.
Data type: text
Default value: Empty
Possible values: fully-qualified path to the portal

If a button that links to the server is located on a page that is sent by e-mail, this attribute can be used to specify whether the standard server path or an alternative directory is used for the link. In the Application Designer, every button on a page sent via email can be used with the attribute ""qualifiedName"".

Example:

https://myServer/myVirtualDirectory/
or (tomcat): https://myServer/myVirtualDirectory/

Can be used for the following elements:

• Button

questionMaxLength

Function: Limits the number of characters in the survey text
Data type: integer
Default value: 80
Possible values: Integer values (number of characters)

If the number of characters of the survey text in the survey portlet (survey applications) is greater than the value specified here, the remainder is truncated and replaced by .... If no value or the value -1 is specified, the complete text is displayed.

• Polls portlet

rawvalue

Function: Unformatted display of the values of data fields of a system data group
Data type: boolean
Default value: false
Possible values: true, false

View fields linked to fields from a system data group will show their values without formatting - as they are saved in the database. Can be used for the following elements:

• View field

• View table

• Text area

reloadbychange

Function: Loads calendar views or resource diagram after changing a data record
Data type:
Default value:
Possible values:

If a button with the value true opens a pop-up window, all buttons that are contained in the newly opened pop-up and cause changes in the database (save, delete) reload the original window after the action has been executed. Depending on the application, the calendar views day, week or months or the resource diagram are reloaded (see closebychange)."; "boolean"; "false"; "true, false"; "all versions" Can be used for the following elements:

• Calendar plugin

• Resource diagram - upResourceVerticalControl

reloadparentanyway

Function: Loading the table or the entire page
Data type: boolean
Default value: false
Possible values: true, false

If buttons in view tables, free-form tables or search results tables open a page on which a button with the setting "Reload opening window" is clicked, only the table itself is reloaded, not the entire window. If the entire window is to be reloaded, the value of the attribute must be set to true. Can be used for the following elements:

• Button

research-allow-longtext

Function: Search in long text fields
Data type: boolean
Default value: false
Possible values: true, false

Enables research in longtext fields with the value ""true"". Research is prevented with the value ""false"". Can be used for the following elements:

• Research

researchlevel

Function: Search tab when loading the page
Data type: text
Default value: 0
Possible values: 0.1

Researches can be saved personally (only accessible by the current user) or globally (accessible by all users). The Save search page, which is loaded when you click on the "Save search" link, contains a tab menu with the Personal and Global tabs. If the value of the attribute is 0, the focus is set to the Personal tab when the page is loaded. If the value is 1, the focus is set to the Global tab. Can be used for the following elements:

• Research

resizewin

Function: Adjust window size of a popup to the size of the page when loading the page
Data type: boolean
Default value: true
Possible values: true, false

By default (Value = ""true""), the window size of a popup adjusts itself to the size of the page, when it is loaded (e.g. due to a ""Show/Hide"" action of a button). If this is to be prevented, the attribute can be set to false for the button.

• Button

rq_<any expression>

Function: Sends a request parameter in the URL to the target page
Data type: text
Default value: Empty
Possible values: any expression, Velocity command

All attributes that begin with rq_, will be sent as a request parameter to the subsequent page. Please take note that the parameters are case-sensitive. The name of the rq_parameter can be anything (e.g. rq_myParameter). The value specified in the value can be read on the target page with the method $Request.get(rq_myParameter). Can be used for the following elements:

• Button

rq_exactmatch

Function: any expression, velocity command
Data type: boolean
Default value: false
Possible values: true, false

With buttons, which perform the action ""Data picker"", you can search in the linked edit field for terms. If there is more than one result, the hits are displayed in a table. The result selected here will automatically be copied to the edit element. Since online update 10, the new expert attribute is available for the Data picker button. This can be used to control the comparison behavior of data records and thus influence the number of results. With the value ""true"", an exact comparison is performed. Can be used for the following elements:

• Button

rq_matchmode

Function: Influence result set of data picker buttons
Data type: integer
Default value: 0
Possible values: 0 (starts with), 1 (contains), 2 (ends with)

With buttons, which perform the action ""Data picker"", you can search in the linked edit field for terms. If there is more than one result, the hits are displayed in a table. The result selected here will automatically be copied to the edit element. Since online update 10, the new expert attribute is available for the Data picker button. This can be used to control the comparison behavior of data records and thus influence the number of results. Can be used for the following elements:

• Button

sameWindow

Function: Loading data records of a view table in individual pop-up windows
Data type: boolean
Default value: true
Possible values: true, false

If data records of a table are to be loaded in individual popups, this attribute can be set to false. Add this attribute to the button in the table used to navigate to the data records. Can be used for the following elements:

• Button

show-clientpath

Function: Displays the ClientPath in all three styles of the FileWalker
Data type: boolean
Default value: true
Possible values: true, false

If the value is true, the ClientPath can be displayed and changed in all three FileWalker styles. If this is not desired, the value must be set to false. Can be used for the following elements:

• Filewalker

show-empty

Function: Display of lines and list elements with an empty value
Data type: boolean
Default value: true
Possible values: true, false

Applies to groupings of the types List and DIV: This expert attribute causes rows and list elements to be displayed if there is a view control with an empty value (zero) in the row or list element. Example: On view pages for the iPhone, on which a label and a view field are displayed next to one another, the rows and list elements can be filtered. If there are then 5 different telephone numbers, only the lines with the existing telephone numbers are displayed. Can be used for the following elements:

• Grouping

show-no-records

Function: Information text for view element Freely designed table
Data type: boolean
Default value: false
Possible values: true, false

As with the view table, the message "There is no data record" is displayed in a freely designed table if no data records are currently saved and the value of show-no-records is set to true. In addition, the no-records-text attribute (text type) can be used if a text other than "No record exists" is to be displayed. The value of this attribute is outputted instead of the standard text. Can be used for the following elements:

• Free layout table

show-only-stuffed

Function: Display of a table depending on existing data
Data type: boolean
Default value: false
Possible values: true, false

With the value false, a view table is always displayed. If the value of this attribute is true, the table is only displayed if data is available. Can be used for the following elements:

• View table

show-title

Function: Title instead of URL in view fields and view tables
Data type: boolean
Default value: false
Possible values: true, false

With show-title = ""true"", the title can be displayed instead of the URL link in view tables. In view tables, the attribute can be activated via the properties dialog, by clicking on the URL field and then on the Edit (""Expert"" tab) button. Can be used for the following elements:

• View field

• View table

show-totalcount

Function: Suppress or display total number of data records in view tables
Data type: boolean
Default value: false
Possible values: true, false

In view tables, the total number of data records is displayed on the right in the footer if the value of the attribute is true. The standard text of the output (number of data records: [ number]) can be overwritten with the totalcount-text attribute. Here, the variable ""$totalCount"" is used to show the sum total. The attribute's value could therefore, for example, be: ""$totalCount Entries"". Can be used for the following elements:

• View table

• Free layout table

• Research

show_if_not_set

Function: Shows button depending on the value of a request parameter
Data type: text
Default value: Empty
Possible values: see Description

The button is only displayed if the reference named in the value is not equal to 1. The value can be read with the following: $Request.get(rq_NameRequestvariable). Can be used for the following elements:

• Button

showadvice

Function: Inhibit info message when inserting a data record via data picker
Data type: boolean
Default value: true
Possible values: true, false

When inserting a data record via a button that executes the Datapicker action or for a selection list with data assignment, an info message is displayed in the browser with the value true. This notification can be removed by setting the attribute's value to ""false"". Can be used for the following elements:

• Drop-down list

• Button

showclosewin

Function: Hides the "Close window" link in pop-up windows
Data type: boolean
Default value: true
Possible values: true, false

This attribute needs to be added to the button which opens the popup window. The attribute is added on the Expert tab in the properties dialog. Can be used for the following elements:

• Button

showColAccess

Function: Hides the Accesses table column (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

The column in the table on the "Overview" page is hidden if the value is false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

showColApplication

Function: Hides the table column Application (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

The column in the table on the "Overview" page is hidden if the value is false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

showColAppLink

Function: Hides the Overview table column (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

The column in the table on the "Overview" page is hidden if the value is false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

showColBar

Function: Hides the table column Graphic (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

The column in the table on the "Overview" page is hidden if the value is false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

showColPages

Function: Hides the "Page" table column (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

The column in the table on the "Application statistics" page is hidden if the value is false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

showColPercent

Function: Hides the "Percent" table column (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

The column in the table on the "Overview" page is hidden if the value is false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

showDeletedApps

Function: Hides deleted applications in the statistics (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

Only the current applications are listed in the table on the "Overview" page. If deleted applications are also to be displayed, the value can be set to true. If deleted applications are displayed in the statistics, please note that no application name can be determined for these. These applications will be shown with ""* Deleted application*"". Can be used for the following elements:

• Statistic - upStatisticsAppControl

showFilter

Function: Displays the filter for restricting the date range (statistics application)
Data type: boolean
Default value: true
Possible values: true, false

If the filter is to be hidden, the value can be set to false. Can be used for the following elements:

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

showFilterInfo

Function: Date range in table header (statistics application)
Data type: boolean
Default value: false
Possible values: true, false

If a date range is set via the filter (see showFilter), the date range is displayed in the table header if the value is true. Can be used for the following elements:

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

showheader

Function: Shows or hides column headings
Data type: boolean
Default value: true
Possible values: true, false

This setting can be made in the properties dialog of view tables (""Options"" tab) with the option ""Show column headings"". If the value is false, column headings are hidden. This setting can, for example, be used for view tables which are shown in portlets. Can be used for the following elements:

• View table

• Bizwalker - upBizwalkerControl

• Statistic - upStatisticsAppControl

showOutlookExportControl

Function: Hides the button (button type Image) for appointments for Outlook export
Data type: boolean
Default value: true
Possible values: true, false

By default (Value = ""true""), a symbol is shown next to each appointment in calendar applications to export the appointment as a vcs file. If this symbol is to be hidden, the value of showOutlookExportControl must be set to false. Can be used for the following elements:

• Calendar plugin

showPollButtonNew

Function: Displays a "Create new survey" button in the survey portlet
Data type: boolean
Default value: false
Possible values: true, false

If the value is true, the button for creating a new survey is displayed in the portlet of survey applications; if the value is false, the button is hidden (see. also attribute link-pollNew - jump to an alternative input page). Can be used for the following elements:

• Polls portlet

showPollButtonResult

Function: Hides or shows the "Result" button in the survey portlet
Data type: boolean
Default value: true
Possible values: true, false

After voting, the current result of the poll is shown in the Current Polls portlet as a bar chart. The "Result" button for displaying the result diagram is displayed below the bar chart if the value of the attribute is true. If the value is false, the button is hidden. Can be used for the following elements:

• Polls portlet

showPollResult

Function: Hides or shows the bar chart of the survey result in the survey portlet
Data type: boolean
Default value: true
Possible values: true, false

If the value is true, the result of a poll is displayed in the portlet if the user has voted. With the value ""false"", the result is not shown. Can be used for the following elements:

• Polls portlet

showPollStatusIfNew

Function: Displays the poll result even without voting
Data type: boolean
Default value: false
Possible values: true, false

If the value is false, the poll result is only displayed after the vote in the portlet of poll applications. Can be used for the following elements:

• Polls portlet

showSelectedColor

Function: Display of the selected color
Data type: boolean
Default value: true
Possible values: true, false

For a color picker, this attribute will show the respective color selected as an action button (colored square) instead of the text link ""Select color"". If the text link is to be displayed instead, the expert attribute showSelectedColor must be defined with the value false. Can be used for the following elements:

• Color picker

showTabFilesearch

Function: Show or hide the "Search for files" tab
Data type: boolean
Default value: true
Possible values: true, false

To hide the "Search in files" tab, the value of the showTabFilesearch attribute must be set to false. Can be used for the following elements:

• Search

showTabSearch

Function: Show or hide the "Search" tab
Data type: boolean
Default value: true
Possible values: true, false

To hide the ""Search"" tab, the value of this attribute must be set to ""false"". Can be used for the following elements:

• Search

showTitle

Function: Shows or hides the table title on the "Overview" page in statistics applications
Data type: boolean
Default value: false
Possible values: true, false

If the value is true, the "Application access" table title is displayed. Can be used for the following elements:

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

showtooltip

Function: Hides or shows the tooltip in the resource application diagram.
Data type: boolean
Default value: true
Possible values: true, false

The value ""false"" allows you to hide the tooltip in the diagram. Can be used for the following elements:

• Resource chart - upResourceVerticalControl

showWeekNo

Function: Display of the calendar week in the dynamic "Calendar" filter
Data type: boolean
Default value: false
Possible values: true, false

With the value ""true"", the calendar weeks are shown in the calendar of the dynamic filter. Can be used for the following elements:

• Dynamic filter

showweeknr

Function: Show or hide the calendar week in the small calendar
Data type: boolean
Default value: true
Possible values: true, false

In calendar, weblog and resource applications, the small calendar is implemented for selecting appointments. The display of the calendar weeks can be suppressed if the value of the attribute is set to false. Can be used for the following elements:

• Project management - upGanttControl

sortable

Function: Determines whether or not sorting is possible according to a table column
Data type: boolean
Default value: true
Possible values: true, false

A table column can no longer be executed by clicking on the column title displayed in link form if the value is false. The column titles will no longer be shown as a link. Can be used for the following elements:

• View table

sortField

Function: Sorting of statistical data
Data type: text
Default value: OrderByHits
Possible values: see Description

Following values are possible for the application statistics (Page accesses):

• OrderByHits

• OrderByPageName

Following values are possible for the global statistics (Application accesses):

• OrderByHits

With the expert attribute ""sortOrder"", you can additionally define whether it should be sorted ascendingly or descendingly. Can be used for the following elements:

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

sortOrder

Function: Sorting tables in ascending or descending order in the statistics application
Data type: integer
Default value: 1
Possible values: 0.1

With sortOrder = 1, a table is sorted in descending order. With sortOrder = 0, a table is sorted in ascending order. In the statistics application, the sortOrder attribute can be applied to the XUnits of the "Overview" and "Application statistics" pages. If the sort order of a free-form table is to be changed, the attribute must be entered directly in the view elements defined on the linked view page. Can be used for the following elements:

• Free layout table

• Statistic - upStatisticsAppControl

• Statistic - upStatisticsAppControl

sw-past-years

Function: Year display on the spinning wheel
Data type: integer
Default value: 50
Possible values: Integer values

Input controls for date and time are automatically equipped with a spinning wheel as an input aid for iPad and mobile web kits. With this expert attribute, you can determine how years before and after the current year are provided as an option in the spinning wheel. Can be used for the following elements:

• Edit field

text-if-addcheck-false

Function: Displays buttons if additionalcheck returns false, without jump action
Data type: boolean
Default value: false
Possible values: true, false

With the attribute ""additionalcheck"", you can make a comparison with the value of an element on the page. If the result is true (value of the element matches the value of the attribute), the button is displayed. If the result of the comparison is false, the button is hidden. If this attribute is also set, the button is still displayed but does not execute a jump. Can be used for the following elements:

• Button

textTransform

Function: Converts text into uppercase or lowercase letters during input
Data type: integer
Default value: 0
Possible values: 0,1,2

If the attribute is entered with the value 1 for input fields with data type text, all letters are converted to capital letters when they are entered. 2 as the value transforms the letters into lowercase. Can be used for the following elements:

• Edit field

ticker

Function: Display the content of a grouping in ticker form (automatic scrolling)
Data type: boolean
Default value: false
Possible values: true, false

If the value of the attribute is true, the content of a grouping is displayed in ticker form. The scroll direction can be controlled using an additional attribute ""tickerDirection"":

tickerDirection: 0 -> upwards
tickerDirection: 1 -> downwards
tickerDirection: 2 -> to the left
tickerDirection: 3 -> to the right

If the tickerDirection attribute is not set, the content scrolls from bottom to top. Can be used for the following elements:

• Grouping

timeInterval

Function: Changes the minute interval for the small calendar
Data type: text
Default value: 30
Possible values: Integers

If the Calendar action (Properties dialog, Actions tab) is set for buttons, a small calendar for selecting appointments is displayed in the browser. The time can be selected via a selection list if the linked input field is of the date & time type. By default an interval of 30 minutes is shown. The interval can be modified by entering an alternative interval (e.g. 10 for 10 minutes) as the value of the attribute ""timeInterval"". Can be used for the following elements:

• Button

timeout

Function: Controls timeout when requesting large amounts of data
Data type: integer
Default value: -1 = no timeout
Possible values: Integer values

Timeout value for XML HTTP requests in milliseconds. Can be used for the following elements:

• Button

tiny-userconfiguration

Function: Additional configuration options for editor
Data type: text
Default value: Empty
Possible values: Character string

With the attribute ""tiny-userconfiguration"", a VM file either additional configuration options can be integrated for each editor instance; this can expand an existing configuration or overwrite defined settings. Can be used for the following elements:

• Text area

tooltip-adoptmeasure

Function: Defines the behavior of pages that are loaded into an existing tooltip.
Data type: text
Default value: min-both
Possible values: see Description

Works with the "Open in current window" button option. If the value is *empty*, the tooltip always adapts to the current content.

Value fix-both or fix-width | fix-height: Tooltip adopts the current width and/or height.

Value max-both | max-width | max-height: Tooltip adopts the current width and/or height as the maximum width/height.

Value min-both | min-width | min-height: Tooltip adopts the current width and/or height as the minimum width/height.

Can be used for the following elements:

• Button

tooltip-alignment

Function: Position of a tooltip relative to the action control
Data type: text
Default value: s. Description
Possible values: see Description

Action controls that open tooltips can have the following attributes which determine a tooltip's positioning relative to the action control:

tooltip-alignment - right|left tooltip-valignment - bottom | top

The default value for action controls in tables is right - bottom. Otherwise the default value is left - bottom. The spacing of a tooltip can be controlled via offsets (see Expert attributes tooltip-offsetY and tooltip-offsetX). Can be used for the following elements:

• View table

• Button

tooltip-classname

Function: Defines the style class of a tooltip
Data type: text
Default value: TT_POPUP or TT_MODAL
Possible values: style class

First of all, a new style class must be defined for the tooltip in the current window. The best method is to duplicate an existing style class, such as TT_POPUP (with the corresponding subclasses). Can be used for the following elements:

• Button

tooltip-closebyclick

Function: Automatic closing of tooltips
Data type: boolean
Default value: false
Possible values: false, true

A tooltip is automatically closed when the mouse is clicked on an area outside of the tooltip. Can be used for the following elements:

• Button

tooltip-draggable

Function: Move tooltips that are opened with buttons using drag & drop.
Data type: boolean
Default value: true
Possible values: true, false

Relates to buttons that open a tooltip. The "tooltip-draggable" attribute can be used to control whether the tooltip can be moved in the browser.

• Button

tooltip-maxheight

Function: Maximum height of a tooltip
Data type: integer
Default value: Setting of the current layout
Possible values: Integer values

Defines the maximum height of the tooltip being opened. Can be used for the following elements:

• Button

tooltip-maxwidth

Function: Maximum width of a tooltip
Data type: integer
Default value: Setting of the current layout
Possible values: Integer values

Defines the maximum width of the tooltip being opened. Can be used for the following elements:

• Button

tooltip-offsetX

Function: Distance of a tooltip from the action control
Data type: integer
Default value: s. Description
Possible values: see Description

tooltip-offsetY controls the vertical distance of a tooltip from an action control in pixels. tooltip-offsetX controls the horizontal distance of a tooltip from an action control in pixels. Can be used for the following elements:

• View table

• Button

tooltip-overflowWindow

Function: Tooltip position
Data type: boolean
Default value: false
Possible values: true, false

The value ""false"" means that the tooltip being opened is positioned in the visible area, the value ""true"" means it has a defined position (Table: to the right of the button, otherwise beneath the button). Can be used for the following elements:

• Button

tooltippopup-name

Function: Grouping tooltips
Data type: text
Default value: <name of the action control>
Possible values:

Relates to action controls who open their target destination in a new tooltip. With the expert attribute ""tooltippopup-name"", tooltip groups can be defined. The attribute is added to the button that opens the tooltip. The attribute automatically ensures that only the tooltip of the most recently clicked button is opened. Example: 3 buttons with 3 different jump targets and the expert attribute tooltippopup-name= groupTest. Clicking on button 1 opens a new tooltip, clicking on button 2 closes the tooltip and opens a new tooltip ... Can be used with the following elements:

• Button

userecid

Function: Jump to a specific data record
Data type: integer
Default value: Empty
Possible values: Integer values

Opens the data record with the LID entered as the attribute's value on the target page. Can be used for the following elements:

• Button

visibleentries

Function: Set number of entries for scrollbars in the list box (list box control)
Data type: integer
Default value: 5
Possible values: Integer values

How many entries are visible in the list? If there are more entries, scrollbars appear. This attribute is written to the HTML element as a CSS inline style. Can be used for the following elements:

• Listbox

vm-file

Function: Include VM file for displaying user information
Data type: text
Default value: Empty
Possible values: Name and path of the alternative VM file for displaying user information

View fields can be configured to show user information. The name of the user is presented as a link which opens a popup window with additional information about the user. The content of the popup is defined in the static VM file userinfo.vm in the portal directory internal/system/vm/html/user/userinfo.vm, which can be customized if required. Make a copy of ""userinfo.vm"", provide it with a new filename and enter the new file name, with the complete path, as the value of the ""vm-file"" attribute. Can be used for the following elements:

• View field

weekNumbers

Function: Display of the calendar weeks in the calendar for date selection
Data type: boolean
Default value: true
Possible values: true, false

Shows or hides the calendar weeks in a calendar linked to an input field(date control type) for date selection with the value "false". Can be used for the following elements:

• Edit field

width

Function: Defines the absolute or relative width of a page
Data type: text
Default value: Empty
Possible values: see Description

The width of a page in a popup window can be defined with this attribute. Enter this attribute in the page's properties dialog (""Expert"" tab). Absolute entries are entered as an integer, relative entries in the form of a percentage (e.g. ""50%""). If an element on the page has the dynamic-width attribute with the value true, the width attribute has no effect. Can be used for the following elements:

• Page [FRAME_APPMAIN]

windowprops

Function: Setting the pop-up window properties
Data type: text
Default value: Empty
Possible values: dependent=yes,menubar=no,toolbar=no,scrollbars=yes,resizable=yes

Defines the properties of a popup, e.g. which symbol bars should be shown. Can be used for the following elements:

• Filewalker

• Button

windowsettings

Function: Defines the size and position of a pop-up window
Data type: text
Default value: 400,400,10,0,1
Possible values: see Description

The size and position of a popup is defined with the properties ""width"", ""height"", ""offsetX"" and ""offsetY"". These four properties are specified as the value of the attribute ""windowsettings"" in the order specified above, in pixels and separated by a comma. The fifth parameter defines whether the popup should align itself to the button opening it (Value = 1, as shown as the default value) or to the top-left corner of the screen (Value = 0). This attribute can only be used for jumps to internal pages. It has no effect on jumps to external links. Can be used for the following elements:

• Filewalker

• Button