View source for Forms

'''Designer > Presentation > Forms > {object} > {form}'''
__NUMBEREDHEADINGS__
A well-defined form makes data entry and inspection easier and faster.

==About Forms==

Forms define the [[Fields]] that are visible to users in different roles when a [[Record]] in an [[Object]] is viewed or edited. The fields in a form can be ordered and organized into sections. Labels, spacer lines, and horizontal dividers can be added to create logical groupings, and sections can be added for Quick Links and for related records (Related Information). 

The [[Elements Sidebar]] helps you to configure the layout for a Form.

;Considerations:
* Forms are associated with [[Objects]]
* Multiple forms can be created for an [[Object]]
* In addition to the standard forms, you can create your own custom [[Pages]] for viewing, adding, or updating a record, and select them for use in the object [[Properties]] section: [[Properties#Presentation Pages|Presentation Pages]].

{{permissions|Customize Objects|edit Forms}}

===Configuration Options===

These configuration buttons are available: 

:* [[#Edit a Form Layout|[Edit Layout] ]]
:* [[#For Developers: Form Scripting|[Edit Form Script] ]]
:* [[#Clone a Form|[Clone Layout] ]]
:* [[#Layout Rules|[Layout Rule] ]]

;Considerations:
:*When an Object is created, a Default Form is created
:*The Default Form cannot be deleted or renamed
:*When a user creates a new form layout, that user has full control over the design, and can add any combination of elements from a default list, or select from a list of existing elements

==Parts of a Form==
:* You work with elements in the form using the icons adjacent to each element.
:* You can add fields, sections, and other elements to the form using the controls at top left.

===Element Icons===
The element icons appear when the cursor hovers over an element in the form. Use the icons to edit the element, rearrange its position, add a script, or remove it from the form: 
:[[File:Icons_on_form_layout_fields.gif|border]]

;Considerations:
:*The edit icon [[File:Editlayouticon.gif]] is not available for the built-in fields that are predefined for every object: Owner, date created, date modified, created by, modified by, object id, record id, and the workflow fields.
:*The scripting icon [[File:Script_icon.gif]] gives you the ability to specify JavaScript code to execute when <tt>On Change</tt> and <tt>On Focus</tt> events occur for that field. That option is only available for fields that have a "raw data" type like string or number.}}
:The field-reset icon [[File:ResetFieldsIcon.png]] appears in place of the scripting icon when <tt>On Change</tt> is the only event supported for the field.

===Elements===
The '''Elements''' section at top left contains things you can drag and drop into the form.

====Fields====
The first tab is '''Fields'''. 
It contains the object fields that can be put into the form.
:[[File:form_layout_fields.gif|border]]

To add a field to the form, drag it from the field list and drop it into place.

To edit field attributes, click the edit icon next to the field. [[File:Editlayouticon.gif]]

:;Common Field Attributes:
::The list of attributes depends on the type of field. Here are the common attributes:
::* '''Field Label -''' The label displayed in the GUI for this field, in all forms.
::* '''Display Label -''' The label displayed in the GUI for this field, in this form.
::* '''Display Attribute:''' 
:::* '''None -''' The default.
:::* '''Required -''' A value for this field is required in this form, even if the Basic Information for the Field itself does not specify it as [[Fields#Basic Information|Always Required]].
:::* '''Read Only -''' The field can be viewed, but not modified.
::::'''Note:''' If the field is defined as [[Fields#Basic Information|Always Required]], and it is specified as Read Only here, then this form cannot be used to add new records, unless the field has a [[Fields#Default Value|Default Value]].
:::* '''Hidden -''' The field is not displayed to the user. (Can be used for fields with intermediate calculations or values that depend on other selections.)
::* '''Field Hint -''' A field to display in this form, overriding the hint specified in the [[Field]] definition.
:::(This area only displays when a hint has been defined for the Field.)

:;Special Field Attributes:
::{| border="1" cellpadding="5" cellspacing="1" 
! Field Type !! Attributes
|-
| <span id="lookup">[[Lookup]]</span> ||
* Lookup Display Type - A Popup window or a Drop Down display.
* Lookup Type - For a Popup display, the choices are a Standard Lookup or a Custom Page of your own design. (For a Drop Down, the choice is fixed.)
* Sort By - The field on which to sort the list of options presented to the user.
* Sort Order - Ascending or Descending.
|}

====Form Controls====
The second tab is '''Form Controls'''.
:{| border="1" cellpadding="5" cellspacing="1" 
|-
|rowspan="5"|[[File:form_layout_controls.gif|border]]
|Spacer
|Add horizontal space between elements in a form.
:* '''Field Label:''' The name of the element.

|-
|Label
|Add a label to a form.
:* '''Field Label:''' The name of the element.
:* '''Content:''' The text (and optional inline HTML) that will appear when the form is displayed.

|-
|Horizontal Line||Add a dividing line between elements in a form.
:* '''Field Label:''' The name of the element.

|-
|[[Section]]
|
Sections divide areas in a [[Form]] for improved readability and organization
:*Sections have a default setting to open expanded or collapsed
:*Fields in sections can be hidden in a View, if the field contains no data
:*Within a section, images can be displayed in the header, footer, left or right margins 

|-
|[[Quick Link]]
|
A Quick Link provides the ability to pass a value from a record to a website URL.
:*For example, add a Google News lookup to an Account, or add a Facebook lookup to a Contact 
|}

=== New Section Constructors ===
Underneath the Elements section, there are two links you can use to create additional sections in the form, either of which can be used to display related records from another object.

:{| border="1" cellpadding="5" cellspacing="1"
|-
|New [[Subform]]
|
*Displays as a table or spreadsheet within a record
*During data entry, multiple records can be added in a Subform 
*For example, the Orders object can contain a Subform that lists the OrderItems
*When entering an order, multiple items can be added at the same time

|-
|New [[Related Information]] section
|
*A Related Information section is created by default in all [[Object]]s
*Use this link to create (optional) additional Related Information Sections.
*During data entry, you add related records one at a time by clicking the '''[Add]''' button.
*When displaying a Customer object, for example, you might use the Related Information section to display past orders, and use the '''[Add]''' button to create a new one.
|}

The prerequisite for either of these sections is the existence of a [[Lookup]] relationship that defines a one-to-many relationship. For example, since there is a Lookup from Orders to Customers, the Customer object can define a Related Information section to display a history of Customer orders. 

:''Learn more:'' [[Object Relationships]]

==Working with Forms==
{{:Working with Forms}}

==Working with Form Sections==
{{:Working with Form Sections}}

==Layout Rules==
{{:Layout Rules}}

== Form Scripting ==
{{:Form Scripting}}

== Field Scripting ==
{{:Field Scripting}}
<noinclude>

[[Category:Presentation | 1]]
[[Category:Objects| 2]]
[[Category:{{features}}]]
[[Category:Glossary]]
</noinclude>