Dropdown local number

Widget is represented by a label and dropdown below label. Data that is saved to database is of datatype "number".

Widget id, ${gbamID}:

dropdownLocalNumber

Back to GBAM widgets table

Datatypes

Value is stored from widget to database as number datatype.

Predefined user data

PreLoaded

• ${screenLabel}

Properties panel

User will configure this data in properties panels of selected widget:

GENERAL

• "label", ${widgetLabel}

VALIDATIONS

• "required", RequiredValidator, add to configuration.xml:

    <columnNumber required="true|false"></columnNumber>

• "decimal format", TextValidator#REGEX set to @string/$decimalPattern not changeable by user, only error message.
• "decimal places", places the n number of 0 after the "."(dot) in gn:s_decimalFormat="0.00". Default is 2. This can not exceed total allowed size of decimal number of 15, add to configuration.xml:

<columnNumber>
    <decimalPlaces>null|>=0|<=13</decimalPlaces>
</columnNumber>

ACTION

• "dropdown items", ${dropdownItemsList} = ${<item>${dropdownListItem}</item>} - repeats to how many dropdown items were entered by user.
• ${dropdownListItem} - single "dropdown items" item entered by user. Only number input up to 15 digits is allowed, integer or decimal.

ACTION MESSAGES

• "no data", if $defaultApp resource ${$dropDownNoData}, if we override then it has to be formed {@string/${widgetID}NoData} - message which appears when user clicks on dropdown and no data is loaded into dropdown
• "no selection text", if $defaultApp resource ${$dropDownZeroItem}, if we override then it has to be formed ${@string/${widgetID}ZeroItem} - text which appears when dropdown is initially loaded and nothing is selected in it

DATABASE

• "is part of database", checkbox option by default is set as checked. When checked database column is created for this widget.
• "additional ginstr web column settings":

• "percentage %", add to configuration.xml:

<columnNumber>
    <percentage>true|false</percentage>
</columnNumber>

• "horizontal alignment", add to configuration.xml:

<columnNumber>
    <horizontalAlignment>left|center|right</horizontalAlignment>
</columnNumber>

• "list of allowed values", add to configuration.xml:

<columnNumber>
    <valuesList>
    <value>1</value>
    <value>2</value>
  </valuesList>
</columnNumber>

• "related unique columns", add to configuration.xml:

<columnNumber>
    <uniqueInsideList>
        <reference>
          <table>refTableId1</table>
          <column>refColumnField1</column>
        </reference>
        <reference>
          <table>refTableId2</table>
          <column>refColumnField2</column>
        </reference>
    </uniqueInsideList>
</columnNumber>

• "hidden ginstr web column settings":

• "number signs", for positive number add: "equalToZero" and "greaterThanZero", add to configuration.xml:

<numberSigns>
    <numberSign>lessThanZero</numberSign>
    <numberSign>equalToZero</numberSign>
    <numberSign>greaterThanZero</numberSign>
</numberSigns>

Code snippets

GBAM Code Variables

Variables which are used in code snippet below but not defined in user modifiable inputs.

• ${widgetID}

Common widget code

<com.ginstr.widgets.GnTextView        
	android:id="@+id/${widgetID}_label"
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	android:text="@string/${widgetID}"
	gn:style="@style/dropdownLocalNumber_label" />

<com.ginstr.widgets.GnDropDown
	android:id="@+id/${widgetID}_input"
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	gn:s_ZeroItemText="@string/${$dropDownZeroItem}"
	gn:msg_nodata="@string/${$dropDownNoData}" 
	gn:s_sourceType="local"
        gn:dataType="number"
	gn:data_source_key_local="@array/${widgetID}"
	gn:act_afterLoad="[gn:act_fill_dropdown]|[@+id/${widgetID}_input]"
	gn:style="@style/dropdownLocalNumber_input"/>

strings.xml

Lines to be added for each language.

<string name="${widgetID}">${widgetLabel}</string>

arrays.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
	<string-array name="${widgetID}">
		${dropdownItemsList}
	</string-array>
</resources>