====== Sort ======

The sort field is used to create an interface through which an application developer can organize a list of [[Record|records]] by the values of one or more fields.
===== How to Create - Method 1 =====
  - Click the {{:presentation-layer:field-plus.png|}} to add a field in your [[Form|form]].
  - Choose "New Field"
  - Select the table you wish to add the field to. Most of the time, this will be the current [[Table|table]] you are on, called the current [[Context|context]].
  - Select a field name and click "Choose Type".
  - Choose "Sort" from the list of field types.
  - You can continue adding fields or click the "Select" button to finish adding.

===== How to Create - Method 2 =====
This field is able to be placed on a page itself, not as part of a table's records.

==== Adding the Field ====
  - Click the "Fields" button in the left toolbar to expand the list of fields available. {{ :expand_fields.png?nolink&200 |}}
  - Click on "Sort", holding the mouse button down and dragging the sort field onto the page, releasing over the grey shadow where the field will be placed. {{ :sort_drop.png?nolink&1000 |}}
  - Select a variant to use and click "save".  You can always change this later.{{ :sort_variants.png?nolink&1000 |}}
  - The sort field will appear on the page in the location specified.

==== Accessing the Features ====
When hovering the mouse over the field, an icon containing a blue pencil over a sheet of paper will appear in the top left corner of the field.  Click this icon to access the field features as listed above.
{{ :sort_edit.png?nolink&500 |}}


===== Features =====
Field features can be edited by clicking on the orange field icon {{:type-24.png|}} when the [[Presentation Layer|presentation layer]] is displayed. 

==== Field Label ====
  * [[Field Setting - Field Label|Field Label]]
  * [[Field Setting - Display Alternate Label]] (affects this form only)

==== Grid Appearance ====

  * [[Field Setting - Column Span|Column Span]]
  * [[Field Setting - Row Span|Row Span]]

==== Tooltip ====
  * [[Field Setting - Tooltip|Tooltip]]
  * [[Field Setting - Descriptive Text|Descriptive Text]]
  * [[Field Setting - Display Alternate Descriptive Text|Display Alternate Descriptive Text]] (affects this form only)

==== Block Association ====
  * [[Field Setting - Temporary Block Association|Temporary Block Association]]
  * [[Field Setting - Global Block Association|Global Block Association]]

==== Default Value ====
  * [[Field Setting - Default Value|Default Value]]
 
==== Validation ====
   * [[Field Setting - Required|Required]]

==== Audit History ====
  * [[Field Setting - Audit This Field|Audit This Field]] 
  * [[Field Setting - Show Audit History|Show Audit History]]

==== View Only ====
  * [[Field Setting - View Only|View Only]]

==== Sort Options ====
  * [[Field Setting - Purpose|Purpose]]
  * [[Field Setting - Form ID|Form ID]]
  * [[Field Setting - Variant|Variant]]
  * [[Field Setting - Sorts|Sorts]]

===== Variants Available =====
This field has nine variants that can be chosen from.

|< 80% >|
^Name^Availability^Label Placement ^
|Single Selection Sort with a label on the top|Single|Top|
|Single Selection Sort with a label to the left|Single|Left|
|Single Selection Sort with out a label|Single|None|
|Multiple Selection Sort with a label on the top|Multiple|Top|
|Multiple Selection Sort with a label to the left|Multiple|Left|
|Multiple Selection Sort with out a label|Multiple|None|
|Radio Buttons with a label on the top|Single|Top|
|Radio Buttons with a label to the left|Single|Left|
|Radio Buttons with out a label|Single|None|