Zoomed Image

Asset Editor Forms

xAssets Configuration Guide
User Groups

Asset Editor Forms

This page explains how to create customised asset editor forms for specific user groups. By using form prefixes, different user groups can see different fields and layouts when editing the same type of asset.

Prerequisites

  • The user group must have an Asset Editor Form Prefix set in the User Group Editor.
  • You must have Configuration user group permissions to create or edit forms.

How Asset Editor Form Prefixes Work

When a user opens an asset for editing, the system determines which form to display:

  1. The system checks whether the user's group has an Asset Editor Form Prefix set.
  2. If a prefix is set, the system looks for a form named with that prefix that matches the asset's category (e.g., for prefix "RO" and category "IT", it looks for a form named "RO Asset IT").
  3. If a matching prefixed form exists, it is used instead of the standard form.
  4. If no matching prefixed form exists, the standard form is used as a fallback.

This mechanism enables you to control what fields are shown to different user groups without creating entirely separate security configurations. For example:

  • A Read Only user group with prefix "RO" could have simplified forms that show only key fields.
  • A Finance user group with prefix "FIN" could have forms that emphasise financial fields and hide technical specifications.
  • A Help Desk user group with prefix "HD" could have forms focused on support-related fields.

Viewing Asset Editor Forms

The Asset Editor Forms tab in the User Group Editor is only available when the user group has an Asset Editor Form Prefix set. It shows all forms that have been created with that prefix.

Asset Editor Forms tab showing forms with the User Group prefix

From this tab you can:

  • Edit a form by clicking on its name.
  • Delete selected forms by selecting them and clicking Delete selected Asset Editor Forms.
  • Add a new asset editor form (see below).

Creating a New Prefixed Form

  1. Open the user group in the editor and switch to the Asset Editor Forms tab.
  2. Click Add a new Asset Editor Form.
  3. Select an existing form to clone from. The new form will inherit all properties and fields from the source form.
  4. The new form is created with the user group's prefix applied to its name.
  5. Edit the cloned form to customise it for this user group -- add, remove, or rearrange fields as needed.

Tip: Always clone from the standard form for the same category. This ensures you start with the correct fields and layout, and you only need to remove or hide the fields that this user group should not see.

Sharing Prefixed Forms Across User Groups

Multiple user groups can share the same prefix. For example, if both "Standard Users" and "Department Managers" should see the same customised forms, set the same Asset Editor Form Prefix on both groups.

This avoids duplicating form definitions and ensures consistent field layouts across related user groups.

Warning: Do not change a user group's Asset Editor Form Prefix after forms have been created with that prefix. Changing the prefix breaks the association, and the prefixed forms will no longer display for users in that group.