Custom Forms
by Leanna Rogers-Bowen
Top Right Image

 

 

OVERVIEW

Custom forms and fields are used to collect information in Vivantio which is specific to the way your organisation works. For example, when a user creates an on boarding request for a new member of staff you can collect information like the new users name, start date and the applications that they will need to use. These forms can be made available to your end users through the self service portal and the technicians portal and can be conditional on the category, status and or other custom fields. The information collected from custom forms can be used to drive processes such as workflows or routing rules. You can also create custom fields to capture information you import from other applications, such as the Active Directory or SCCM, and then use this data to make customised queues and tabs or create scheduled tasks. Custom forms and fields are also used in the creation of caller surveys. Finally, custom forms and fields can also be used in reporting, for example if you collect data on the nature of the ticket solution on closure you can see how many calls were due to user error and identify areas for improvement. Custom forms are available for tickets, callers, assets, locations, clients and articles. 

 

Guidance

 

Navigate to the Admin Area > System Areas > Choose the System Area you wish to create the Custom Form in > Custom Forms > Add:

 

 

Name: This is the Name you give your custom form. This will be visible to users / callers. This cannot be changed once your custom form is saved.

 

Visibile in Self Service: Tick this box if you wish for your custom form to appear to callers in the Self Service Portal when logging a ticket.

 

Multi-line: This enables multi-line functionality for the answers.

 

Hide Empty Values: If nothing is answered in one of your Custom Fields then this will hide the values.

 

Show as Tab: You can show any custom form (incl multi-line) either as a card or tab

 

Fields

The list of Custom Fields that have been created for the same system area will be available to select from to add into your custom form.

 

Add

Click 'Add' to bring up the list of custom fields available. These are displayed in order of 'created' date, however, can be changed by clicking on one of the titles in the title bar. You can select the relevant custom fields to add to your custom form. There is no limit to the amount of custom fields that can be selected. You do not need to select them in the order in which you wish for them to appear in your custom form.

 

 

Edit

Select a field (one at a time) and click 'Edit' to present the below options. This custom field will then be edited specifically for this custom form.

 

 

Mandatory Mode

You can choose from various options for whether or not this custom field is 'Required' (mandatory) in this custom form:

 

Never - The field is optional throughout the Ticket lifecycle

 

Always - The field will be 'Required' as soon as it appears

 

Before Close - The field will be available to fill in as soon as the form appears, but it will not be possible to close the Ticket until a value has been provided. Choosing this option may prevent the technician from closing multiple tickets simultaneously and may mean that tickets cannot be closed via the Self Service Portal.

 

 

When a field is configured as 'Required' the user, whether in the main application or your SSP, will see the questions presented with red down the lefthand side - they will not be able to move on unless a value is entered in the required field.

 

 

Visual in the SSP

 

 

Conditional Visibility

You will need to enter a condition of when you need the custom field to be visible.

 

Examples

 

Question Reason new phone required will only become visible when the Question Type of Phone has the answer Mobile selected

 

 

 

Question Reason new phone required will only become visible when the Question Type of Phone does NOT have the answer Mobile selected

 

 

Remove

You can delete a custom field from your custom form by selecting the field and clicking 'Remove' - there is NO confirmation message, the field will be removed straight away.

 

Please Note: If you have Reports built containing the removed custom field, you will need to amend your reports.

 

 

Move Up & Move Down

This will allow you order your custom fields to how you wish for them to appear in the form. Select a field and then click 'Move Up' or 'Move Down' depending on where you wish the field to be placed. 

 

Conditions

This will allow you to configure where you wish for this custom form to appear.


Always Appears

If selected, this custom form will be always visible to the Technician / Caller throughout the ticket lifecycle

 

Appears For Selected Categories

You can select as many categories as you wish. When selected, this custom form will only visible when ticket has one of the selected categories

 

Processes

This will allow you to select when the custom form will appear.

 

Process Type

There are 3 processes to select from:

 

On Add/Accept - when the ticket is added / accepted

 

On Change Status - when the ticket status is changed on the ticket

 

On Close - when the ticket is being closed

 

 

Header & Footer

You can use HTML to insert a Header or Footer into your custom form - this will only be visible in the SSP

 

 

 Reviewed: 28 March 2023