Element Details: Input Combo List
 Back


Available in: Logi Info Source code name: InputComboListIntroduced in: 12.1.188

Displays an input control allowing the user the option of either typing in a value, or selecting value from a dropdown list.

Once the page is submitted, the selected value(s) may be referenced with @Request.x~, where "x" is the ID of the list element.

With MultiSelect="True", multiple values are separated by commas. Frequently, these values are used in SQL "IN" clauses in conjunction with the @SingleQuote token. For example: ...WHERE LastName IN (@SingleQuote.Request.x~)...

The list comes from a DataLayer.

If the InputComboList is under a DataTable that produces multiple rows, the DataLayer only runs once. Thus all lists have the same rows. You can not reference @Data tokens from the parent DataTable in the InputSelectList's DataLayer.

Height can set the height of the dropdown list in pixels.

Element Group:User Input



ATTRIBUTES

Click attribute Name to drill down for more information.

NamePossible ValuesDescription
Caption
UserDefined
The Caption attribute identifies the text to be displayed. For Image elements, Caption specifies the image filename.
CaptionClass
UserDefined
For Input elements, this is style sheet class that will be applied to the input element's caption. Leave this value blank unless you want the Caption to have a different class than the input element. For tables, Caption Class sets the class for the table's caption, which appears as a header above the table.
ChangeFlagElementID
UserDefined
ChangeFlagElementID helps Process Tasks know when an input value has been changed by the user. For example, a Process may only UPDATE rows when the user actually changed something, and otherwise skip the UPDATE. Set ChangeFlagElementID to the ID of an InputHidden element. Then, if the user changes this input element, the hidden element's value will become "True". You can test for this value in a Procedure.If. When using ChangeFlagElementID with an Input element that's under a DataTable, be sure to put the InputHidden element under a DataTableColumn. Process input from individual rows under a Procedure.RunDataTableRows. ChangeFlagElementID relies on the Javascript "onchange" event, so you will not be able to use your own "onchange" EventHandler with ChangeFlagElementID.
Class
UserDefined
Sets the Cascading Style Sheet class used by the element. When set, this class will also be used by all child elements that don't have their own class. The class should be defined in the report's style sheet file.
ComboListColumn
UserDefined
(Required) Enter the name of a column from the DataLayer. Values from the column will appear in the drop-down list.
DefaultValue
UserDefined
The default value displayed or selected when the report page is initially displayed. For the InputSelectList element, to show multiple selected values, this attribute can be over-ridden by adding a DefaultValues element with a DataLayer below that.
Format
UserDefined
Allows a string to be formatted in various ways, especially for numeric and date values. Specifies formatting characteristics for the data. This attribute has been borrowed from the Microsoft Visual Basic Format function. For more information: http://msdn.microsoft.com/en-us/library/59bz1f0h(VS.71).aspx For dates, the non-specific formats, such as "General Date", "Short Time", etc., are converted according to the browser's international setttings. Also, for very large reports, the non-specific formats perform better. There are also some special formats. "<" and ">" change strings to lower and upper case. "Expanded Spaces" preserves space characters that would otherwise be collapsed by the web browser. "HTML" preserves HTML tags so that they are not encoded - they are embedded rather than shown. "Preserve Line Feeds" preserves line feed and cariage return characters so that the following characters appear on a new line. "mp" formats numbers with the "metric prefix". To format 1,234,567 as "$1.23M", use Format "$#.00mp". Supported metric prefixes are from 1000^6 to 1000^-6 For more information: http://en.wikipedia.org/wiki/Metric_prefix "mpsx" formats the value with x number of significant figures in addition to the metric prefix. So a value of 123456, with format set to mps3 will return 123k. "qq" returns the number of the quarter when the value being formatted represents a date. To return the year and quarter together like "2010 Q1", set the format to "yyyy Qqq". "fyy" and "fyyyy" return the fiscal year. "fqq" returns the fiscal quarter. The fiscal year start date may be configured in the settings' Globalization element. "ww" returns the number of the week. The first day of the week may be configured in the settings' Globalization element.
Height
UserDefined
The height of the element. For some elements, leave the height blank to automatically size the element to the height of the content.
ID
UserDefined
(Required) The ID attribute is a pervasive attribute that uniquely identifies an element within a definition file. The ID needs to be a unique value within the definition.
InputMaxLength
UserDefined
The maximum number of characters that can be entered into the input box.
InputSize
UserDefined
The width of the input box.
MultiSelect
True
False
When set to True, the user may select multiple options. All the selected values may be referenced with @Request.x~, where "x" is the ID of the list element. (@Request.x~ just returns the first selected value.) Normally, each value is separated by a comma. Frequently, these values are used in SQL "IN" clauses in conjunction with the @SingleQuote token. For example: ...WHERE LastName IN(@SingleQuote.Request.x)... For the InputSelectList, the user may choose more than one selection by clicking while holding down the Ctrl and Shift keys. When using the DefaultValue attribute, you may have more than one pre-selected value. Again, these values are normally separated by a comma. For the InputSelectList the default is False. For the InputCheckboxList the default is True.
Placeholder
UserDefined
The placeholder attribute specifies a short hint or caption that describes the expected value of an input element. In some cases it may be used in place of a caption.
SaveInCookie
True
False
Saves the information entered by the user in a cookie. You can use the cookie to set the default value so that previously entered data is retrieved. Hint: Set the Default Value attribute to something like "@Cookie.myInputId~". SaveInCookie does not work under DataTables and other data-repeating elements.
SaveInLocalStorage
True
False
LocalStorage stores data in the browser. The information is maintained between sessions. SaveInLocalStorage uses the browser's localStorage to preserve input values so they re-appear when a page is redisplayed. It is a way of keeping default values. Set SaveInLocalStorage="True" to preserve and restore input values. SaveInLocalStorage is over-ridden by DefaultValue attributes. Do not use SaveInLocalStorage and DefaultValue attributes together. SaveInLocalStorage does not work under DataTables and other data-repeating elements. LocalStorage requires browser support. IE7 does not support LocalStorage.
SecurityRightID
UserDefined
When entered, access to this element can be controlled with Logi security. Supply the ID of a right defined in the applications settings’ Security element. Only users that have a right in the SecurityRightID will be able to see the element. Note that when rights come from RightFromRole elements under Security/UserRights, and this element's SecurityRightID does NOT match any of the Right IDs defined in the Settings definition, then the user DOES have access. But when Right IDs are instead derived from RightsFromDataLayer or RightsFromRoles elements, and the user DOES NOT have a matching Right, then the user DOES NOT have access. You can enter multiple right IDs, separated by commas. In this case, the user sees the element if he has any one of the Rights.
Tooltip
UserDefined
Text that appears when the user hovers the pointer over the image or text.
TooltipColumn
UserDefined
For a value different than the default tooltip value, set this to a column returned from the DataLayer. It represents the tooltip value for each item.



PARENT ELEMENTS

Click element to drill down for more information.

Body
Column Cell
Data Table Column
Division
Fieldset Box
HTML Tag
Input Grid
List Item
Panel Content
Panel Parameters
Popup Panel
Rectangle
Report Footer
Report Header
Responsive Column
Tab Panel


CHILD ELEMENTS

Click element to drill down for more information.

Conditional Class
DataLayer.ActiveSQL
DataLayer.Bookmarks
DataLayer.Cached
DataLayer.CSV
DataLayer.Definition List
DataLayer.Directory
DataLayer.Excel
DataLayer.Fixed Format File
DataLayer.Google App
DataLayer.Google Spreadsheet
DataLayer.JSON
DataLayer.LDAP
DataLayer.LDAP Authentication
DataLayer.Linked
DataLayer.MDX
DataLayer.Mongo Find
DataLayer.Mongo Map Reduce
DataLayer.Mongo Run Command
DataLayer.REST
DataLayer.REST
DataLayer.SP
DataLayer.SQL
DataLayer.Static
DataLayer.Twitter
DataLayer.Web Feed
DataLayer.Web Service
DataLayer.XML
DataLayer.XOLAP Query
Event Handler
Validation.Javascript
Validation.Length
Validation.Numeric
Validation.Required


 Back to top


© Copyright 2007-2019 Logi Analytics, Inc. All Rights Reserved           |          Contact DevNet          |          Site FAQs          |          Terms of Use          |          LogiAnalytics.com