Settings > Custom Fields
Custom Fields are used to track information that is not already in System Frontier by default.
Managing Custom Fields
In some cases you will need to have additional information available for use in System Frontier. Perhaps you have a Custom Tool that you’ve built which requires the user to select an option from a list of items. You would create a Custom Field to hold that list of items. Maybe the tool asks the user to enter the path to a specific folder or a process name. You could use a Custom Field so that the user could enter that info.
Or, maybe you need a Custom Field to capture unique information regarding computers, like a lifecycle date or a help desk ticket number.
On the Custom Fields page you can create a new or edit an existing Custom Field, sort, filter Custom Fields, and set the visible number to show per page.
Clicking on a Custom Field Name or clicking the New button, will open the Edit Custom Field page:
Whether adding or editing a Custom Field, you will need to enter data into these fields:
- Name. Only use letters, numbers, hyphens, and underscores for the name. Spaces are not allowed.
- Description. Be concise.
- Data type. The Data types that can be used are: Text, Number, CheckBox, ListBox, Date, MaskedText, URI, ListToCsv, and FileContent.
- Validation (Regex). Uses ECMAScript compliant regular expression patterns.
- Lookup Value(s). Enter values separated by semicolons.
- Class mapping. This is an optional field. Selections are Computer, Container, Role, and UserAccount.
Text – normal text can be entered.
Number – numbers can be entered.
CheckBox – allows selection of an item by placing a check box beside it.
ListBox – a dropdown list of options to choose from.
Date – accepts date format. Gives you a date picker pop-up as well.
MaskedText – hides the entered data (like for a password field).
URI – a URL that can be used to dynamically pass data to web-based applications, such as a ticketing system or a data reference site. When used with a Class Mapping value of Computer, the URI value will be represented as a link based off of the URL template entered into the Lookup value(s) field.
ListToCsv – will take text pasted into a textbox and transform it into CSV format for use by the Custom Tool. This can be helpful if the script used in the Custom Tool only accepts CSV-formatted data.
FileContent – will take text pasted into a textbox and save it into a temporary file. It passes a reference to that file to the Custom Tool’s command line. This Data type can also give you more flexibility to do more complex things, if desired.
MultiSelect – a dropdown list of items to choose from that allows multiple selections.
Table – a table showing additional information that allows a single item to be selected. A preprocessor is required for this custom field.
Custom Fields can have regex validation as well. Place your ECMAScript compliant regular expression pattern into the Validation field and when the user runs the tool, the Custom Field in the form will require appropriate data entry.
The ListBox and URI Data types rely on the values placed into the Lookup Value(s) field. Each value is separated by a semicolon.
The Preprocessor Method
The Lookup Value(s) can also be pre-populated by the Preprocessor method. Custom Fields that would have Lookup Values defined, but need to have those values dynamically created instead of manually entering them one time, can use a Preprocessor. An example of this is showing a list of services on a computer in a ListBox instead of you typing some services into the ListBox Lookup Value(s) field manually. That list of services could change, so being able to have the list generated dynamically is a great option.
Currently, only the Computer value is used in Class Mapping. You normally wouldn’t select a Class Mapping if you were creating the Custom Field for use in a Custom Tool. If you select the Computer value in Class Mapping, then that Custom Field can be displayed when you view the Summary tab of a computer:
When you click on the Edit button in the Custom Fields section of the Computer Summary tab, you will be able to enter and store the Custom Field data in System Frontier for that computer:
Adding a Custom Field
To add a Custom Field, click on the New button on the Settings > Custom Fields page. Fill in the fields with the information referenced above in the Managing Custom Fields section of this document.
Modifying a Custom Field
To edit a Custom Field, click on the Custom Field that you wish to modify and the Custom Field (Edit) page will appear. Change these fields as needed, referring back to the Managing Custom Fields section above, and click Save.
Deleting a Custom Field
To delete a Custom Field, click on the Custom Field that you wish to delete. Then, on the Custom Field (Edit) page at the bottom, click the Delete link.
Be sure to read the User Guide for more information.