Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Table of Contents
| 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 ShareVision Administrator permissions.
\uD83D\uDCD8 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
Click on your name in the upper right hand corner of your ShareVision site.
On the menu that appears, select Site Administration.
The Site Administration Home page will be displayed. Select Forms under Site Content.
The page loads existing forms grouped by ShareVision Forms and User Forms.Click on Create new form
Enter a name for the form. Form names should be short and descriptive. i.e. Client Risk Assessment
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.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.
Add fields to the form by double clicking or dragging a field found on the right side of the page into the area on the left side.
Consider the options in each field as they are added and adjust as desired. (details about each field are listed below)
Change the order of fields by clicking on a field and dragging it into a different position.
When all fields are added click Save.
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.
Review the form and then click Cancel (do not save the form) or Save (save the form).
If changes to the form are needed click on Edit This Form to continue adjusting the form.
To edit an existing field, mouse over the field to access the field menu which has 3 options:
Delete
Edit
CopySelect Edit to make changes. Then move to the next field. When done click Save.
| Info |
|---|
In order for forms to be accessible from the front end (what your staff see), a page part must be added to a page. Use the Add a Form to Portal tool or from Site Administration, Portal Settings, create a new page and page part. (See KB articles) |
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)
Required: If checked, the record cannot be saved unless data is entered in this field
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.
Help Text: Entered text will appear in a pop-up next to the label.
Form: Contact Information - cannot be edited.
Form Version: Client - cannot be edited.
Form Field: Person - cannot be edited.
Allow Multiple: allows for the selection of multiple names in a single form.
Advanced Settings: Same for all forms. See insert at the bottom of this section.
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.
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: The name of the field as it appears in the form. Should be changed if not clear to users.
Help Text: Entered text will appear in a pop-up next to the label.
Form: Contact Information - cannot be edited.
Form Version: Select the Form Version of your choice:
All Form Versions - will show all possible names of people with a relationship to the client
Client - will only show names of contacts who are clients with a relationship to the client
Professional - will only show names of contacts who are Professionals with a relationship to the client
General - will only show names of contacts who are General with a relationship to the client
Form Field: Person - cannot be edited.
Allow Multiple: allows for the selection of multiple names in a single form.
Advanced Settings: Same for all forms. See insert.
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.
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: The name of the field as it appears in the form. Should be changed if not clear to users.
Help Text: Choose a contact from all general contacts (text can be updated)
Form: Contact Information - cannot be edited.
Form Version: General - cannot be edited.
Form Field: Person - cannot be edited.
Allow Multiple: allows for the selection of multiple names in a single form.
Advanced Settings: Same for all forms. See insert.
Field: Email
Purpose: Captures email data and ensures it is properly formatted.
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: The name of the field as it appears in the form.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over. Default Value field will trump this field if it is being used.
Default Value: Entered text becomes the default data in the field and can be typed over.
Advanced Settings: Same for all forms. See insert.
Field: Phone Number
Purpose: Captures phone number data and ensures it is properly formatted to what is chosen in Application Settings - General
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: The name of the field as it appears in the form.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over. Default Value field will trump this field if it is being used.
Default Value: Should be left empty. Entered text becomes the default data in the field and can be typed over.
Advanced Settings: Same for all forms. 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.
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: The name of the field as it appears in the form.
Help Text: Entered text will appear in a pop-up next to the label.
Form: Contact Information - cannot be edited.
Form Version: Professional - cannot be edited.
Form Field: Person - cannot be edited.
Allow Multiple: allows for the selection of multiple names in a single form.
Advanced Settings: Same for all forms. See insert.
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.
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: The name of the field as it appears in the form.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over.
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.
Advanced Settings: Same for all forms. See insert.
Field: Service
Type: Filtered Lookup. Filters the names of services from the Services Form.
Purpose: Used to track data that relates to a service.
Required: If checked, the record cannot be saved unless data is entered in this field
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
Help Text: Entered text will appear in a pop-up next to the label.
Form: Services - cannot be edited.
Form Version: All form versions - cannot be edited.
Form Field: Service Name - cannot be edited.
Allow Multiple: allows for the selection of multiple services in a single form.
Advanced Settings: Same for all forms. See insert.
Basic Fields
Field: Single Line of Text
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over. Default Value field will trump this field if it is being used.
Default Value: Entered text becomes the default data in the field and can be typed over.
Max Length: 255 characters
Advanced Settings: Same for all forms. See insert.
Field: Multi Line Text
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over. Default Value field will trump this field if it is being used.
Default Value: Entered text becomes the default data in the field and can be typed over.
Max Length: Limits the number of characters that can be typed in. Should be left empty unless character limit is desired.
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.
Field: Rich Text Box
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over. Default Value field will trump this field if it is being used.
Default Value: Entered text becomes the default data in the field and can be typed over.
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.
Advanced Settings: Same for all forms. See insert.
Field: Number
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field and is meant to be typed over. Default Value field will trump this field if it is being used.
Default Value: Entered text becomes the default data in the field and can be typed over.
Show as Currency: When ticked the currency symbol is added to the entered value.
Min: Sets the minimum value that can be entered. If empty no minimum is set.
Max: Sets the maximum value that can be entered. If empty no maximum is set.
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.
Number of P laces: Sets the number of decimal places desired. Default to 0. Currency should be set to 2.
Advanced Settings: Same for all forms. See insert.
Field: Date
Required: If checked, the record cannot be saved unless a date is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Default Today: If checked, the date is automatically sent to today when a new form is added.
Advanced Settings: Same for all forms. See insert.
Field: Date and Time
Required: If checked, the record cannot be saved unless a date is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Default Today: If checked, the date and time is automatically sent to today/now when a new form is added.
Advanced Settings: Same for all forms. See insert.
Field: Drop Down List
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Placeholder: Entered text will be visible in the field. For a Drop Down List, placeholder text could be "Choose the item that best suits the situation". If the field is set to required the user cannot skip answering.
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.
Advanced Settings: Same for all forms. See insert.
Field: Yes/No
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”.)
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Default Value: Must be set to either Yes or No. This type of field always has data on saving a record.
Advanced Settings: Same for all forms. See insert.
Field: Link
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Default Value: Entered Text will display in the Text field of the form to be typed over. This field would normally be left empty.
Open In A New Tab: Sets the link to open in a new tab.
Advanced Settings: Same for all forms. See insert.
Advanced Fields
Field: User (Employee)
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
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 includes all users who will be filling in this form.
Select Current User: When checked the form will automatically fill in the name of the logged in user filling in the form.
Allow Multiple: Allows for more than one user to be selected.
Advanced Settings: Same for all forms. See insert.
Field: Radio Group
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Inline: When checked, the choices are display in a horizontal line instead of in a vertical column.
Enable "Other": When checked allows users to enter an unlisted option. A text box opens to allow typed in text.
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.
Advanced Settings: Same for all forms. See insert.
Field: Checkbox Group
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Toggle: Replaces a check box with slider.
Inline: When checked, the choices are display in a horizontal line instead of in a vertical column.
Enable "Other": When checked allows users to enter an unlisted option. A text box opens to allow typed in text.
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.
Advanced Settings: Same for all forms. See insert.
Field: Lookup Values
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Form: Select a Form to pull data from.
Form Version: Select a form Version. Most lists have only one form version. If more than one, select the appropriate version.
Form Field: Select a form field. This is the field that the data will be looking up to.
Allow Multiple: Allows for the selection of multiple choices when ticked.
Advanced Settings: Same for all forms. See insert.
Field: File Uploader
Required: If checked, the record cannot be saved unless data is entered in this field.
Label: Displays text by default. Rename label to something brief that describes the purpose of the field.
Help Text: Entered text will appear in a pop-up next to the label.
Auto-Resize Images: Images are reduced to a size suitable for use on the site. (Reducing image size saves document storage space.)
Resize Width (Px): Under Construction
Resize Height (Px): Under Construction
Advanced Settings: Same for all forms. See insert.
Field: Heading
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.
Type: Pick the heading size. H1 is the largest size. Sizes change in real time.
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.
Field: Information
Content: Replace the text "Information" with text of your choice. This is a place for helpful content that is read-only to users filling in a form. Users do not add text to this type of field.
Removed/Other Fields
Fields that have been removed from this form are listed in this section. Field can be returned to the form by dragging and dropping.
| Info |
|---|
Advanced SettingsAdvanced Settings are found at the bottom of all forms. For the most part you will not have to adjust these settings. System FieldIf set, the field cannot be removed form a form. It will be set on for some fields found in ShareVision forms. Default FieldOnly one field is set to the default per form. The Default Field is used to uniquely identify a form submission created from this form. The first supported field added to a form is automatically set at the default field. Changing the default Field - Option 1
Changing the default Field - Option 2
|