Create New Form

Table of Contents

Overview

Form Considerations

Forms are the foundation of your ShareVision site. Forms should be designed to satisfy requirements of your agency and capture data necessary to your success. It is a good idea to become familiar with the forms that are already in place to determine if they meet your needs. These existing forms can be modified as may be required or hidden and not used at all.

• Forms should be as simple as possible while extracting the required information in the correct format

• Data should only be entered in one place

• Headings can be used to break a form into related sections to make it more readable

• Field type "Information" and "Help Text", found within each field's attributes, can be used to provide a descriptive details of what users should be entering into a specific field

Getting Started

Start with a simple form at first.
Have a printed copy or similar example of the form you want to create.
Consider whether any of the data in the form already exists elsewhere in ShareVision and doesn't need to be in this form.
Consider naming conventions and use the same name for throughout the site. For example, people who receive services are named clients by default. If that name works for you, then use it consistently.
Consider if the form needs any headers to break it into sections. Think of a name for each header.
Consider if the form needs any information fields or help text included with any fields.
The form fields can be edited and modified.

Requirements/Dependencies

• Login with Site Administrator permissions.

 Instructions

The instructions for how to create a form are quite simple. The tricky part is considering which fields to add and how to adjust the options to suit your needs.

Below are the steps for how to create a form followed by detailed information about each field type.

Steps to create a form

1. Click on your name in the upper right hand corner of your ShareVision site.

2. On the menu that appears, select Site Administration.

3. The Site Administration Home page will be displayed. Select Forms under Site Content.
   
   

   Open

   

   
   The page loads existing forms grouped by ShareVision Forms and User Forms.

4. Click on Create new form
   
   

   Open

   

5. Enter a name for the form. Form names should be short and descriptive. i.e. Client Risk Assessment

6. Form type defaults to list. There are 2 form types, lists and announcements.
   
   

   
   List is the form type that will be used to capture your data and will be the one you use most.
   Announcement is a special type of form that is used for capturing short term notifications.
   
   

   
   Accept the default form type of list.

7. Description allows you to add internal notes about the form. These notes appear on the forms page and can provide a reminder of the purpose of the form or other details that are pertinent to note.

8. Add fields to the form by clicking or dragging a field found on the right side of the page into the area on the left side.

9. Consider the options in each field as they are added and adjust as desired. (details about each field are listed below)

10. Change the order of fields by clicking on a field and dragging it into a different position.
    
    

11. When all fields are added click Save.

12. Click View Form Submissions. The page that loads will show any data entered. From this page click Create a new form submission in order to review your form.

13. Review the form and then click Cancel (do not save the form) or Save (save the form).

14. If changes to the form are needed click on Edit This Form to continue adjusting the form.

15. To edit an existing field, mouse over the field to access the field menu which has 3 options:
    1. Delete
    2. Edit
    3. Copy
    
    

16. Select Edit to make changes. Then move to the next field. When done click Save.
    
    

ShareVision Fields

Field: Client

Type: Filtered Lookup. Filters the names of clients from the Contact Information Form.

Purpose: Used to track data that relates to a client (or clients)

1. Required: If checked, the record cannot be saved unless data is entered in this field

2. Label: The name of the field as it appears in the form. Client is used throughout the site and the label should only be changed if using another term for client.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form.

5. Form: Contact Information - cannot be edited.

6. Form Version: Client - cannot be edited.

7. Form Field: Person - cannot be edited.

8. Allow Multiple: allows for the selection of multiple names in a single form.

9. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

10. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Client Contact

Type: Filtered Lookup. Filters the names of Contacts from the Contact Information Form based on the selected Form Version and limits the names to those that have a relationship with the Client selected in the form.

Purpose: To allow for the selection of names of those who have a relationship to the Client. Used in conjunction with the Client field, which must be included as a field in the same form.

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form. Should be changed if not clear to users.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder:

5. Form: Contact Information - cannot be edited.

6. Form Version: Select the Form Version of your choice:

   1. All Form Versions - will show all possible names of people with a relationship to the client

   2. Client - will only show names of contacts who are Clients with a relationship to the client

   3. Professional - will only show names of contacts who are Professionals with a relationship to the client

   4. General - will only show names of contacts who are General Contacts with a relationship to the client

7. Form Field: Person - cannot be edited.

8. Allow Multiple: allows for the selection of multiple names in a single form.

9. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

10. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Contact

Type: Filtered Lookup. Filters the names of all General Contacts from the Contact Information form.

Purpose: To allow the selection of names of people added to ShareVision who are general contacts.

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form. Should be changed if not clear to users.

3. Help Text: Choose a contact from all general contacts (text can be updated)

4. Placeholder: Text will display as a prompt for the person filling in the form.

5. Form: Contact Information - cannot be edited.

6. Form Version: General - cannot be edited.

7. Form Field: Person - cannot be edited.

8. Allow Multiple: allows for the selection of multiple names in a single form.

9. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

10. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Email

Purpose: Captures email data and ensures it is properly formatted.

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Default Value: Entered text becomes the default data in the field and can be typed over.

6. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

7. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Phone Number

Purpose: Captures phone number data and ensures it is properly formatted to what is chosen in Application Settings - General

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Default Value: Should be left empty. Entered text becomes the default data in the field and can be typed over.

6. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

7. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.. See insert

Field: Photo Uploader

Purpose: Used to add photos (images) to a form

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Image Size: Defaults to Medium (400x400); can be changed to Small (200x200), Large (800x800) or X-Large (1080x1080). List grids will display images as a thumbnail.

5. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

6. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.. See insert

Field: Professional

Type: Filtered Lookup. Filters the names of all Contacts with the form version Professional.

Purpose: To allow the selection of names of professional people added to ShareVision.

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form.

5. Form: Contact Information - cannot be edited.

6. Form Version: Professional - cannot be edited.

7. Form Field: Person - cannot be edited.

8. Allow Multiple: allows for the selection of multiple names in a single form.

9. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

10. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Province

Type: Radio Group - Only one selection is allowed. Highlighted option is the default value.

Purpose: Automate the adding of province to a form.

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: The name of the field as it appears in the form.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Placeholder has be set to “Select an Option”. That text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Options: The choices that are available in the form. Only one choice is allowed in this type of field. One choice can be set as the default value.

6. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

7. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Service

Type: Filtered Lookup. Filters the names of services from the Services Form.

Purpose: Used to track data that relates to a service.

1. Required: If checked, the record cannot be saved unless data is entered in this field

2. Label: The name of the field as it appears in the form. Service is used throughout the site and the label should only be changed if using another term for service

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form.

5. Form: Services - cannot be edited.

6. Form Version: All form versions - cannot be edited.

7. Form Field: Service Name - cannot be edited.

8. Allow Multiple: allows for the selection of multiple services in a single form.

9. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

10. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Basic Input Fields

Field: Single Line of Text

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Default Value: Entered text becomes the default data in the field and can be typed over.

6. Max Length: 255 characters

7. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

8. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Multi Line Text

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Default Value: Entered text becomes the default data in the field and can be typed over.

6. Max Length: Limits the number of characters that can be typed in.

7. Rows: Defaults to 4. Sets the size of the text box available in the edit form by the selected number of rows. When empty no row limit is set and the text box can be expanded by the user.

8. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

9. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Rich Text Box

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Default Value: Entered text becomes the default data in the field and can be typed over.

6. Rows: Defaults to 4. Sets the size of the text box available in the edit form by the selected number of rows. When empty no row limit is set and the text box can be expanded by the user.

7. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

8. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Link

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Default Value: Entered text will display in the field of the form to be typed over. This field would normally be left empty.

5. Open In A New Tab: Sets the link to open in a new tab.

6. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

7. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Number

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Text will display as a prompt for the person filling in the form. Default Value field will trump this field if it is being used.

5. Default Value: Entered text becomes the default data in the field and can be typed over.

6. Show as Currency: When ticked the currency symbol is added to the entered value.

   1. Min: Sets the minimum value that can be entered. If empty no minimum is set.

   2. Max: Sets the maximum value that can be entered. If empty no maximum is set.

   3. Increment By: When a number is selected it forces the value entered to be incremental by that number. i.e. increments of 2 would force data to be, 2, 4, 6, 8 etc. A value of 7 would not be possible. When left empty no increment is set.

   4. Number of Places: Sets the number of decimal places desired. Default to 0. Currency should be set to 2.

7. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

8. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Date & time Fields

Field: Date and Time

1. Required: If checked, the record cannot be saved unless a date is entered in this field.

2. Type: Allow user to select columns display type. Choose from Date Only, Time Only. Date and Time

3. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

4. Help Text: Entered text will appear in a pop-up next to the label.

5. Default Today: If checked, the date and time is automatically set to today/now when a new form is added.

6. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

7. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Age

1. Label: Is set to “Age”. Can be renamed.

2. Help Text: Entered text will appear in a pop-up next to the label.

3. Date of Birth Field: Allows the user to select the date field to be used in the age calculation.

4. Show Age in: Allows the user to select the format of the age. Choose from Years, Years and Months, Months, Weeks, Days.

5. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

6. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Choice & Reference Fields

Field: Drop Down List

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Placeholder has be set to “Select an Option”. That text will display as a prompt for the person filling in the form.

5. Options: Options are the list of choices. Rename Options 1, 2 and 3 to names of your choice. Add additional options by clicking Add Option. Remove options by clicking on the red X.
   The option that is highlighted will automatically be selected. Text entered in Placeholder can be used to help the user choose the appropriate choice.

6. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

7. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Yes/No

1. Required: If checked, the record cannot be saved unless the value is changed. (Can be used to force agreement; the record can only be saved if the default value of “No” is changed to “Yes”.)'

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Default Value: Must be set to either Yes or No. This type of field always has data on saving a record.

5. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

6. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Radio Group

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Inline: When checked, the choices are display in a horizontal line instead of in a vertical column.

5. Enable "Other": When checked allows users to enter an unlisted option. A text box opens to allow typed in text.

6. Options: Options are the list of choices. Rename Options 1, 2 and 3 to names of your choice. Add additional options by clicking Add Option. Remove options by clicking on the red X.

7. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

Field: Checkbox Group

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Toggle: Replaces a check box with slider.

5. Inline: When checked, the choices are display in a horizontal line instead of in a vertical column.

6. Enable "Other": When checked allows users to enter an unlisted option. A text box opens to allow typed in text.

7. Options: Options are the list of choices. Rename Options 1. Add additional options by clicking Add Option. Remove options by clicking on the red X.
   When option items are ticked, they will automatically be selected when a new item is added. Untick the box to reverse that action.

8. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

Field: User (Employee)

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Role Filter: Limits the selection of users to those who are in the role selected. “Show all users” includes all active users. Leave the default setting or select a role that limits what users can be selected.

5. Select Current User: When checked the form will automatically fill in the name of the logged in user filling in the form. Role Filter should be set to “Show all users”.

6. Allow Multiple: Allows for more than one user to be selected.

7. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

8. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Lookup Values

1. Required: If checked, the record cannot be saved unless data is entered in this field.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Placeholder: Placeholder has be set to “Select an Option”. That text will display as a prompt for the person filling in the form.

5. Form: Select a Form to pull data from.

6. Form Version: Select a form Version. Most lists have only one form version. If more than one, select the appropriate version.

7. Form Field: Select a form field. This is the field that the data will be looking up to.

8. Allow Multiple: Allows for the selection of multiple choices when ticked.

9. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

10. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.. See insert .

Form Structure & Information

Field: Heading

1. Label: Rename "Heading" to something that describes the purpose of the form or this section of the form. The Heading text changes in real time.

2. Type: Pick the heading size, with h1 being the largest size. The heading changes on the page as you make adjustments.

3. Background Colour: Set a background colour by picking a colour or adjusting colour values. Available values: RGB, HSL or HEX. Text colour will adjust from back to white depending upon the background colour selected.

4. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

Field: Information

1. Content: Replace the text "Information" with instructions or information of your choice. This is a place for helpful content that is read-only to users filling in a form. The field is not available for users to add or edit content.

2. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

Field: File Uploader

1. Required: If checked, the record cannot be saved unless a file is uploaded.

2. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

3. Help Text: Entered text will appear in a pop-up next to the label.

4. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

5. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Signature

1. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

2. Help Text: Entered text will appear in a pop-up next to the label.

3. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

4. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field Content Display Field

1. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

2. Hide Label:

3. Rows:

4. Content:

5. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

6. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Survey & Evaluation Fields

Field: Linear Scale

1. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

2. Help Text: Entered text will appear in a pop-up next to the label.

3. Starting Number:

4. Ending Number:

5. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

6. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Checkbox Grid

1. Label: Displays text by default. Rename label to something brief that describes the purpose of the field.

2. Help Text: Entered text will appear in a pop-up next to the label.

3. Rows:

4. Columns:

5. Field Security Settings: This section allows the site administrator to select which roles can see the field when viewing a form, see and update a the field on a new form or see and update a field when editing a form.

6. Advanced Settings: Same for all fields. See Advanced Settings at the bottom of this article.

Field: Multiple Choice Grid

Removed/Other Fields

Fields that have been removed from this form are listed in this section. A field can be restored to the form by dragging and dropping.

• Data that existed before the field was removed is preserved in the state that existed on the date it was removed.

 Related articles