Skip to content
Mint Service Desk Documentation centre

Dictionaries

Create lists of selectable values, including nested values, display labels and restrictions by ticket parameters.

Define dictionaries and their values for fields of type ‘Dictionary’.

Create, edit or delete dictionaries and their values. Users select values from a dropdown list; enabling ‘MultiChoice’ in the attribute structure permits more than one selection.

Creating a dictionary

In order to create a new Dictionary, click the “Add new value” button, located on the right side, and the creation screen will be displayed.

Now, type the name for your Dictionary e.g., “Computer Types” and then select one of the types available on the ‘Select type…’ dropdown list. In our example, we will choose the “Text” type.

There are more dictionaries types that you can use: “Char”, “Checkbox”, “Date”, “Decimal”, “Email”, “Integer”, “Phone number”, “Text” and “Time”.

Remember that you can create your types under Fields settings > Regexes.

Once you to that, click on the button and you will see that a view has been expanded and you can add the first value for your Dictionary.

Values and child values

By pressing the button you can add as many positions for your values as you want.

Type the name for each value in ‘Value…’ text field and press ‘Enter’ on your keyboard. You can use a button for this as well.

If at any moment, while typing the name, you decide that you want to remove the whole position just press the button.

After you saved the names for the values you can do a couple of things. You can rename the Value by pressing the edit button or delete the Value by pressing the button.

What’s more important is that you can create a ‘Child value’ for each Value. To do that press the button on the right side of Value’s name. A new row will appear right below. You will notice that its position is not equal to the “parent” Value and it is moved a little bit to the right.

You can add several child values to each parent value.

Once you’re done you can save your Dictionary by clicking on button to create your new Dictionary.

Every time you have a dictionary with ‘child values’ you can use some additional options to help you display them. Once you’re either in ‘Create new dictionary’ or ‘Edit dictionary’ view you can use the Expand / Collapse buttons.

The first one will show everything, including ‘Child values’, while the second will hide them and you will only see ‘Values’.

If you don’t want to see ‘Child values” of every Value that has them, you can expand and see ‘Child values’ of only one specific Value. Just press the button in order to expand the list or the button to hide it.

Value settings

Let’s take a look at the remaining buttons. The button allows adding descriptions to each value in the dictionary depending on the configuration under the button. For example, we added a dictionary value named Computer 1, but we want to assign a different label to the name. First we configure settings under the button and save:

Next we click the button and enter the name that will be displayed in the ticket for this dictionary entry.

After saving the changes, the value is assigned. From now on, when selecting a value from the dictionary, the user (Agent and Client) will see the value with the label.

Conditional visibility

The button allows specifying for which set parameters the dictionary value should be visible in the ticket. After clicking it, a new window opens with the possibility of adding values on the left, as well as Close and Save buttons on the right. Click the button to add a new row.

Select one of these parameters on the left:

  • Queue
  • Ticket Type
  • Service
  • Priority

Selecting one of the above options allows you to choose a specific value assigned to this option in the field on the right side of the row, such as a specific queue, ticket type, priority, or service.

For example, select Android in the Operating Systems dictionary.

in button choose the ticket type: Smartphone Users and save.

This means that the given dictionary value will be visible only for the ticket type: Smartphone Users.

When an agent creates a Computer Users ticket, Android is absent from the Operating Systems dictionary used by Select Operating System.

When the agent creates a Smartphone Users ticket using the same dictionary, Android is available.

Remember, not selecting any parameters under the discussed functionality means that the values should always be visible (depending on the permissions assigned to the custom field).

We can add more parameters if needed.

Now, let’s go back to the main Dictionary list. Whenever you decide to change anything in any of the dictionaries, just click the button located on the right side (‘Action’ column) of each dictionary on the list.