Line 14: | Line 14: | ||
Back to [[ginstr_app_composer_reference#Widgets_table|GBAM widgets table]] | Back to [[ginstr_app_composer_reference#Widgets_table|GBAM widgets table]] | ||
+ | |||
+ | == Datatypes == | ||
+ | |||
+ | Value is stored from widget to database as [[:Category:Datatypes#text|<code>text</code>]] datatype. | ||
== Predefined user data == | == Predefined user data == | ||
Line 27: | Line 31: | ||
=====VALIDATIONS===== | =====VALIDATIONS===== | ||
− | * "required", [[RequiredValidator]] | + | * "required", [[RequiredValidator]], add to configuration.xml: |
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText required="true|false"></columnText> | ||
+ | </syntaxhighlight> | ||
+ | * "max length", [[TextValidator#maxLength]], add to configuration.xml: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText> | ||
+ | <len>null|>=0|<=10000</len> | ||
+ | </columnText> | ||
+ | </syntaxhighlight> | ||
+ | * "unique", check uniqueness when widget gets saved into db, having "is part of database" checked, add to configuration.xml: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText unique="true|false"></columnText> | ||
+ | </syntaxhighlight> | ||
+ | |||
=====ACTION===== | =====ACTION===== | ||
Line 34: | Line 52: | ||
======ACTION MESSAGES====== | ======ACTION MESSAGES====== | ||
* - | * - | ||
+ | |||
+ | =====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": | ||
+ | :* "align text", radio button options with values: "left", "middle", "right", add to configuration.xml: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText> | ||
+ | <horizontalAlignment>left|center|right</horizontalAlignment> | ||
+ | </columnText> | ||
+ | </syntaxhighlight> | ||
+ | :* "list of allowed values" array with list of allowed values, add to configuration.xml: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText> | ||
+ | <valuesList> | ||
+ | <value>val1</value> | ||
+ | <value>val2</value> | ||
+ | </valuesList> | ||
+ | </columnText> | ||
+ | </syntaxhighlight> | ||
+ | :* "pattern", add to configuration.xml: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText> | ||
+ | <pattern errorMessage="invalidTextTableValue">[0-9A-Z]{3}</pattern> | ||
+ | </columnText> | ||
+ | </syntaxhighlight> | ||
+ | :* "related unique columns", add to configuration.xml: | ||
+ | <syntaxhighlight lang="xml"> | ||
+ | <columnText> | ||
+ | <uniqueInsideList> | ||
+ | <reference> | ||
+ | <table>refTableId1</table> | ||
+ | <column>refColumnField1</column> | ||
+ | </reference> | ||
+ | <reference> | ||
+ | <table>refTableId2</table> | ||
+ | <column>refColumnField2</column> | ||
+ | </reference> | ||
+ | </uniqueInsideList> | ||
+ | </columnText> | ||
+ | </syntaxhighlight> | ||
== Code snippets == | == Code snippets == |
Revision as of 13:15, 5 June 2017
Widget obtains gps coordinates from gps module. After location is retrieved nominatim server is contacted to fetch the address and address is stored into the widget. Widget is hidden.
Widget id, ${gbamID}
:
auditAddress
Back to GBAM widgets table
Datatypes
Value is stored from widget to database as text
datatype.
Predefined user data
PreLoaded
Properties panel
User will configure this data in properties panels of selected widget:
GENERAL
- "label",
${widgetLabel}
VALIDATIONS
- "required", RequiredValidator, add to configuration.xml:
<columnText required="true|false"></columnText>
- "max length", TextValidator#maxLength, add to configuration.xml:
<columnText> <len>null|>=0|<=10000</len> </columnText>
- "unique", check uniqueness when widget gets saved into db, having "is part of database" checked, add to configuration.xml:
<columnText unique="true|false"></columnText>
ACTION
- -
ACTION MESSAGES
- -
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":
- "align text", radio button options with values: "left", "middle", "right", add to configuration.xml:
<columnText> <horizontalAlignment>left|center|right</horizontalAlignment> </columnText>
- "list of allowed values" array with list of allowed values, add to configuration.xml:
<columnText> <valuesList> <value>val1</value> <value>val2</value> </valuesList> </columnText>
- "pattern", add to configuration.xml:
<columnText> <pattern errorMessage="invalidTextTableValue">[0-9A-Z]{3}</pattern> </columnText>
- "related unique columns", add to configuration.xml:
<columnText> <uniqueInsideList> <reference> <table>refTableId1</table> <column>refColumnField1</column> </reference> <reference> <table>refTableId2</table> <column>refColumnField2</column> </reference> </uniqueInsideList> </columnText>
Code snippets
GBAM Code Variables
Variables which are used in code snippet below but not defined in user modifiable inputs.
Common widget code
<com.ginstr.widgets.GnEditText android:id="@+id/${widgetID}_input" android:layout_width="match_parent" android:layout_height="wrap_content" gn:s_sourceType="gps" gn:dataType="text" gn:visible="false" gn:showAddress="true" />