uslimato
|

Catalog

Overview

The Catalog is the central reference for your hardware and software inventory. It provides a structured hierarchy of Manufacturers → Models → Asset Types that keeps your asset data consistent and searchable across the entire platform.

Catalog management is available to Admin users via the Catalog entry in the sidebar.


Manufacturers

Manufacturers represent the companies that produce your IT equipment and software (e.g. Lenovo, Apple, Microsoft).

FieldDescription
NameDisplay name of the manufacturer
WebsiteOptional URL to the manufacturer's website
NotesInternal notes (not visible to end users)

Actions

  • New Manufacturer — opens a dialog to create a manufacturer.
  • Edit — click directly on the manufacturer name (admin only) to open the edit dialog. A hover pencil icon indicates the item is editable.
  • Delete — available inside the edit dialog. Only possible if no models are associated with this manufacturer. If models exist, the delete is blocked with a clear error message. An inline confirmation step prevents accidental deletion.

Expanding a manufacturer

Click the chevron button on the left to expand the manufacturer and see all associated models. The name itself is the click target for editing (admin only).


Models

Models are specific product variants linked to a manufacturer and an asset type (e.g. "ThinkPad X1 Carbon" → Lenovo → Laptop).

FieldDescription
NameModel name
ManufacturerThe manufacturer this model belongs to
Asset TypeThe asset type category (e.g. Laptop, License)
NotesOptional internal notes

Cascade selection

When creating a new asset, the form shows a Manufacturer → Model cascade picker. Selecting a model automatically fills in the manufacturer and model text fields — ensuring consistent naming across all assets.

Card view and table view

Models can be displayed in two layouts, switchable via the toggle in the toolbar:

  • Cards (Kacheln) — the default tile layout. Click any card (admin only) to open the edit dialog.
  • Table — a compact row-based view. Click any row (admin only) to open the edit dialog.

The selected view mode is saved in the browser and restored on the next visit.

Configurable columns (table view)

When the table view is active, a Customize Columns button appears in the toolbar. It opens a popover where you can:

  • Toggle individual columns on or off using checkboxes.
  • Reorder columns using the up/down arrow buttons.
  • Reset everything back to the default layout with the Reset button.

Column configuration is stored per browser and persists across sessions. The available columns are: Name, Asset Type, Kind, Notes, Created.

Editing and deleting a model

Click on a model card or table row (admin only) to open the edit dialog. The delete option is available at the bottom of that dialog with an inline confirmation step.

Deletion guard

A model cannot be deleted if it is currently linked to one or more assets. You must either re-assign those assets to a different model or leave them unlinked first.


Asset Types

Asset types define the categories of assets (e.g. Laptop, Mobile Device, License, Peripheral). The catalog page lets admins configure two additional properties per type:

FieldDescription
Code (TYPE_CODE)A short abbreviation (up to 10 characters) used in asset tag templates, e.g. LPC for Laptop. Referenced as {TYPE_CODE} in the tag template.
Asset KindEither Hardware (physical) or Software / License (logical). Controls how the asset form renders and which lifecycle processes can apply.

System types

System types (marked with a System badge) have their names, icons, and colors locked — only the code and kind can be changed.

Custom types

Custom types can be fully edited (name, icon, color, code, kind) and deleted — as long as no assets use them.


Physical vs. Logical Assets

Every asset type has an Asset Kind:

  • Hardware (physical) — for tangible devices like laptops, servers, printers. The asset form shows purchase price, purchase date, serial number, and warranty prominently.
  • Software / License (logical) — for software licenses, SaaS subscriptions, and virtual resources. Purchase details are de-emphasized (collapsed behind a "More Fields" toggle) since serial numbers and warranties are less relevant.

This distinction also controls lifecycle process filtering: if a process is configured with Hardware only or Software only, it will refuse to start on an asset of the wrong kind.


Asset Tag Templates

Admins can configure the format used for automatically generated asset tags. See Settings for full documentation on the template syntax.

When {TYPE_CODE} is used in the template, each asset's type code is substituted when the tag is generated. Setting meaningful codes in the catalog (e.g. LPC for Laptop, LIC for License) ensures readable, structured asset tags like LPC-2026-000042.


Custom Fields (Admin)

Each asset type can have a set of custom fields — additional data points that appear on every asset of that type. Custom fields are managed in the Catalog by admin users.

Managing Custom Fields

On the Catalog page, scroll to the Custom Fields section. Use the Asset Type dropdown to filter fields by type, or view all fields at once.

Click New Field to create a field. Fill in:

FieldDescription
NameDisplay label shown in asset forms and the detail view
Field KeyTechnical key used in the API (auto-derived from the name, editable)
Asset TypeWhich asset type this field belongs to (can be All types)
Field TypeData type — Text, Number, Date, URL, Yes/No, Select, or Multi-select
OptionsFor Select / Multi-select: one option per line
RequiredIf enabled, the field must be filled in when creating/editing an asset
Show in listIf enabled, the field appears in the asset list table as a column

Editing a Field

Click the pencil icon next to a field to open the edit dialog. All properties except the field key can be changed.

Deleting a Field

Click the trash icon next to a field. If no asset has a value for this field, the field is deleted immediately after confirmation.

If assets already have data for this field, a confirmation dialog shows the number of affected assets. Confirming permanently removes the field and all stored values from every affected asset. This action cannot be undone.


Model Images

Admins can attach an image to each model (e.g. a product photo of the device). The image is uploaded in the model edit dialog and appears as a small thumbnail in the asset detail view.

Uploading an Image

Open the edit dialog for a model (admins only). In the Model Image section you will see:

  • The current image as a preview (if one exists).
  • The Upload Image button — opens a file picker.
  • The Remove Image button — deletes the current image.

Supported formats: JPEG, PNG, WEBP, GIF — maximum file size: 5 MB.

Every uploaded image is securely processed on the server: the file type is verified and the image is re-encoded to remove embedded metadata and potentially malicious content.

Storage Usage

Each tenant has a storage quota determined by their billing plan:

PlanStorage Limit
Free2 GB
Starter / Professional / Enterprise5 GB (adjustable by the HGE Uslimato platform team)

Current storage usage is visible under Settings → License. A warning is shown at ≥ 80% usage. When the limit is reached, uploads are rejected.


Unlinked Asset Warning

When you open an existing asset that has manufacturer/model text but no catalog link, an amber warning banner appears in the detail panel. If the system finds a matching model in the catalog, it offers a Link now button to create the association in one click.

This helps migrate legacy data to the catalog without manual re-entry.