Build.One Documentation
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Create a DynSelect in a viewer

Open the Viewer in design mode. Create the necessary columns and blocks where the DynSelect should be placed.

Press the 'Add' button and find the 'SimpleSwatSelect' and drag it to the correct place.

Attributes for DynSelect in a Viewer

In this example it is a viewer on 'Adresstyp'. The field Adresstyp.Adrsubtyp_ID is available in the table, but Adresstyp.Adrsubtyp is a calculated field in the Business Entity and filled with the value of Adrsubtyp.Adrsubtyp.

Select the SimpleSwatSelect input field and set the following attributes (be aware, some attributes are case-sensitive):

AttributeValueExplanation
nameadrsubtypThe field which is initially displayed in the input field (closed DynSelect). In this case it is the calculated field
EntityNameOsiv.BusinessLogic.ipar.AdrSubtyp.AdrSubtypBE The Business Entity class of the 'child' table
EntityTableeAdrSubtypThe 'child' table to populate the DynSelect with
FieldLabelBasistypThe label to show in the viewer
LookupKeyFieldadrsubtyp

The field to be displayed after an entry is selected (normally the same as attribute 'name').

Can also be a comma-separated list of fields and constants, for example: adrsubtyp,' - ',bez

LookupKeyValueBindingadrsubtyp_id

This represents the DataSource (of the viewer) its DataField where the value from attribute 'LookupKeyValueColumn'

will be stored in, in this case the relational Adresstyp.Adrsubtyp_ID

LookupKeyValueColumnadrsubtyp_idThe key field from the Business Entity of attribute 'Entityname', in this case the relational AdrSubtyp.Adrsubtyp_ID field
TemplateGenericAutocompleteSearchTemplateDynSelect 
templateOptions|adrsubtyp|bez

The format of an entry in the drop-down. The format is: image|keyfields|other-fields

The format can also contain constants, for example: ' - '

VisualizationTypeFILL-IN 
WIDTH-CHARS230This is not the same as other fields. The value must be set much higher.
LookupFields A comma separated list of fields which will be assigned after an entry is selected. Those values will be saved as well
LookupControls The corresponding UI controls of attribute 'LookupFields'
MULTIPLE If more entries can be selected (currently not implemented in a Viewer)
maximumSelectionLength How many entries can be selected. Works only with attribute MULTIPLE (currently not implemented in a Viewer)
minimumInputLength The minimum characters which must be typed before any result is displayed in the DynSelect
closeOnSelect Leave the drop-down open or not. Nice feature with MULTIPLE attribute
tags The value typed-in will be added to the drop-down list
initialFetch 

Default expression when building the DynSelect for the first time.

Works together with method BuildAutoCompleteSearchQuery, parameter pcKey.

Override the BuildAutoCompleteSearchQuery method in the corresponding DataAccess class to modify the lookup query.

Be aware that the SourceDefaultQuery must invoke its super (i.e. super:SourceDefaultQuery(pcTable)),
otherwise BuildAutoCompleteSearchQuery will not be executed.

onBeforeFetch 

Event: This is an event which is triggered every time the DynSelect is opened. This is usefull when another DynSelect

needs to use the value of another DynSelect.

validateEvent Event: This event is triggered every time an entry is selected. This is usefull for validations
resultListMenuCode Contains the name of a menu-structure, and will be displayed at the end of the DynSelect

 

 

  • No labels