Use this tab to define basic data for the field.

Field Name - Displays or requests a name for the field. Required input for all types of Custom Element fields. For new fields, click the orange arrow to automatically copy the field name to the Label field, or enter a different name for the field label.

Type - Select a field type from the dropdown. CommonSpot supports over two dozen different field types out-of-the-box. These factory fields display in normal text. You can also build your own custom field types, which are highlighted as shown below. To create new fields, choose Add New Field in Custom Element Field Definitions and other dialogs for creating or editing fields.

Your selection here determines which options display for Other Properties. For specifics on defining properties for each field type, see CommonSpot Field Types.

• Label - The label, not the field name, is presented to the user indicating the data required. It may be the same as the field name. Required for all form field types.
• Shared - If the field is marked as shared, it is shared across all of its references. For example, if the field is a dropdown list and you add new members, all occurrences of the field will be updated to display all new items.
• Required - Fields can be marked as required and/or shared. Fields marked as required are mandatory. Incomplete required fields prompt the user to enter a value before continuing.
• Description - Enter helpful information for the field, or leave blank if no description is necessary. The description appears under each field to help users understand what type of data should be placed into the field.

The field parameters on this tab are specific to the field type selected in the Standard Properties tab. The following shows properties for a Selection List field.

The following types may display on the Other Properties tab:

Maximum Length: Determines the number of characters allowed per field. Requires input for all types of Custom Element fields except for the following types: Check Box, Image, Tree Control, Formatted Text Block, and Date.

Size: The size determines the display size for the field. Required input for the following types only: Text, Selection List, URL, and Email.

Cookie Field: This option is available for Custom Element form fields, simple forms, and metadata forms. It enables pre-populating fields from cookie values. Use this feature to auto-complete forms containing fields completed in other forms. For example, once a user enters name, city, state, etc. in one form, fields requesting these values are prepopulated in the next form. You can use this feature for Text, Selection List, Multi-checkbox, Checkbox, Email, and Radio Button fields.

Default Value: The default value, if entered, is the value that is populated and presented directly in the Custom Element. The field only displays a default value or will be left blank and the user cannot update or change the value. This option is available for input for all types of Custom Element fields except for Checkbox, Image, Tree Control, Formatted Text Block, and Date.

The following fields may also display.

• Checkbox List Source - Applies for Multiple Checkboxes. Values to display in the list can be: Value List, Custom Query, CommonSpot User Groups, a ColdFusion expression, or Custom Element/metadata or simple form data. If Value List is selected, you will need to type in the appropriate list of values in the "Option List" field.
• Option List Source - Applies for a Selection List field type. Values can be: Value List, Custom Query, CommonSpot User Groups, a ColdFusion expression, or Custom Element/metadata or simple form data. If Value List is selected, you will need to enter the appropriate list item values in the Option List field. Selecting Value List, Custom Query, or ColdFusion expression for the Option List Source, gives you the option of including an "Other" field for free-form text entry when none of the standard selection list items apply.
• Radio Button List Source - Applies for a Radio Button. Values to display in the list can be: Value List, Custom Query, CommonSpot User Groups, a ColdFusion expression, or Custom Element/metadata or simple form data. If Value List is selected, you will need to type in the appropriate list of values in the "Option List" field.
• Option List - Enter a comma-delimited list of the options you want to include in the dropdown list. Required input for Multiple Checkboxes, Radio Button, and Selection List.
• Select Option - Places a --Select-- option in the list and makes the field required. Cannot be used with a multiple selection drop-down list.
• Columns - Determines the width of control box. Limited overall by Maximum Length parameter above. Requires input for Small Text Area and Large Text Area types only.
• Rows - Determines the height of control box. Limited overall by Maximum Length parameter. Requires input for Small Text Area and Large Text Area types only.
• Value - The value to be entered into the database if box is checked.
• Dynamic Data - The option displays when you select Custom Element/Metadata Form/Simple Form Data for selection field types. Click this option to display and select from the set of fields available. See also Query By Example Source in the Elements Reference.

The Security tab defines the field-level permissions. Use this tab to assign users and groups specific rights to the field and its data.

Check Use Explicit Security to restrict editing access to this field, then click the Edit Security Settings button to modify security settings for the field. The Field Security dialog displays for selectively assigning individual users or groups field-level permissions. Click the edit icon to change permissions through the Edit Field Security Permissions dialog.

 

After custom security has been added to a form field it will have a Red key icon on the Custom Element Field Definitions dialog to indicate there is custom permission on the field.