Adding Custom Location Fields

Custom location fields extend the information available to be stored for locations, beyond the general system fields. You will first need to add a custom location field group, as a higher-level category, for facilities, zones, cage, rows, and/or racks.

Once the higher level group has been added, then add custom fields to the corresponding group in which they belong.

Access the Custom Location Fields page

1. From the Ubersmith Dashboard, click Settings.
   
   The Ubersmith Settings page appears.
2. From the Devices section, click Custom Location Fields.
   
   The Custom Location Fields page appears.

Complete the Add Custom Field Group

A custom device field group is a higher-level category that contains associated custom fields to be applied to facilities, zones, cages, rows and racks within locations. The Custom Location Field page contains a tab for each of these discreet areas within a location, so you can add custom groups and fields for each area.

1. From the Custom Location Fields page, click either the Facility, Zone, Cage, Row or Rack tab that needs a custom group.
    
2. From the tab you selected above, click Add New Custom {name of tab} Field Group.
   The Add Custom Field Group page appears.
3. In the Name field, enter the name of the group you want to display on the Custom Location Fields page for the facility, zone, cage, row or rack tab.
4. In the API Variable Name field, click edit and enter the corresponding API name for the custom device field group, if you want the API variable name to be different from the system-generated name.
5. Click Save or Save & New.
    

Complete the Add Custom Field page

Once a custom field group has been created, individual custom fields can be created in order to assign them to associated location areas. This page provides the means for custom fields to display on the Custom Location Field page {Location Area} tab.
 

1. From the Custom Location Fields page, click add custom field.
   The Add Custom Field page appears.

Complete the Details tab

1. In the Label field, enter the name to display to the user for the custom field.

2. In the Type field, select the type of expected input information for the custom field; either a select box, multiple select box, text area, check box, or date.
    

   Click here to view Type field inputs

    Text Input

   1. In the Field Size field, enter the number of digits to define the size of the custom field.
   2. In the Default Value field, enter the default value to display in the custom field.
   3. In the Regular Expression Match field, enter the rule for the data that will get entered in the custom field.
   4. In the Regular Express Help Text field, enter the message that will be shown to the user about the regular expression match.

   Select Box

   1. In the Enter possible values on separate lines field, enter the available selection choices.
   2. In the Default Value field, enter the default value to display in the custom field.

   Multiple Select Box

   1. In the Enter possible values on separate lines field, enter the available selection choices.
   2. In the Default Value field, enter the default values to display in the custom field.

   Text Area

   1. In the Rows field, enter the number of rows the text area should contain.
   2. In the Columns field, enter enter the number of columns the text area should contain.
   3. In the Default Value field, enter the default value to display in the custom field.

   Check Box

   • In the Default Value field, either select or leave blank to have the custom field be checked or blank.

   Date

   • In the Default Value field, enter the date to display in the custom field.
3. In the API Variable Name field, enter the name to be used as the API variable name. Clicking edit enables the field to be change.
4. In the Group field, select the associated custom device field group for this field.

5. In the Client Access field, select either none, view, or edit to configure the level of access the client will have from the Client Portal.

   Note

   The Client Access field enables you to configure your client's access for a device, although almost no device types provide edit privileges.

6. In the Required field, select this field if the custom field will be required to be completed.
7. In the Unique field, select this field if the custom field should be unique across all custom field values of this type.
8. In the Show In Lists field, select either No or Position 1 through Position 5, to configure where the field will display in the device list in the Device Manager or the client’s devices in the Client Manager.

9. Click Save or Save & New.