Documentation
    {{docApp.userSession.userId}}
    {{docApp.userSession.userName}}
    {{docApp.userSession.email}}
    Issuer : {{docApp.userSession.issuerInstance}}
    Expires : {{new Date(docApp.userSession.validUntil).toLocaleDateString()}}

{{docApp.title}}

{{docApp.description}}

How can we help?

{{docApp.searchError}}
{{product.name}}

Searching in {{docApp.searchFilterBySpecificBookTitle}}

{{docApp.searchResultFilteredItems.length}} results for: {{docApp.currentResultsSearchText}} in {{docApp.searchFilterBySpecificBookTitle}}
Search results have been limited. There are a total of {{docApp.searchResponse.totalResultsAvailable}} matches.

You have an odd number of " characters in your search terms - each one needs closing with a matching " character!

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

{{book.title}}
More...

Manage asset types

Note

This document covers the preview release of the new asset management features and user interface. You can find documentation for the current UI here.

Asset management within Hornbill Service Manager allows you to organize and present detailed information about each asset. By organizing assets into specific types, you can establish a comprehensive framework of fields and data tailored to each asset. This approach ensures that all relevant information is readily accessible for any asset.

Before you begin

Configuring asset types

To customize your users’ view of assets, navigate to Configuration > Service Manager > Assets > Manage Types. Here you’ll work in the following tabs:

  • General. Configure the asset type’s summary card, its icon, and so on.
  • Summary fields. Choose the fields that a user sees when viewing an asset in the Summary view.
  • Detail fields. Choose the fields that a user sees when viewing an asset in the Details view.
  • Create fields. Choose the fields available to users when new assets are being created.
  • List fields. Choose the fields that a user sees when viewing the list of assets in an asset type.

Tip

You may find it helpful, when customizing your asset views, to work with two windows open side by side, with one window showing Service Manager > Assets > [a selected asset] and the second window showing your configuration work in Configuration > Service Manager > Manage Types > [a selected type]. This way, you can see your modifications in real time.

General

General tab In the General tab, you can set some of the basic information about the asset type and choose an icon or upload a custom image the will be used for all assets of this type.

  • Name. The name of the asset that will be displayed everywhere assets are used.
  • Category. The category for this asset type.
  • Description. A descirption of this asset type.

Asset Card customization

The Asset Card is a like a businuss card that you can design for your asset. Key information of your choise can be added to the card. The defined asset card will appear on all assets defined under this asset type.

Here is an example of a summary card for an asset of the asset type Printer:

Summary card for an asset

Where is the asset card displayed?

Warning

When using the Summary Card Editor to customize asset summary cards, use only Hornbill-prescribed styles. Do not add your own styles; any other style declarations will be removed by Hornbill.

In the General tab, you can also use the dropdown to change the category of the asset type (rather than dragging/dropping).

The General tab is also where you can export and import your Assets UI configuration.

Summary fields

Summary Fields tab

Go to the Summary Fields tab to choose the fields that a user sees when viewing an asset in the Summary view. The focus of an asset is put on this summary information when a user clicks on an asset in the asset list. You can customize the list of Summary fields so as to highlight the most important or most used fields for this type of asset.

Choose between a one-column or two-column layout of the fields. Use the Quick Layout button to choose to use default fields or legacy fields. Using legacy fields means Hornbill will read in your asset fields from your existing implementation.

Here is an example of a Summary view for an asset of the asset type Printer, using a one-column layout:

Fields in an asset's Summary view

Here is the Summary view of the same asset, with fields configured in a two-column layout: Fields in an asset's Summary view, two-column layout

Detail fields

Detail Fields tab

In the Details view, users can access extended details beyond what is in the Summary view for an asset. Go to the Detail Fields tab to choose which fields you want users to see when viewing an asset in the Details view.

Choose between a one-column or two-column layout of the fields. Use the Quick Layout button to choose to use default fields or legacy fields. Using legacy fields means Hornbill will read in your asset fields from your existing implementation.

Create fields

Create Fields tab

Go here to choose the fields available to a user when creating new assets. Use the Quick Layout button to choose to use default fields or legacy fields. Using legacy fields means Hornbill will read in your asset fields from your existing implementation.

Here is an example of a New Asset dialog when creating an asset of the asset type Printer:

New Asset dialog

List fields

List Fields tab

Go to the List Fields tab to choose the fields that a user sees when viewing the list of assets in an asset type. You can drag the columns to change the order in which they appear in the list. Click the eye icon to toggle the columns from visible to hidden.

Here is an example of a what a users sees when viewing the list of assets by the asset type Printer:

List view when viewing by asset type

Fields available for searching. As an admin, you can configure the fields that are available for searching. If you want your users to be able to search for assets using specific fields, then add those fields here in the List Fields tab by adding additional columns. Once a column is added, it is available in the search.

Fields available for CSV download. The CSV download contains only the columns that you have added here in the List Fields tab.

Managing asset types

Service Manager provides a number of asset types by default so that you can quickly start adding your assets. Users can select an asset type when manually adding an individual asset. Admins can specify asset types as part of an import. Admins can also edit or delete the default asset types as necessary.

The default asset types include the following:

  • Desktop
  • Laptop
  • Server
  • Virtual machine
  • Headset
  • Keyboard
  • Monitor
  • Mouse
  • Webcam
  • Smartphone
  • Tablet
  • Printer
  • Scanner
  • Desktop app
  • Mobile app
  • Desk phone

For details about choices to make when creating a new asset type, see Asset type fields.

To add a new asset type:

  1. Navigate to Configuration > Service Manager > Assets > Manage Types.
  2. In the Asset Categories panel, find the category in which you want to create an asset type.
  3. Next to the category name, click + (the plus sign).
  4. Give the new type a name.
  5. From the dropdown, select an asset class for the new asset type.
  6. (Optional) Give the asset type a description.
  7. (Optional) Specify a three-character prefix to prepend to each asset given this type.
  8. (Optional) Toggle the Auto-generate asset names switch to on if you want assets for this type to have names auto-generated based on the asset ID.
  9. (Optional) Add an image for the asset type by uploading or dropping a file into the Custom Image box.

Asset type fields

  • Name. This is displayed in lists and used for searches and reports. This name is applied to assets created under this asset type.
  • Class. The asset class you choose determines the asset attributes that are available to the asset type.
  • Description. Add a few words to help users understand more about the type and how it should be used.
  • Prefix. This is a three-character prefix that is automatically prepended to the asset ID when you add an asset to the asset type.
  • Auto Generate Name. When enabled, for any asset that is created under this asset type, the name is automatically created and based on the asset ID. This includes any prefix set.
  • Image. Add an image as a visual identifier of the asset type. Any asset created using this type will also use this image.

Deleting an asset type

You can delete an asset type only when there are no assets associated to it.

To delete an asset type:

  1. In the Asset Categories list, click the row of the asset type you want to remove.
  2. Click the Delete button (trash can icon). If there are assets associated to the type, you will be prevented from deleting it.

Exporting and importing asset types

During the implementation phase of your Service Manager deployment, you may want to export asset types for a later import on the same Hornbill instance or another one – for example, to back up and restore your asset type configuration. You can export the layout of an asset type to a JSON file, (even make changes if necessary), then import the file. You must import the configuration to the same asset type it was exported from.

To export an asset type:

  1. Navigate to Configuration > Service Manager > Assets > Manage Types.
  2. In the Asset Categories panel, select the asset type you want to export.
  3. In the General tab, click the ellipsis button and select Export.
  4. (Optional) Make changes to the JSON file as necessary.
  5. (Optional) When you are ready to import the JSON file, follow the steps above and from the ellipsis, select Import.
  • Version {{docApp.book.version}}
  • Node {{docApp.node}} / {{docApp.build}}
In This Document