Document Templates
Mint Service Desk 3.4.2 user manual.
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.