Our Extra Fields module allows you to create more fields on your assets, properties, tasks, clients and more. This allows our customers to customise their Uptick system to help add more information to reports or just add specific fields that Uptick doesn't offer, yet is a strong part of your company's processes.
A good example would be to add a new field to your assets for Fire Rating or Hinge Types.
Setup
Once the extension is enabled by us and permissions are applied, go to Control Panel > Extra Fields.
From here, you can create new fields or modify the configuration of existing extra fields you've added.
Adding a extra field
Click Add Extra Field
Fill out the fields:
Label | The name of the field. |
Key | Automatically generated from the label (this is the name of the field that Uptick uses to add to reports) |
Help text | Provide your own context to the field which will appear as a sub-heading. |
Object Type | This is the area of Uptick you would like the field to sit, for example, if I want to add a new field to my properties in Uptick, I want select Property here. Available object types are:
|
Widget | Widgets define the type of field the extra field will be and will determine the type of data the field takes. Available widget types are:
|
Order | The order in which you display your extra fields if there are many, 1 being the top of the list. |
Required | Ticking this will make the extra field a required field. |
3. Once all the details have been filled out, click Save
4. If you've picked a Choice field, you need to now add the drop down options for your Choice field. This is a requirement for this field otherwise you won't have anything to select from when your office or field staff use this field! Once your field is saved, click Edit on the field again and you'll see an Options section. All you need to do here is type in the Label field your first dropdown option and click Add Option once done, repeat for multiple options. It's important to note that you should not touch the Value field of these choices.
Make the field apply to specific user categories
Edit any created Extra Field and under the Visible to heading, select/deselect which user types will be able to see this extra field.
Make the field only show up for certain asset types, variants, clients etc..
You may require a large number of fields that are only applicable for certain asset types, variants, properties or client. For example, the FRL field should only show if the Asset is of type "Door" or a unique id needs to be filled out on a property for a certain client.
Edit the field you are wanting to add this to, and click Add Condition. You are given two areas you need to fill out, a key and a value.
Note for a extra field condition, you can only use keys from related objects, for example:
asset -> assettype
asset -> property
asset -> property__client
property-> client
Note that there is a difference between property__client and client. When creating a extra field for an object that belongs a property such as assets, property__client needs to be used to only make it visible to the client. However if the property is the object type, then client needs to be used as it is referring to the property itself and not the object belonging to the property.
The following common conditions have been outlined below, contact support to enquire about other possible conditions:
Only applicable to certain asset type:
key = type
value = id/s of asset types in your system you want this field to be applicable to
Only applicable to a certain variant:
key = variant
value = id/s of variants in your system you want this field to be applicable to
Only applicable to a certain client:
key = property__client
value = id/s of clients in your system you want this field to be applicable to
IMPORTANT NOTE - ensure the condition ID's are entered without any spaces and kept on the same line. If the same key is used with a different ID on each new line, the mobile app interprets this to only display if ALL of the conditions are true.
The variant id can be found in the URL when you view any variant on the asset type.
Filtering by Extra Field
Filtering by extra field is as simple as selecting the field from the Add filter drop down list, and is available on the following pages:
Tasks
Assets
Make sure that you select either Task or Asset as the Object Type when creating the extra field in order to make that filter available on the Tasks/Assets pages respectively.
Filtering logic of extra fields
The filtering logic is determined by the extra field widget type so take this into account if you plan on using the extra field as a filter. See the table below to understand the filtering logic for each widget type:
Widget Type | Filtering logic |
Text, Multiline Text | Contains/Does not contain |
Choice | Is/Is not |
Date | Fixed date/Relative to now |
Integer | Number field and slider |
Managing extra fields against assets/asset types
You can get an overview of extra fields set against assets and asset types by going to:
Control Panel > Asset types > View the asset type > Custom Fields.
This overview provides a summary of configuration elements such as:
Field name
Widget
Permissions
Restricted to variants
Restricted to clients
The Customise button in the upper right corner of the summary is a direct shortcut the Extra fields section of the control panel, where you can edit or create new extra fields.
An Example to get you started
You're on the Extra fields configuration page and you're adding a few new fields - one new field on your properties to help determine whether this property has a Fire Engineering Report and another new field on your assets for Fire Resistance Level of that asset.
Field 1:
Label: Fire Engineering Report
Key: fireengineeringreport
Object type: property
Widget: Choice (which I later add 'yes' and 'no' to the drop down options)
Required: Yes
Field 2:
Label: FRL
Key: frl
Object type: asset
Widget: text
Required: No
