How to Use Static Lists
See also:
What is a static list
A static list is a list of values that can be displayed in a
dropdown list or as radio buttons. An important feature of static lists is that
the values displayed to the end-user are language-dependent, i.e. they change
based on the runtime language. Static lists are stored in the Ebase repository
database and can be created and maintained by any Ebase users with the
appropriate authorisation. A static list is loaded by the system when it is
first referenced and is then cached in memory.
Static lists are sharable elements within the Ebase system
and, once created, can be used by any number of forms.
As the name implies, static lists are designed to be used
for lists that change infrequently. Examples include:
|
TITLE: |
values - Mr, Mrs, Miss, Dr, Other etc |
|
SEX: |
values - Male, Female |
|
CAR_TYPE: |
values - |
Each entry in a static list consists of three variables:
- Display
text: is the text displayed to the end-user and will vary dependent on
the language
- Return
value: is the value held internally by the system. This value can be
used by scripts that need to check or assign values.
- Language:
is the language for the display value
Creating and maintaining a static list
A static
list is created and maintained using the static list editor within the Ebase Xi
Designer. This is opened either by clicking on an existing list from the
hierarchy tree panel (Shared Elements -> Static Lists) or by creating
a new list from the menu (File -> New -> List -> Static List).
The static list editor looks like this:
Note that the return value for Male and Mann is 'M' and the return
value for Female and Frau is 'F'. The Display seq. column can be used to
order the display. Clicking on the language field will present a
dropdown list of languages supported. (See Internationalization Support)