====== Address ======

The address field is used for storing an address.  It can store three street address lines, a city, a state (or province/region), a postal code, and a country.

===== How to Create =====
  - 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 "Address" from the list of field types.
  - You can continue adding fields or click the "Select" button to finish adding.

===== Features =====

==== 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]]
 
==== Regionalization and Geolocation ====
  * [[Field Setting - Regionalization|Regionalization]]
  * [[Field Setting - Geolocation|Geolocation]]
==== Validation ====
   * [[Field Setting - Required|Required]]
   * [[Field Setting - Maximum Length|Maximum Length]] 


==== Data Security ====
  * [[Field Setting - Audit this Field|Audit this Field]]
  * [[Field Setting - View Only|View Only]]

===== Field parts =====
The address Field has up to 10 parts:
  * Street
  * Street 2
  * Street 3
  * City
  * State
  * Postal Code
  * Country
  * Address Type
  * Latitude (when Geolocation is enabled)
  * Longitude (when Geolocation is enabled)
===== Output formats (where applicable) =====
The address Field has twelve different output formats:

  * Full Field - This output format returns the Street portion of the address, then a newline character, then Street 2 of the Address, then a newline character, then Street 3 of the Address, then a newline character, then City, comma, space, State, space, Zip Code.
  * WX Stored Value - This output format returns the internally stored XML for the address Field.  Use this format when saving the entire address from one Field to another address Field, or when setting a default value for an address Field.  Whenever this format is used, the "Return results as" setting must be set to "HTML."
  * Address Type - this output format returns 'International' if the address is of the International format, and 'United States' if the address is of the United States format.
  * Street - This output format returns the Street part of the address Field.
  * Street 2 - This output format returns the Street 2 part of the address Field.
  * Street 3 - This output format returns the Street 3 part of the address Field.
  * City - This output format returns the City part of the address Field.
  * State - This output format returns the State part of the address Field.
  * Zip Code - This output format returns the Zip Code part of the address Field.
  * Country - This output format returns the Country part of the address Field.
  * Latitude - This output format returns the latitude of the address when geolocation is enabled otherwise it will return an empty string
  * Longitude - This output format returns the longitude of the address when geolocation is enabled otherwise it will return an empty string


===== Filters =====
The address field can be filtered using the [[Query Builder - Filter#Address Filters|address filters]].