The CLIENTCONFIG component is an invisible component which allows to set global client configuration parameters.
The most important parameters are the COUNTRY and the LANGUAGE that is used for the client components. But there are many more parameters.
Typically used attributes
All attributes are
Used inside: BEANPROCESSING, CONTENTPANE, PANE
Special binding to component adapter object instance on server side. The component adapter must be an instance of IComponentAdapterBinding. For some components (e.g. FIXGRID) there is an extended interface (e.g. IFIXGRIDComponentAdapterBinding).
The attribute value must be an expression.
| #{tobedefined} | Binding to IComponentAdapter instance |
Defines if the client executes animations or not. In certain situations it is useful to switch off all animatiosn - e.g. when using screens via terminal server.
| true | (default) animations are enabled |
| false | animations are disabled |
Name of macro that is used for generating certain attributes of this component. Please pay attention: the value of this attribute is read one time for each control and cannot be changed afterwards.
The attribute value must not be changed once the component is created.
When the client communicates then by default the dialog processing is blocked and a beep-sound is output when the user e.g. clicks into the screen. You can override this default behavior by using this attribute.
| true | (default) Beep-sound |
| false | No beep-sound |
If set to true, then the client logging will be activated.
| false | No client logging (default) |
| true | With client logging |
Log level on client side.
| ALL | Debug |
| INFO | Info (default) |
| WARNING | Warning |
| ERROR | Error |
Comment that can be asigned to any component. The comment is not operationally used.
| Any text | Any text |
Configuration information that is attached to this component. This information is not functionally used by CaptainCasa, but may be used for any application specific purpose.
If set to true then the browser client will ask the user for confirmation before closing the current page.
| false | Page closed without confirmation (default) |
| true | User needs to confirm closing of page |
Text that is shown to the user in case of connections problems.
Decision if to explicitly show the user a popup message in case of connection problems. If set to false then no popup is shown but immediately the user receives some error message.
Country abbreviation - important for setting date/time/decimal format of output.
| DE | Germany |
| FR | France |
| US | United Stated |
| ... | Country ISO Codes |
By default the client removes the text selection on double click in order to ensure a proper e.g. double click selection in grids. You may override this by setting this attribuet to true.
| true | (default) Double click clears text selection. |
| false | Double click does not clear text selection. |
Duration until a glass pane is overlayed on top of the screen in order to catch any time of user mouse events after initiating a round trip.
| 200 | 200ms |
| 250 | 250ms |
| 300 | 300ms |
| 350 | 250ms |
| 450 | 300ms |
Duration until phase 2 of blocking is started (default: dark overlay)
| 200 | 200ms |
| 250 | 250ms |
| 300 | 300ms |
| 350 | 250ms |
| 450 | 300ms |
Duration until phase 3 of blocking is started (default: spinning wheel image)
| 1000 | 1000ms |
| 1500 | 1500ms |
| 2000 | 2000ms |
Semicolon separated list of string values, that are interpreted on client side as empty string when calculating the BGPAINT for e.g. mandatory attributes. By default an attribute value is treated when it is null or when it is an empty string - here you can add alternatives.
| default - not additional empty values | |
| - | - is treated as empty value |
| [null];[undefined] | [null] and [undefined] are treated as empty value |
String representation that is used for the boolean value false
| null | default value for false |
| _ | _ is displayed for true |
Name of font to be used in client. This is either the name of a specific font, or a semicolon separated sequence of fonts - the first font, that is available on client side, will be selected
| Arial | Arial |
| Courier New | Courier New |
| Trebuchet MS | Trebuchet MS |
| ... | Any other font family name |
| FontAwesome | Icon font: Awesome font |
| SAPIcons | Icon font: SAP icons |
| Trebuchet MS;Arial | Try Trebuchet, if not available then use Arial |
Indicates that HTML5 drag drop should be used for all drag drop operations.
| false | false (default) |
| true | true |
Indicates that HTML5 drag-drop should be used also for cross browser drag drop operations. If set to false then drag-drop is only supported within the same browser instance.
| true | true (default) |
| false | false |
Browsers added a certain function to input elements: the management of values. Typical use case: passwords may be stored in the browser. Some browsers to extends this by also keeping other input parameters as well.
| false (default) | |
| true | Use the default input-component configuration without trying to control autofill/complete in any means. |
| false | Use the default configuration that CaptainCasa applies to an input element in order to avoid autofill/complete. |
Hotkey definition that is used in fields for opening the key variant dialog.
| No keyboard association (default) | |
| ctrl-83 | Control key + s |
| alt-83 | Alt key + s |
| shift-83 | Shift key + s |
| ctrl-shift-83 | Control key + Shift key + s |
| 10 | return |
| 32 | space |
| 37 | cursor left |
| 38 | cursor up |
| 39 | cursor right |
| 40 | cursor down |
| 33 | page up |
| 34 | page down |
| 36 | Begin |
| 35 | End |
| 27 | escape |
| 127 | Del |
| 65 | a |
| 66 | b |
| 67 | c |
| 68 | d |
| 69 | e |
| 70 | f |
| 71 | g |
| 72 | h |
| 73 | i |
| 74 | j |
| 75 | k |
| 76 | l |
| 77 | m |
| 78 | n |
| 79 | o |
| 80 | p |
| 81 | q |
| 82 | r |
| 83 | s |
| 84 | t |
| 85 | u |
| 86 | v |
| 87 | w |
| 88 | x |
| 89 | y |
| 90 | z |
| 48 | 0 |
| 49 | 1 |
| 50 | 2 |
| 51 | 3 |
| 52 | 4 |
| 53 | 5 |
| 54 | 6 |
| 55 | 7 |
| 56 | 8 |
| 57 | 9 |
| 112 | F1 |
| 113 | F2 |
| 114 | F3 |
| 115 | F4 |
| 116 | F5 |
| 117 | F6 |
| 118 | F7 |
| 119 | F8 |
| 120 | F9 |
| 121 | F10 |
| 122 | F11 |
| 123 | F12 |
Language abbreviation.
| de | German |
| fr | French |
| en | English |
| ... | Language ISO Codes |
By default styles are loaded without reference to the http session. If switching this attribute to true, then the client will automatically add a jsessionid-extension to the URL loading the style (in case of using session management by URL-encoding). You only should use this attribute if building up some own style management, in which the runtime style is updated during a session and in which the loading/building of the style requires a separation of sessions
| false | Style is loaded as normal resource |
| true | >Style is loaded with explicit reference to session |
If the communication of the client to the page then the client retries to reach the server. This attribute defines the number of retries.
| 0 | no reconnects |
| 1 | 1 reconnect (default) |
| 2 | 2 reconnects |
Definition if automatic copy-clipboard popup menu is provided for text components.
| true | Popup menu is automatically provided. |
| gridOnly | Popup menu is automatically provided for components inside some grid. |
| false | (default) No automatic popup menu. |
Definition if all global hotkey definitions are automatically available as popup menu items.
| true | (default) Global hot key definitions are added to any popup menu. |
| false | No adding of global hot key definitions to popup menu. |
Reference to an outside object that is the content behind the component. E.g. a field is representing a certain field of a database table: in this case you could define the value table;column. The reference plays a siginficant role within the attributemacro management.
The attribute value must not be changed once the component is created.
| ref | One reference |
| ref1;ref2 | Two references |
| ref1;ref2;ref3 | Three references |
Scaling of sizes on client side. Float value. If attribute SCALEFONT is not set, then the scale value is taken for fonts scaling, too.
| any float value, well reasonable is something between 1.0 and 2.0 ... | |
| 1.0 | 100% (default) |
| 1.25 | 125% |
| 1.5 | 150% |
Top color of color shading that is applied when a grid row is selected.
| #FFFFFF | White |
| #000000 | Black |
| #FF0000 | Red |
| #00FF00 | Green |
| #0000FF | Blue |
| #0000FF30 | Blue with a transparency of x30. |
Bottom color of color shading that is applied when a grid row is selected.
| #FFFFFF | White |
| #000000 | Black |
| #FF0000 | Red |
| #00FF00 | Green |
| #0000FF | Blue |
| #0000FF30 | Blue with a transparency of x30. |
In case of a server side session timeout: navigate the browser to this URL
| https://www.captaincasa.com | Absolute URL |
| /html/sessiontimeoutpage.html | Relative URL (base is the WebContent) |
| /abc.def.risc | Relative URL (base is the WebContent) directly starting a CC dialog |
If enabled then the return-key will switch the focus to the next component.
| true | Switch focus on return-key |
| false | Switch focus on tab-key only (default) |
Timezone that is used for transferring the date input into a time stamp. Values need to correspond to TimeZone.getAvailableIDs().
| LOCAL | To be set if using LocalDate/LocalTime on server side |
| ----- | -------------------- |
| GMT | GMT - Greenwich Mean Time (no daylight saving) |
| UTC | UTC - Coordinated Universal Time (no daylight saving) |
| ----- | -------------------- |
| CET | CET - Central European Time |
| Europe/Paris | Europe/Paris |
| Africa/Harare | Africa/Harare |
| Asia/Tel_Aviv | Asia/Tel_Aviv |
| ... | ... |
The title of the dialog.
Image that is shown in the browser tab of the page as fav-icon.
| /images/abc.png | Image /images/abc.png |
| /images/svg/def.svg | Image /images/svg/def.svg |
Central swicht to provide touch dialogs for all input componentes.
| false | no touch support (default) |
| true | With touch support |
String representation that is used for the boolean value true
| null | default value for true |
| X | X is displayed for true |