Selectbox

Selectbox

This element is used to display a select box on the page.

Attributes

NameDescriptionValue
id

Unique Identifier.

Any
nameThe selectbox name.Any
visiblemodesThe modes the selectbox should be visible.A comma-separated list of the modes (read, new, edit)
visibilityconditionsThe conditions that should be met in order to display the selectbox.'[[pagefunction, datatype, datapath ]]' operator(==,!=) 'value'
readonlyIf true then the selectbox value cannot be changed.true or false
readonlyconditions

The conditions that should be met in order to display the selectbox in read only mode.

'[[pagefunction, datatype, datapath ]]' operator(==,!=) 'value'
datapathThe data path field name.Needs to correspond to the CRMDO object field
datatypeThe type of datapath field.alias, load, java.lang.Integer, java.lang.String, ...
refreshThe parts of the page that should be refreshed when the selectbox value is changed.

page

mainmenu

main

details

tab,tabID

component,is_on_tab:is_on_menu:tabID:componentID

element,is_on_tab:is_on_menu:tabid:componentID:elementID

section,sectionID

area,areaID

  type 

The type 'singleline' can be used to show all options in one line, instead of one per row. 

singleline 
lookuptypeThe type of lookup.fixed, dataset, ejb
lookupnameThe dataset name if the lookuptype is equal to dataset.

The file path under the folder 'Crm/WebContent/pages/search'

alwayseditableSelectboxes can be defined as always editable.true or false
reload

If set to true then it means that the selectbox will be called on every refresh of the page. 

For lookuptype: dataset, ejb

true or false
options

Defines the selectbox options.

For lookuptype: fixed

option1:option_label1;option2:option_label2;option3:option_label3

valueDefines the current value of the selectbox.'[[pagefunction, datatype, datapath ]]'
defaultvalueThe default value to be assigned to the datapath.Any
onload

Defines the function call triggered to load the selectbox.

For lookuptype: ejb

<function>…</function>
onchangeDefines the function call(s) triggered when the selectbox value is changed.<functions>…</functions>

Examples

 Fixed

Fixed
<selectbox>
	<readonlyconditions>'[[getAlias,java.lang.String,editDiscountSectionAllowed]]'=='0'</readonlyconditions>
	<tipexpression>key_determines_how_an_additive_discount_will_be_applied_in_relation_to_other_additive_discounts_that_might_also_be_applicable._level_stars_from_the_lowest_to_highest._the_percentage_of_auto_apply_discount_having_the_same_level_is_added_and_the_total_discount_percentage_is_applied.</tipexpression><id>1</id>
	<label>key_discount_level</label>
	<colspan>1</colspan>
	<width>20%</width>
	<type/>
	<lookuptype>fixed</lookuptype>
	<datapath>level</datapath>
	<datatype>java.lang.Integer</datatype>
	<options>:key_select_level;1:1;2:2;3:3;</options>
	<reload>true</reload>
</selectbox>
 EJB Lookup

EJB Lookup
<selectbox>
	<id>slbType</id>
	<label>key_type</label>
	<lookuptype>ejb</lookuptype>
	<datapath>type</datapath>
	<datapathid>id</datapathid>
	<classname>com.crm.dataobject.financialtransactions.CRMDOFinancialTransactionType</classname>
	<datatype>load</datatype>
	<reload>true</reload>
	<refresh>page</refresh>
	<onload>
		<type>ejb</type>
		<classname>ejb/CRMUIFinancialTransactionType</classname>
		<functionname>getTypeOptions</functionname>
		<parameters>
			<parameter>
				<value>INVOICE</value>
				<datatype>java.lang.String</datatype>
			</parameter>
		</parameters>
	</onload>
	<onchange>
		<functions>
			<function>
				<type>staticjs</type>
				<functionname>voidFunc</functionname>
			</function>
		</functions>
	</onchange>
</selectbox>
 Search File Lookup

 

Search File Lookup
<selectbox>
	<id>slbAddressCountry</id>
	<label>key_country</label>
	<lookuptype>dataset</lookuptype>
	<lookupname>platform.loadcountries;countryid;countryname;</lookupname>
	<datapath>selectedAddress/country</datapath>
	<datapathid>id</datapathid>
	<classname>com.crm.dataobject.platform.CRMDOCountry</classname>
	<datatype>load</datatype>
	<reload>false</reload>
	<refresh>component,false:false:null:cmpCountry</refresh>
	<onchange>
		<functions>
			<function>
				<type>staticjs</type>
				<functionname>voidFunc</functionname>
			</function>
		</functions>
	</onchange>
</selectbox>