Skip to content
Mint Service Desk Documentation centre

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:

PlaceholderLocation/used inDescription
{{Name}}Asset DetailsAsset name.
{{Description}}Asset DetailsAsset description.
{{PrintDate}}Document generationDate when the document was generated.
{{PrintDateTime}}Document generationDate and time when the document was generated.
{{Customers}}Asset DetailsAssigned customers.
{{Agents}}Asset DetailsAssigned agents.
{{Company}}Asset DetailsCompany related to the asset.
{{Age}}Asset DetailsAsset age (in hours or days).
{{AssetCreationDate}}Asset DetailsThe exact date when the asset was created.
{{Categories}}Asset DetailsAsset 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.