Templates

If a Segment contains data, actions or is linked to a data object (i.e. a selection, button, etc) then the structure is controlled by a Template. Templates are specified as either Single Entity templates or Multiple Entity Templates. For each template you need to specify a name and a base Entity type or use one of multiple, temporary, unbound-data areas available on each page.
Templates are made up of a many Properties, from the base Entitiy, or temporary unbound data areas as you wish.
Each Property must have an Editor Type, a definition of the display widget ("Widget") that will define the display function. Widgets can be simple i.e. display Property data value or can call device fatures i.e. the device datapicker, they can incorporate image uploading and any other screen function that you may require. This is the list of Widgets available to use within Evoke
Widget definitions for Property
For each Template you are also able to specifiy the following:
  • Widget id - Chosen name of the widget (this data/functional element of the user interface) that is used in the Visual Studio project to identify it

  • Tooltip - a simple help expression that the user sees when hovering over the widget

  • Editor Type - the definition of the display Widget that will define the display function.

  • Prompt text - (single entity only) the prompt for what is to be input, e.g. "Name", "address", etc

  • Alt Prompt text - (single entity only) the alternate prompt used by Adapations for what is to be input, e.g. "Nm.", Add." etc

  • Supress Prompt Padding - (single entity only) used to supress the data fields lining up in line with the largest prompt

  • Tab Index - (single entity only) used to identify the next input or display box to jump to when the user presses the tab key on the keyboard

  • Column header Text - (multi entity data grids only) the column header for this specific column, e.g. "Name", "address", etc

  • Alternate header Text - (multi entity data grids only) the alternate column header used by Adapations for this specific column, e.g. "Nm.", Add." etc

  • Column size (%) - (multi entity data grids only) used to define the size of this specific column as a percentage of the data grid width

  • Column size max (px) - (multi entity data grids only) used to define the maximum size, in pixels, this specific column can grow to in the User Interface

  • Column alignment - (multi entity data grids only) used to define the alignemnt of the column, the options are:

    • Left - values will be aligned along the left edge of the column

    • Center - values will be aligned centrally within the column

    • Right - values will be aligned along the right edge of the column

  • Access Control - by data or user group for each property

  • Functionality Actions - use of Evoke's Click Actions

General Settings
Each Template also has "General Settings" associated with it. These are different for Single Entity templates and Multi-Entity Templates. The settings are as follow.
  • Single Entity Templates

    • Default Prompt Position - where the "Prompt" is displayed, options are above or left

    • Template Level Click Actions - the Evoke Click Actions associated and used by this template. These are used in conjunction with header actions.

  • Multi Entity Templates (shown right)

    • Show Column Headers (checkbox) - if a row showing the headers for columns is shown at the top of the grid (under a heading bar - if present)

    • Show Column Footers (checkbox) - if a row showing the footers (totals boxes) for columns is shown at the botton of the grid

    • Column Sort Enabled (checkbox) - if Evoke automatic sort options are to be available to the App user. Used in conjunction with Refined Data Sources

    • Column Filter Enabled (checkbox) - if Evoke automatic Search/Filter options are to be available to the App user. Used in conjunction with Refined Data Sources

    • Show data paging bar (checkbox) - displays the data paging bar on the grid for the user to use Data Paging functions, if they are set on the Data Source

    • Row height - defines the row height of the rows in the data grid. The default is a single line row height of 36px. Alternative options include 8 additional heights from 76 pixels through 356 pixels.

    • Actions on row click/tap - the Evoke Click Actions associated and used by this template

    • Select first row on load (checkbox) - Determines, when data is loaded into the data grid, if the first row should become the selected row or not. This checkbox is reguarly used when the page contains other data segments showing related data.

    • Row display restriction style - used to which rows are shown in the data grid. Options are:

      • None (all selected rows are displayed)

      • First Rows (Only the first n selected rows are displayed - used in conjunction with the row display restriction option below)

      • Last Rows (Only the last n selected rows are displayed - used in conjunction with the row display restriction option below)

    • Row display restriction size - used to limit the number of rows shown in the data grid.


.