Assets
Mint Service Desk 3.4.2 user manual.
Creating New Asset
Click ‘Create Asset’ in the top-right menu of the Agent portal.
The ‘Create asset’ form opens.
Now, you need to put in the required information (marked with *): “Name” and select the right “Category”. If you want you can also add a detailed “Description” or even some attachments (pictured, .pdf files, etc.).
As an Admin, you can assign the asset to a particular agent or company user. For example, a mobile device used by one of your agents.
Once you fill up all the information, click on the button.
The ‘Create asset’ view will be refreshed, and you will see that some additional fields have been created on the right side. Those are additional attributes available for the chosen Category of Assets. They can be created and managed by you in Assets > Assets definition part of the system.
Once you add that additional information, you can update the asset by clicking on button.
Assets Management
Use Assets Management to view and edit the assets registered in the system.
Filtering and searching
Right here you can filter those assets by ‘Categories’ or by ‘Period’ (time period when assets have been added). If you want to reset active filters, just click on the button. You can also remove any selections (Categories, Filters, Attributes chose values) by clicking on or button right next to each position.
You can also use some more advanced filters. In the lower part of the view, you will find (depending on chosen ‘Categories’) additional sections. Those filters will be visible only if you check the option ‘Search filter’ while creating Asset structure (Assets > Assets definition > Assets structure).
Click on the button in order to see the whole list of available filters.
Now you can select one or more filters, for example CPU Model. If you do this the list of results will be refreshed.
These filters use the attributes of assets in the selected categories. You can combine several filters; the results refresh after each selection.
If you want to see some more information on the list of assets (more columns) just use the ‘Set column properties’ button. It was already described in the earlier parts of this guide.
Also, if you want, you can look for specific assets (for example by asset’s name) by using the section “Search” field. Whatever you type here will be searched for, depending on the things you marked in the ‘Search by’ section of the ‘Set column properties’ window.
Details, export and history
Click an asset’s name to open its details.
From this view, you can move to ‘Edit asset’ view. Just click on the button.
If you want to export asset into pdf file press button.
To print the QR code, press button. After pressing this button, you will be transferred to the print view. In the file will be the QR code and the information configured in Settings > General > Assets.
Press to open the asset’s change history.
Press next to a change to expand its details.
Editing and deleting assets
If, on the other hand, you need to access ‘Edit asset’ right from the ‘Asset management’ list simply use the button on the right side.
To delete asset, while being on the main ‘Asset management’ view press button located on the right side (right next to ‘Edit’ button. Then confirm the operation by clicking the ‘yes’ button.
If the asset is related to any of the Tickets in the system you will find it on the list once you click the button while being inside ‘Edit asset’ view.
Administrators can change all asset details, including ‘Categories’ and ‘Assigned users’. If you remove an assigned user, they receive an access-rights message the next time they try to view the asset.
Assets Definition
Define asset categories, attribute groups and individual attributes with their values. You can also set permissions to view or change them.
Related articles
Assets Structure
Use the ‘Assets Structure’ tab to define asset categories, attribute groups, individual attributes and their values.
By default, the content of each Ticket Type is hidden, and you only see the Ticket type name.
If you want to see the full content of a Ticket Type you need to click button, located right on the left side of the ticket type name.
Categories
You can create different Asset Categories like “Hardware-phones” or simple “Software”. To add a new category just click on the empty field ‘Add category’, type the desired name, hit ‘Enter’ on your keyboard, or press the ‘Save’ button.
If you want to rename already existing Category just click on its name, make some changes and click Enter.
If you want to remove it just click on a trashcan icon located on the right side. In the new window, you will be asked to confirm this action.
Click ‘Yes’ and Category will be removed. Remember that deleting a Category means also deleting all custom Groups of attributes and single attributes that you have added to this particular Category.
Groups
Create and edit attribute groups in the same way as categories.
In order to create a new group, click on an empty field ‘Add group’ and type the desired name.
Now click enter on your keyboard. Try to save the changes by clicking on the right side of the screen. You will see information saying, “Group must have at least one attribute”. Before you’ll be able to save a group, you need to create at least one attribute.
To change the name of the group just click on it, type a new one, and accept the change by clicking enter.
To remove the group, use the trashcan icon on the right side. Please notice that along with a group you will delete attributes that are inside this group.
Attributes
Attributes store detailed information about assets. Each group must contain at least one attribute before you can save it.
Add, rename and remove attributes in the same way as categories and groups.
However, after typing and accepting a name for the attribute you will have to choose attribute type, decide if you want to be able to search by this attribute in the list of assets (‘Search filter’ check-box) or be able to select more than one value of the attribute (‘Multichoice’ check-box).
Select an ‘Attribute type’ from the list.
The available types are “Pool”, “Integer”, “Date”, “Real Number”, “Text”, “Relation”, “Date Scope”, “Num Scope”, “Geolocation”, “Text area”, “Alert Date”, “Attachment”, “Radio”, “Checkbox”, “Label”, “Regex”, “Dictionary”, “Relation Asset”, “Relation Ticket”, “Relation Contract”, “Relation Company”, “Relation User” and “SubscribedReceiver”
Those types of attributes have already been described in the Tickets > Custom fields > tickets structure part of this guide.
Assets Permissions
Open the “Assets Permissions” tab to grant or remove Read and Update access to asset categories, assets and their attributes. Selecting Update also selects Read.
Selecting a role and category
In the first field, you need to select one position from the list of available General types of roles. They can be e.g., ‘Agent Roles’ (if you have more than one created in Agents > Roles section) or ‘Company Roles’ (located in Companies > Company Manager section, separately for each company in ‘Role’ part of the company’s details).
After you do that, from the second list you need to select a particular type of Role for which you want to change the rights.
Below you will also find a ‘Search category…’ search box, where you can type the name of the category that you are looking for, without the need to scroll the whole list.
Read and update permissions
There are two types of rights in the Mint Service Desk:
- Read – allows the user only to view the list of assets from a particular category and their details
- Update – it gives the same rights as ‘Read’ but also allows the user to make changes in the content of an Asset in a category. For example, Agent will be allowed to change the name of the asset or change its attribute’s values.
Selecting ‘Read’ does not select ‘Update’.
Selecting ‘Update’ also selects ‘Read’, allowing the user to view and change the asset.
If you want to change the rights for the whole Category you can select the ‘Read’ and/or ‘Update’ checkboxes located right next to the Category name.
You can also change the rights for selected attributes. To do so, select checkboxes located right next to the attributes that you are interested in.
Once you finish making the changes, you need to click button (located on the right side of the view), otherwise, when you try to leave this part of the system it will inform you that you have some unsaved changes.
Assets Integrations
Integrate asset data through an API or a CSV file.
Related articles
Api Integration
To integrate assets with Lansweeper, press the button.
In the Name field, enter the name you want displayed on the list of all integrations. In the Definition field, select Lansweeper from the dropdown menu.
To complete the first configuration process, press the button.
Then return to the list with all available asset integrations and edit the configuration of interest.
The configuration is similar to Users Integrations, which was described earlier under Users/Users Integrations.
Csv Integration
Import assets from a CSV file to create new records or update existing ones. The following sections cover configuration and examples.
CONFIGURATION
Before configuring the integration, you must have an asset category created in the Admin Panel under Assets → Asset Definition. If it does not exist, create a new one and, if needed, define custom fields within that category. This documentation assumes that an asset category and two custom fields are already set up.
The integration process begins by navigating to the Assets tab and then to the Assets Integrations submenu. The main view presents a table of saved configurations with the following columns:
- Name – Configuration name
- Definition Name – Short name of the configuration type selected from the list during creation
- Definition Type – Description of the selected configuration type
- Action – Column with Edit and Delete buttons
To create a new configuration, click the “Plus” button in the upper-right corner of the page.
This opens the Create Integration page, where you enter a name in the Name field (any value) and select the Definition Type as CSV (CSV assets integration).
Once the details are filled in and saved, you are redirected to the configuration settings.
Complete Set Asset Configuration:
-
Map assets by type – This field determines which column or custom field the importer will use to recognize the uniqueness of assets in Mint Service Desk. If the value in the selected column exists, the importer will update the corresponding asset. If it does not exist, a new asset will be created. Available options:
-
Id – Corresponds to the asset’s unique system number in Mint Service Desk
-
Subject – Corresponds to the asset’s name
-
CustomField – Selecting this displays a new field: CustomField attributeID key column name.
In this field you can select an existing custom field and assign it as the primary key for the asset. First, choose the asset category from the dropdown, then select the associated custom field.
-
Once selected, this field becomes the primary key for the importer.
-
Key column name – Name of the column in the CSV file that corresponds to the key column selected in Map Assets by Type.
-
Category map type – Determines how the importer assigns an asset to a category:
-
Constant – You manually select an asset category from the Mint Service Desk system. The importer will only add or update assets in this specific category.
-
FieldsValue – You specify the column in the CSV file that contains category values. The category values must be in GUID format (e.g., a816f0ec-15d6-40fd-818a-fc9687c4c77c) and must match category IDs in the Mint Service Desk database.
-
FieldsValueWithMapping – Allows mapping category names from the CSV file that may not exactly match those in Mint Service Desk. This configuration enables name mapping between the CSV and the system. After selecting this option, the Category field mapping section appears with Set external category value field and New row button.
In the field with the placeholder Set external category value, we indicate which column in the CSV file corresponds to the asset category. After clicking New row, the first entry (#1) appears with the fields Set external category value, Asset category, and the Delete button.
In entry #1, in the Set external category value field, we specify the first value from the CSV column, while in the Asset category dropdown list, we select the category to which this value will correspond. For example, in the CSV file, we have a column named IT Hardwares with the first value Computers. We want Computers to be treated as a category, but in Mint Service Desk, this category is named Laptops. Therefore, we configure it as follows:
and the configuration with the CSV file:
This means: Take the data from the “AssetCategories” column in the CSV file, and if a value in this column matches “Computers,” assign the asset from that row to the “Laptops” category in Mint Service Desk. In this way, we can assign multiple assets to multiple categories simultaneously.
-
-
Asset name column name – Name of the CSV column that corresponds to the Name field of the asset in Mint Service Desk.
-
Description column name – Name of the CSV column that corresponds to the Description field of the asset in Mint Service Desk.
In Section File Configuration, set the CSV options:
- Delimiter – Default is a semicolon (;).
- Import File Button – Upload the CSV file for import.
The last section displays Synchronization history, including:
- Start time
- Result
- Execution date
- Errors (if any)
EXAMPLES
The examples below show how to import new assets and update existing records.
Importing New Assets
This example uses an existing asset definition named Laptops.
The asset database is initially empty.
Import five assets named Asset1, Asset2, Asset3, Asset4 and Asset5. Each should have Sample description in its description field.
Steps
Create a CSV file with the asset details.
Next, we create a new import configuration in the Asset Integrations tab (as described in Configuration part) and fill in the Section Asset Configuration section.
In Category map type, we select Constant and choose Laptops asset category
Keep the semicolon as the file delimiter and click Update to save.
Click Import file and select the CSV file from disk. Notifications appear in the top right corner and synchronization starts.
If another ongoing synchronization is already running in the background, we receive a notification:
In the Synchronizations section, we can see our synchronization with the status In Progress.
We can click on it to enter its details and see progress:
Once completed, the status changes to Success, and the assets are created in the system.
Modifying Existing Assets
After importing the assets, we want to update their names and descriptions. In the CSV file, before the update we have:
After the update we want:
As the Primary key, we select the asset’s ID. It is important that the asset ID in CSV matches the ID in Mint Service Desk.
If incorrect IDs are used, new assets will be created instead of updating existing ones.
Import the updated CSV file using the same steps as for new assets, then check the changes in Asset Management.
Document Templates
Related articles
Overview
In this section, you can add Document Templates as external files to the MINT Service Desk system. Later, as an Agent user, you will be able to use these templates in the Asset Details view via the “Prepare document” option. The template file should be prepared and saved in .doc or .docx format.
Snippets
While preparing the file, you can (and should) use special placeholders called snippets. When generating the document, these placeholders will be automatically replaced with values from the selected Asset.
Available asset snippets:
| Placeholder | Location/used in | Description |
|---|---|---|
| {{Name}} | Asset Details | Asset name. |
| {{Description}} | Asset Details | Asset description. |
| {{PrintDate}} | Document generation | Date when the document was generated. |
| {{PrintDateTime}} | Document generation | Date and time when the document was generated. |
| {{Customers}} | Asset Details | Assigned customers. |
| {{Agents}} | Asset Details | Assigned agents. |
| {{Company}} | Asset Details | Company related to the asset. |
| {{Age}} | Asset Details | Asset age (in hours or days). |
| {{AssetCreationDate}} | Asset Details | The exact date when the asset was created. |
| {{Categories}} | Asset Details | Asset categories. |
You can also use snippets for Custom Fields assigned to Asset categories. The schema for such snippets is:
{{CategoryName:AttributeName}}
For example, for custom field named: Text in Category: Desktop the snippet should be written as: {{Desktop:Text}}
Supported Custom Field types:
- Text
- Integer
- Realnumber
- Date
- Datescope
- Numscope
- Textarea
- Alertdate
- Radio
- Checkbox
- Hypertext
- Dictionary
If a custom field contains no value, the corresponding snippet will be empty in the generated document.
Adding Document To The System
To add a new template file to the system, go to ‘Admin’ > ‘Assets’ > ‘Document template’. You will then see a list of the document templates that have already been created. From here, you can add a new template, as well as edit or delete an existing one. There is also a search box for template names in the top-right corner of the list.
To add a new template, click the ‘+’ button. You will then be redirected to the document creation screen.
The following fields are available in this view:
- Name (required) - the name that will be used in the system after the document has been added and saved.
- Categories (required) – the resource categories in which this template will be visible
- Add file - a field with a ‘Click to attach file’ button. Clicking this allows you to select the file you wish to attach to the system.
- Description - a field for entering additional information.
Fill in the required Name and Category fields, then click the Add file button. A modal window will open, allowing you to select a file from your hard drive. Select your file and click Open. The file will be uploaded to the system. Then save the configuration by clicking the Save button in the bottom right-hand corner. You will be taken to the list of entries, where you will see an entry for the newly added template.
Generating Asset Template
To generate a document for an asset, open an asset from the category to which you have assigned the template. Then, click the Prepare document button and select your template from the list.
Once you select the template, a document will be downloaded with the values automatically populated according to the configured template.