Configuring Custom Fields for CMDB

Owned by Enterprise IT
May 29, 2024
8 min read

SummitAI Service Management Help

Configuration Management Database

You can add new Custom Fields using the Form Builder for the CMDB sub-module of the Service Management module.

To Configure Custom Fields for CMDB:

  1. Select Admin > Basic > Infrastructure > Form Builder.
  2. Select the Module name as CMDB. On the ACTIONS panel, click ADD NEW.
  3. Under the FORM DETAILS tab, select a Tenant from the Tenant list and Classification from the Classification list.
  4. Select the tab in the Select Tab field under which the Custom Fields should be added. Click NEXT.


Figure: FORM BUILDER page: FORM DETAILS tab

4. Under the FORM BUILDER tab, you can select the Custom Fields to be displayed on the page. From the left- hand side panel, select the type of field that you want to add from the Simple Controls, Group Templates, Form Templates sections. Drag and drop it in the central section of the page.

5. Based on the field type selected, the properties are displayed under the PROPERTIES section on the right-hand-side panel.Fill in the required property details.

6. Click the Plus icon to make a copy of the Custom Field and the Delete icon to remove the Custom Field. You can also change the sequence of the fields by dragging them up and down. For more information about the various types of fields and their properties, see Field Description.

7. Click the SAVE AS TEMPLATE button to save the Form as a template. On the Save Form pop-up page, type in the name for the Form in the Form Name text box and click SAVE.  The saved Form is available under Form Templates and can be re-used.

Save Form pop-up page
Figure: Save Form pop-up page

8. If a Group is selected, the SAVE GROUP AS TEMPLATE button is displayed. Click the SAVE GROUP AS TEMPLATE button to save the selected Group. On the Save Group pop-up page, type in the name for the Group in the Group Name text box and click SAVE. See Screen Shot. The saved Group is available under Group Templates and can be re-used. Click NEXT.

Save Group pop-up page
Figure: Save Group pop-up page



Figure: FORM BUILDER page: FORM BUILDER tab

        9. Under the PREVIEW tab, you can view the Custom Fields that you added.

       10. Click SAVE. The Custom Fields are configured.

PREVIEW tab
Figure: FORM BUILDER page: PREVIEW tab

Field Description

The following table describes the field types and their properties on the FORM BUILDER page under the FORM BUILDER tab:

Field

Description

Group

Click Group to create a group under the tab. Use this to group related fields. Type in the required values for the following properties:

  • Label: Type in the label name of the group.
  • No. of Columns: Select the number of columns that can be added under the group. You can add maximum of two columns.
  • Multivalued Group: Click Is Multivalued Group to indicate that multiple fields can be added under the group.

Note: If Multi-Valued Group is selected, user can enter multiple records for the group. The records will be displayed in Grid view.

Text Box/ Text Area

Click Text to create a text box field. Click Text Area to create a text box field that allows more characters compared to text box field. For example, for User Name, use Text and for User Comments, use Text Area. Text and Text Area have the following fields:

  • Label: Type in the label name for the text box or text area.
  • Required: Select the Required check box to make the text box or text area a mandatory field.
  • Tooltip Text: Type in the tooltip text for the users to help them in typing in details in the field.
  • Watermark Text: Type in the watermark text that should appear in the text or text area field if the user does not enter any information in the field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Length Limit: Specify the length of the field by entering values in Min and Max fields.

Check Box

Click Check Box to create a check box field. Type in the required values for the following properties:

  • Label: Type in the label name for the check box.
  • Required: Select the Required check box to make the check box a mandatory field.
  • Tooltip Text: Type in the tooltip text for the users to help them in typing in details in the field.

Drop-down

Click Drop-down to create a drop-down field. Use this field to add an attribute for which the user needs to select from multiple available options. Type in the required values for the following properties:

  • Label: Type in the label name for the check box.
  • Required: Select the Required check box to make the check box a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Parent: Select the parent for this drop-down list. The values of this drop-down list depends upon the value selected in the Parent drop-down list.
  • Options: Type in the values that should appear in the drop-down list. If a Parent drop-down list is selected, select the parent value and the corresponding value in this drop-down list.

      Note: Custom fields mapped based on manual entry or custom entry. 

Date

Click Date to add a date field. Type in the required values for the following properties:

  • Label: Type in the label name for the date field.
  • Required: Select the Required check box to make the date field a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in selecting date for this date field.

Number

Click Number to add a number field. For example, Maximum Approvals Required. Type in the required values for the following properties:

  • Label: Type in the label name for the number field.
  • Required: Select the Required check box to make the number field a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering number values for this field.
  • Minimum/ Maximum: Specify the range of numbers that can be entered in this field by entering values in the Above and Below fields.
  • Integer Only: Select the Only accept integers check box to allow users to enter only integers. Any number without any decimal value is called an integer. For example, 121, 57, 23 are integers. However, 20.1, 56.8, 13.01 are not integers.

E-mail

Click E-mail to add a field for entering e-mail ids. Type in the required values for the following properties:

  • Label: Type in the label name for the e-mail field.
  • Required: Select the Required check box to make the e-mail field a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering value for this e-mail field.

File

Click File to add a field where files can be added. Type in the required values for the following properties:

  • Label: Type in the label name for the file field.
  • Required: Select the Required check box to make the file field a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering value for this file field.

Price

Click Price to add a field where prices can be added. For example, Project  Cost. Type in the required values for the following properties:

  • Label: Type in the label name for the price field.
  • Required: Select the Required check box to make the price field a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering price for this field.
  • Units: Type in the unit based on which the price should be calculated, for example, per hour or per piece.

Website

Click Website to add a field where website URLs can be added. Type in the required values for the following properties:
Label:

  • Label: Type in the label name for the website field.
  • Required: Select the Required check box to make the website field a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering website URL for this field.
User

Click User to add a field where the users can be searched. Type in the required values for the following properties:

  • Label: Type in the label name for the User field.
  • Required: Select the Required check box to make the User field mandatory.
  • Size: Select the size of the field, Small, Medium, Large.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering price for this field.
Hyperlink

Click Hyperlink to add a field where hyperlink URLs can be added. Type in the required values for the following properties:
Label:

  • Label: Type in the label name for the hyperlink field.
  • Required: Select the Required check box to make the hyperlink field a mandatory field.
  • Tooltip Text: Type in the tooltip text for the users to help them in entering hyperlink URL for this field.
  • URL: Specify the required hyperlink URL. The character length of the hyperlink URL must not exceed 200 characters. The users can edit or specify a new URL under the ADDITIONAL INFORMATION tab while creating/updating a CI. For more information, see ADDITIONAL INFORMATION tab.

Note: This control is not applicable for Multivalued Group control.

MV Dropdown

Click MV Dropdown to create multi value drop-down field. Use this field to add an attribute for which the user needs to select from multiple available options. Type in the required values for the following properties:

  • Label: Type in the label name for the check box.
  • Required: Select the Required check box to make the check box a mandatory field.
  • Size: Select the size of the field, Small, Medium, Large.
  • Parent: Select the parent for this drop-down list. The values of this drop-down list depends upon the value selected in the Parent drop-down list.
  • Options: Type in the values that should appear in the drop-down list. If a Parent drop-down list is selected, select the parent value and the corresponding value in this drop-down list.

      Note: Custom fields mapped based on manual entry or custom entry. 

Formula

Click Formula to add a field where a formula can be provided. For example, Average Cost. Type in the required values for the following properties:

  • Label: Type in the label name for the price field.
  • Size: Select the size of the field, Small, Medium. 
  • Tooltip Text: Type in the tooltip text for the users to help them in entering price for this field.
  • Formula: Type in the formula in the following text area.

Note: To use the Formula control, the controls should be configured, which contain number as a field value. For example: Drop-down, Number, and Price. For example: Drop-down, Number, and Price.

Group Templates

This section displays all the saved Group Templates. Drag and drop a Group Template to add a group of fields to the Form.

Form Templates

This section displays all the saved Form Templates. Drag and drop a Form Template to add a group of fields to the Form.

ACTIONS

This section explains all the icons displayed on the ACTIONS panel of the FORM BUILDER page.

SHOW LIST

Click SHOW LIST to display the LIST table showing all the configured Custom Fields for the selected Tenant.


Figure: FORM BUILDER page: List of CMDB Custom Fields

To update a Custom Field, select the respective tab name check box and click the EDIT icon on the ACTIONS panel. Make appropriate changes and click SUBMIT. To display the inactive Custom Fields, click the Include Inactive check box.

Note:

When the Custom Fields are displayed under the LIST table, the ADD NEW action is displayed on the ACTIONS panel. Click ADD NEW to configure a new Custom Field.

EDIT

Click EDIT to edit a Custom Field. Select the check box for the tab name whose Custom Fields you want to edit and click the EDIT icon.