9.1. Custom Field and FieldSet

FieldSet

A FieldSet is a group of Custom Fields, FieldSets are assigned at the Asset Model level.

For example, you want to track your phone Assets. You could create custom fields “IMEI“, “SIM“, “OS“, etc which are not covered by default.

You would then assign all of those mobile phone related fields to a new “Mobile Phones“ FieldSet, and use it for your mobile phone asset models (iPhone, feature phones, Android phone, etc)

In order to manage FieldSets, go to Settings → Custom Fields.

Here you can see a list of all the FieldSets. You can create new ones, search, export, and edit or delete existing ones

Create a new FieldSet

Click on New FieldSet to go to New FieldSet screen

Step 1:

Input FieldSet name, then click on Submit

Step 2:

Select defined Custom Fields for your new FieldSet by drag & drop fields between two columns.

You can mark a specific field Required, that means that field is mandatory.

Then click on Save to complete your creation.

Update or delete a FieldSet

From the FieldSet list, you can click on Edit or Delete button on a FieldSet to update and delete it

Custom fields

Custom fields allow you to track additional information about your assets that the default asset attributes don't cover.

In order to manage Custom Fields, go to Settings → Custom Fields

In Custom Fields section, you can see a list of all the Custom Fields. Here you can create new ones, search, export, and edit or delete existing ones

Create a new Custom Field

Click on New Custom Field to go to New Custom Field screen

Step 1:

Select a custom type, there are 5 types for your custom fields: TextBox, ListBox, TextArea, Checkbox and Radio Buttons. Then click on Next

Step 2:

Fill in all mandatory and desired information.

Click on Done to finish your creation

Custom Field validation

AssetIT has pre-defined all the possible format for your custom fields. When create/edit a custom field, just select a format which is match to your field the most.

Following is the list of pre-defined format

Format	Description
`ANY`	No input validation. Any text is acceptable.
`ALPHA`	The field under validation must be entirely alphabetic characters.
`ALPHA-DASH`	The field under validation may have alpha-numeric characters, as well as dashes and underscores.
`NUMERIC`	The field under validation must be numeric.
`ALPHA-NUMERIC`	The field under validation must be entirely alpha-numeric characters.
`EMAIL`	The field under validation must be formatted as an e-mail address.
`DATE`	The field under validation must be a valid date according to the `strtotime` PHP function.
`URL`	The field under validation must be a valid URL.
`IP`	The field under validation must be an IP address.
`IPV4`	The field under validation must be an IPv4 address.
`IPV6`	The field under validation must be an IPv6 address.
`MAC`	The field under validation must be a valid MAC address.
`BOOLEAN`	The field under validation must be able to be cast as a boolean. Accepted input are true, false, 1, 0, "1", and "0".
`CUSTOM`	This field allows you to use a regex expression for validation. It should start with `regex:` - for example, to validate that a custom field value contains a valid IMEI (15 numeric digits), you would use `regex:/^[0-9]{15}$/`.

Update or delete a custom field

From the custom field list, you can click on Edit or Delete button on a custom field to update and delete it.