Fields Settings
Mint Service Desk 3.4.2 user manual.
Dictionaries
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.
Regexes
Regular expressions restrict the format of field values. For example, an Integer attribute accepts numbers, while an Email attribute accepts an email address.
Mint Service Desk includes predefined regular expressions. You can also create your own.
Click on the “Add new value” button, located on the right side, next to the search field and you will be moved to the “Create New Regex” screen.
Now, just type the “Name” of your regex and the allowed set of “Values”. You can also check the option “Is hidden” if needed. Press the button and the new regex will appear on the list of available ones.
If, on the other hand, you would like to make some changes in already existing Regex, just click the button located on the right side of the main view, in the ‘Action’ column.
Dictionaries Integrations
Import simple dictionaries or dictionaries with patterns from a CSV file.
The process requires that a created dictionary exists in the system. To create a new dictionary, go to Field Settings -> Dictionaries.
The integration process starts by navigating to the Field Settings tab and then to the Dictionary Integration submenu. The main view presents a configuration table with the following columns:
- Name - the name of the configuration
- Definition Name - a short name for the type of configuration selected from the list during creation
- Definition Type - a description of the selected type of configuration
- Action - a column with and buttons
To create a new configuration, click the button in the upper right corner of the page.
This opens the Create Integration page, where we name our configuration in the Name field and select the type of configuration in the Definition field.
After completing and saving the data, we are redirected to the configuration settings.
We start with Section dictionary configuration.
The first step is to select a dictionary - in the Dictionary to update field, we select an existing dictionary in the system that we want to update.
After selecting the dictionary, we proceed to the following fields:
- Dictionary key type: Here, we select the database column that will be the primary key for the imported data (the database column used to identify whether values already exist). The available options are: DictionaryValueId, Value, or Pattern.
- Key column name: Here, we enter the name of the key column from the file. The data from this column will correspond to the database column selected in the Dictionary key type field.
- Value column name: Here, we enter the name of the column from the file whose data will correspond to the Value column in the database.
- Value position order column name: Here, we enter the name of the column from the file whose data will correspond to the PositionOrder column in the database.
If the dictionary does not have patterns, the message ‘The selected dictionary does not have patterns’ will appear in the ‘Section Dictionary Pattern Configuration’.
Example: importing dictionary values
In Mint Service Desk there is a HARDWARE dictionary without any entries.
Import computer, laptop and smartphone in that order. Use Value as the key because the values are unique.
First we need to create an appropriate CSV file. In the first row, we define the names:
- Key column name: the name of the key column. The data in this column will refer to the database column selected in the Dictionary key type field.
- Value column name: the name of a column whose data will refer to the ‘value’ column in the database.
- Value Position Order Column Name: the name of the column whose data will refer to the ‘PositionOrder’ column in the database.
The names must be separated by a defined delimiter. In this example, we use a semicolon.
A sample first row of the file would be:
key;value;positionOrder
In the second and subsequent rows, we enter the data that will be placed in the columns defined in the first line.
For the HARDWARE dictionary, the file would look as follows:
- Row 1: key;value;positionOrder
- Row 2: computer;computer;1
- Row 3: laptop;laptop;2
- Row 4: smartphone;smartphone;3
The resulting CSV file is shown below.
Once the file is prepared, we proceed to the dictionary configuration section and select:
- Dictionary key type - the column serving as the key for our dictionary (we select Value because we know these values will be unique and not duplicated).
Then we fill in the names according to the first row:
- Key column name: key
- Value column name: value
- Value position order column name: positionOrder
In the File delimiter section, we set the CSV data separator (by default, this is a semicolon).
After completing the above steps, we click the Update button - the configuration data is updated.
The next step in the process is to import data from the file. Click the ‘Select file’ button, attach the relevant file and the synchronization will start automatically.
This action starts the process of retrieving dictionary values, which you can track in real time. Clicking on a selected synchronization takes you to the details, where you can also view the retrieval process and any potential errors.
After synchronization succeeds, the dictionary contains the values from the CSV file.
PATTERNS
If the dictionary contains patterns, the Section dictionary pattern configuration displays button.
Clicking the button adds a row with Pattern key and PatternValueColumnName fields. In the Pattern key field, we select the pattern name from the dictionary, and in the PatternValueColumnName field, we enter the name of the column from the file that contains the values to be imported into the pattern.
For example, we add a pattern named TEST PATTERN to our HARDWARE dictionary.
The CSV file must include this column so we need to update it. A sample first row of the file would be:
key;value;positionOrder;columnPattern1
In the second and subsequent rows, we enter data analogously to the previous example, with the addition of the columnPattern1 data. The file might look as follows:
- Row 1: key;value;positionOrder;columnPattern1
- Row 2: computer;computer;1;Pattern 1
- Row 3: laptop;laptop;2;Pattern 2
- Row 4: smartphone;smartphone;3;Pattern 3
The updated CSV file is shown below.
Configure the pattern mapping as shown below.
Now in the File delimiter section, we set the semicolon as data separator and click the Update button - the configuration data is updated.
The next step in the process is to import data from the file. Click the ‘Select file’ button, attach the relevant file and the synchronization will start automatically.
This action starts the process of retrieving dictionary values, which you can track in real time. Clicking on a selected synchronization takes you to the details, where you can also view the retrieval process and any potential errors.
After synchronization succeeds, the dictionary’s pattern fields contain the values from the CSV file.