10.6.4. Custom Fields

When creating a ticket or CI (Configurable Item), our system captures certain data. Apart from the default types, we give users the flexibility to capture custom data types using the custom field feature. For example, some of our product users are capturing employee id using a custom field.

Custom fields are additional fields added by a user. They can appear while creating a ticket, and in the details view of a ticket and CI. Custom fields can be added to Requests, Problems, Changes, Release, Contract, Feedback, Purchase, Project and Assets.

Note

Adding Custom Fields requires administrative rights.

10.6.4.1. Types of Fields

We have four field types and one formatting option which you can use. The fields support a host of input types. Using the formatting option you can build interesting forms. The various options are as follows:

  • Text Field: This is a basic field that allows users to input a small amount of text. Supported value types are: Text, Number and Date.

figure 94.5
  • Dropdown: This field is populated from a predefined list. You get the option to defined the list.

figure 94.6
  • Section: Adding a section allows you to group fields. You can group similar fields together and align them in split form inside the section.

figure 94.7
  • Checkbox: It is a predefined checklist. You select by the checking the options.

figure 94.8
  • Radio Button: Similar to checklist, but supports only one selection.

figure 94.9
  • Text Area-input: It is a multi line text input area.

figure 94.9.1
  • Labels: This are static, immutable chunks of text.

figure 94.9.2
  • File Upload: This field allows you to attach a file of size up to 5 MB.

figure 94.9.3
  • Dependent Field: This field allows you to create dependent drop-downs up to 3 levels.

Chat Server

10.6.4.2. Working with Custom Fields

The product has a simple drag and drop UI to create and arrange fields.

10.6.4.2.1. Create a custom field

  • Go to Admin >> (Request, Problem, Change, Release, Contract, Purchase, Feedback, Project, or Asset) Custom Fields.

Note

Each module has a separate custom fields page.

Chat Server
  • In the Custom Fields page, you can view your existing custom fields, if any.

figure 96
  • To create a new field, drag and drop a field type from the Form Control section to the Preview section.

figure 97
  • The field is immediately created, and you can edit the field in its Glance View. You can open the Glance view by clicking on the field.

figure 98

Depending on the field type you can edit the following things:

  1. Form Label: This refers to the title of the field.

  2. Input Type: Available for Text Input field. This field supports three types of inputs: Text, Number and Date (Sat, Jul 21, 2018 4:39 PM).

  3. Hint Text: Available for Text Input and Drop-down. Hint text appears pre-filled in the input area; hinting the user what to input.

  4. Default Value: Applicable in all field types. You can choose what value to be pre-selected or pre-filled by default. In case there are multiple options, you can select any one as the default value.

figure 98.1
  1. Add Option: For Checkbox and Radio-button type fields, you can add n number of options.

figure 98.2
  1. Label value: Refers to a static chunk of text which is immutable and available only in a Label field.

10.6.4.2.2. Additional Custom Field Options

Clicking on a field opens the glance view where you will get additional options depending on the field type and module selected.

figure 1
  1. Required: This option makes the field compulsory on a form.

  2. System Managed field: This option makes the field uneditable, and the field will show only system generated values.

  3. Show on Requester form: This option is only available in Request fields and allows to control what field to show on the Requester form.

10.6.4.2.3. Rearrange Custom Field

You can arrange the fields using drag and drop. You can group fields in to sections (this feature is available for Request, Requestor, Feedback, Purchase, Contract, Project and Problem custom fields), and you can arrange custom fields in to a matrix using the section feature.

figure 94.7

Note

The rearrange feature doesn’t work when a field is in edit mode (Glance View is open). The fields are movable when the move icon is visible.

figure 98.4

You can delete a field using the adjacent trash icon.

10.6.4.3. Custom Field Behavior

The behavior and outlook of custom fields is different for each module.

10.6.4.3.1. Request

Custom fields appear on the Create a Request form (in all templates) and in ‘custom fields’ tab of existing tickets. The fields appear by default in the Technician portal, but you have to specifically toggle an option to make them appear in the Customer portal.

figure 98.3
figure 99

You can view and edit custom fields from the details view of a Request. You can find the fields under the Custom Fields tab.

figure 100

You can make a field compulsory for certain Statuses. For example, if a field is compulsory in Open Status, then you cannot keep the field empty when changing to another Status.

figure 100.1

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface.

figure 3

You can control the visibility of some default fields on the (Requestor Form) Customer portal; they are:

figure 100.1.1

You can make the default fields required/optional on the (Requestor Form) Customer portal; they are:

figure 100.1.1

Custom fields in Request also appear in the Report module. Technicians can use custom fields in generating reports.

figure 100.1.2

Custom fields in Request appear as part of the Workflow conditions.

figure 2

10.6.4.3.2. Problem

Problem custom fields are available to Technicians on the Create a Problem page (in all templates) and in ‘custom fields’ tab of existing tickets.

figure 100.2

Technicians can view and edit custom fields from the details view of a Problem. You can find the fields under the Custom Fields tab.

figure 101

You can make a field compulsory for certain Statuses. For example, if a field is compulsory in Open Status, then you cannot keep the field empty when changing to another Status. Please refer to the above section.

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface.

figure 3

Custom fields in Problem also appear in the Report module (as part of the column selection). Technicians can use custom fields in generating reports.

Custom fields in Problem also appear as part of the Workflow conditions.

10.6.4.3.3. Change

Change custom fields are available to Technicians on the Create a Change page (in all templates) and in ‘custom fields’ tab of existing tickets. While creating custom fields, you can specifically mark a field as belonging to a particular stage.

figure 102
figure 102.1
figure 103

Note

Stage specific fields can be edited in their respective stages.

You can mark a field as compulsory at a particular stage. You can even mark a field as a system field that only shows system generated data.

figure 102.2

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface.

figure 3

Custom fields in Change also appear in the Report module (as part of the column selection). Technicians can use custom fields in generating reports.

Custom fields in Change also appear as part of the Workflow conditions.

10.6.4.3.4. Release

Release custom fields are available to Technicians on the Create a Release page (in all templates) and in ‘custom fields’ tab of existing tickets. While creating custom fields, you can specifically mark a field as belonging to a particular stage.

Chat Server
Chat Server

10.6.4.3.5. Asset

You add a custom field either to an Asset Type (all sub-types will have the field) or a particular sub-type (specific).

Within a type, you can either make the field appear in Property section or Component section. Please refer to the Asset Management manual to learn more.

figure 102.3
figure 102.4
figure 102.5

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface.

figure 3

Custom fields in Asset also appear in the Report module (as part of the column selection). Technicians can use custom fields in generating reports. Remember, custom fields are specific to an Asset Type and a sub-type.

10.6.4.3.6. User Custom Field

Here Custom fields allow you to create new variables to store additional information about requestors.

You can create n number of text fields.

figure 103.1

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface.

figure 4

Such fields appear on the form for creating Requestors.

figure 103.2

Requestor Custom fields also appear while mapping field names during LDAP Configurations.

figure 103.3

Custom fields are considered when mapping columns during CSV import of Requestors.

figure 103.4

10.6.4.3.7. Contract Custom Fields

Users can add Custom Contract Fields in the Contract module. Some of the use cases of having custom fields are:

  • Custom fields can be used for capturing additional information about a Contract.

  • Custom fields appear in the Reporting module, where you can generate reports using custom fields.

  • Custom fields are supported in CSV import of Contracts (as one of the header property values). Custom fields can be used to capture additional information during Contract CSV import.

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface.

figure 5

You can view and edit values of such fields from the Custom Fields tab in the contract details view of a Contract.

figure 103.5

10.6.4.3.8. Feedback Form

A Feedback form captures the experience of a Requestor with the Helpdesk. A Feedback form is always specific to a particular Request. Using Custom fields, administrators can add more fields to capture additional information. Values captured by custom fields are visible on the Custom Field Page

Things to Remember:

  • A Feedback form is specific to a particular Request.

  • A link to the Feedback form is sent with the Resolved and Closure Email, and an Email sent manually. (Learn More).

Note

You can make a field as system field, which shows only system generated value. Such fields are not editable from the user interface. Learn more.

The Actual Feedback Form:

figure 103.6
  • Also the Feedback Rating can be done from the same Page. Go to Admin >> Any Module >> Custom Fields.

Feedback Rating
Feedback Rating

10.6.4.3.9. Purchase Custom Field

Custom fields appear on the Edit a PO page. Custom fields can be accessed from Admin >> Purchase Custom Fields.

figure 50

There are two class of Purchase Custom Fields:

  • General Details: This class of custom fields appear under the Additional Information section of Edit a PO page.

  • Purchase Items: These are Text fields that support only numbers, and they either add or subtract to the Net Total price of a Purchase Order (excluding or including shipping).

Learn More about Purchase Custom Fields.

10.6.4.3.10. Project Custom Field

Custom fields appear under the Custom Field tab in the details view of a project.

figure 103.8

10.6.4.3.11. Vendor Custom Field

Custom fields appear in the add vendor form.

figure 152

10.6.4.3.12. Product Custom Field

Custom field appear in the add product form.

figure 153