Custom fields

SA can store a large amount of information about your managed servers. Custom Fields provide a way for you to store additional information about your servers quickly and easily. Custom Fields are data elements you can create for servers and device groups.

When you create a custom field for servers, every server in your managed environment gets an instance of the custom field. When you create a custom field for device groups, every device group gets an instance of the custom field. The value of the custom field can be different for each server or device group.

For example, if your managed environment contains 500 servers and you create a custom field for servers, you would have 500 separate custom fields, one for each server. If you had 75 device groups and you created a custom field for device groups, you would have 75 separate custom fields, one for each device group.

Tip Custom attributes are another way to store additional information about your servers. For more information on custom attributes, see Creating a custom field with the custom field management web extension. See also Comparing custom fields and custom attributes.

Data types in custom fields

Custom fields are typed. Each custom field you create must be of one of the following types.

Custom field data types

Custom field type

Description

String

Any characters, up to a maximum of 3999 characters.

Long String

Any characters. Use this type for strings longer than 3999 characters.

URI

A string representing a Uniform Resource Identifier.

Date

A date.

Number

A positive or negative integer.

File

An attached file.

Creating a custom field with the custom field management web extension

The Custom Field Management web extension lets you create and delete custom fields.

Note
To create or delete custom fields, you must have the following permissions: Manage Virtual Columns, Execute permission on the Web Extensions folder in the Library, and Read access to at least one managed server. For more information on permissions, see the SA Administer section.

To create a custom field:

  1. In the SA Client navigation pane, select Library and the By Type tab.
  2. Select Extensions, then select Web.
  3. Select the Custom Field Management extension and either right click or select Actions > Run.... This displays the Custom Field Management window as shown below.

    Custom field management web extension - Create a custom field


  4. In the first drop-down list, select the object you want the new custom field to be associated with. If you select Server, every server will get an instance of the custom field. If you select Device Group, every device group will get an instance of the custom field.
  5. Enter the name of the new custom field in the text input field.
  6. In the second drop-down list, select the data type of the custom field. See Data types in custom fields.
  7. Select Process Input to create the custom field.

Editing custom field values

To edit custom field values for a server:

  1. In the SA Client navigation pane, select the Devices tab.
  2. Select the All Managed Servers node.
  3. Select a server.
  4. To view the custom fields and values, select Properties from the View drop-down selector. This displays several different properties of the server including all the custom fields defined for the server.
  5. Select Actions > Open to open the server browser, or right click the server and select Open. This displays information about the server. Select the Information tab, then select Properties in the navigation pane. This displays several different properties of the server including all the custom fields defined for the server.
  6. Locate the custom field you want to modify.
  7. The way you modify the value of the custom field depends on the type of the custom field. Modify the value of the custom field.
  8. Select File > Revert to discard all your changes to custom field values.
  9. Select File > Save to save the modified custom field value.

Deleting a custom field with the custom field management web extension

The Custom Field Management web extension lets you create and delete custom fields. To delete a custom field:

Caution When you delete a custom field, you delete all the values stored by all the servers or device groups associated with the custom field.

  1. In the SA Client navigation pane, select Library and the By Type tab.
  2. Select Extensions, then select Web.
  3. Select the Custom Field Management extension and either right click or select Actions > Run.... This displays the Custom Field Management window as shown in Creating a custom field with the custom field management web extension.
  4. Select the “Delete a Custom Field” link. This displays the Delete a Custom Field Definition window as shown below.

    Custom field management web extension - Delete a custom field


  5. To delete a custom field defined for servers, select a custom field name in the first drop-down list. The example above shows the custom field FIRMWARE_VERSION selected.

    To delete a custom field defined for device groups, select a custom field name in the second drop-down list.
  6. To delete a custom field defined for servers, select Delete Custom Field Definition from Servers.

    To delete a custom field defined for device groups, select Delete Custom Field Definition from Device Groups.