Custom Field Type: Lookup – External People

From SmartWiki
Revision as of 09:37, 18 February 2016 by Alvin Thompson (talk | contribs)

Jump to: navigation, search
Click here to peruse our selection of custom fields.

General Description

User is able to look up external people and store the names (multiple select). The resulting data is read only and not linked to the underlying entity.

Field Display

Field in Edit Mode

Cf37.png

Lookup Pop-up window for locating people

Cf38.png

Completed Field

Cf39.png

Note: Only the name of the selected entity is stored. It is not linked to the underlying object.	

Field Options

Option Description Format
Custom Field ID The unique ID number associated with the custom field. Not Applicable
Field Type The list of available Field Types. @fieldtype@
Field Name The name of the field, used internally to reference the user's input; @fieldname@
Caption  The leading question or prologue before the field. @caption@
Display Order  The order (relative to other fields) in which this field is displayed. @displayorder@
Description Definition and general description of the custom field. Will not be displayed. @description@
  • Role IDs - The lookup can be constrained to specific Roles in the system by entering roleids, multiple roleids are separated by commas.
  • Button Label: Text to be displayed on the field's button. If no text is entered, the system will use a default label.
  • Tool Tip: When the user hovers their mouse pointer over the caption of a field, the text in this section will appear.
  • On New Record: Controls how the field should be displayed until record has been saved once.
    • Always Display: Field will be exposed both before and after the record is saved.
    • Hide on New Record: Field will be hidden until record is saved.
    • Only Show on New Record: Field will be exposed until record is saved, and then it will be hidden. This option is useful for fields that provide instructions for filling out forms before saving.
  • SmartField View - Include or exclude this field from SmartField Views (@SmartFields@) or only display this field for SmartField Views. See SmartField View for further details.

Options

General Options

  • Mandatory: Selecting this option means that this field is required and must be completed.
  • Appear Mandatory: Makes the field appear as though it is a required field. Typically used in conjunction with browser scripts, JavaScript Validation or Submit Logic that perform validation.
  • Searchable: This field can be searched within the tracking application.
  • Track Changes: Keeps track of changes made to this field.
  • Enable Server-Side Validation - See Server-Side Validation page for details.

Enable KML: Used to upload a KML file which is used to display geographic data on a map.

  • Enable Multiple Select: Enables users to select multiple values from the listed values.
  • Disable Quick Edit: Disables this field from being selectable in Quick Edit on a List View.
  • Enable Map Service: Enables the map icon Ps10.jpg that will launch the user’s selected map service (configured in Personal Settings) and display a map of the content of the field.

Formatting

  • Caption Style: Add caption styling by including HTML style tags around @value@
  • Width: Enables the user to set the width of the Lookup field in pixels
  • Custom HTML Tag: Use this field for additional attributes to the field HTML tag.

Value Storage

  • Value Storage: Enables linking two different custom fields to the same user data. See Value Stores To page.

Permissions & Availability Tab

Note

  • This field stores the name of the selected contact only. It is not possible to refer to details of the selected contact such as address, userid, e-mail etc.