---
title: Adding a new CMDB Class/Table
slug: v111/adding-a-new-cmdb-classtable
icon: {"faIcon":"fa-solid fa-wand-magic-sparkles"}
docTags: 
createdAt: 2025-06-10T06:11:25.877Z
---

# Overview

Adding a new class requires the creation of a new Servicely table, defining the view definition and then the addition of a record in the CMDBMetadata table. To provide a step by step guide on this, this will be done using a specific scenario. This scenario being; we wish to add a new CI class representing Apple laptops as there are special attributes that we wish to capture that do not belong on the general CMDBLaptop CI class, has enough custom fields to warrant its own table.

# Choose the parent CI class

You can view the existing physical tree by choosing the *View Physical *CMDB* Tree* menu item in the CMDB/Administration section of the left hand menu.

The obvious parent CI class is CMDBLaptop in this scenario, however in other scenarios in my not be as clear. Because CI class inheritance is an **is-a** relationship the question must be asked if the new CI class really is a version of the parent CI class. You might want to choose CMDBEndUserDevice as the parent CI class, but then you would not have available the attributes on CMDBLaptop and might have to duplicate them. The general idea is to place the new CI class as low in the tree as it needs to go to make attributes available that it needs.

# Create the new {{CMDB}} Table

Choose *Application/Table/Create new table* from the left hand menu, which will open up Form Builder

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/T1ZEjnRM71ynGJ4neVFBh_image.png)

Fill in the table details. You can ignore *Menu creation* for now as it is sometimes unclear how the menu structure should look for CI classes, so choose None for that choice.

The convention is to give CI classes a name that starts with CMDB to distinguish them from other tables in Servicely. We’ll make the table label CMDB* Apple laptop* as that fits the naming convention used throughout the CMDB. This will make the table name CMDBAppleLaptop. The label is used as a more friendly version of the table name in the UI.

We search in the parent table list for * laptop* as that is the parent table we want.

All the settings in the *Advanced options* panel can be left at their defaults.

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/LV2Fd-ZHBdI9GyL6Uo9Qy_image.png)

We that has been filled in you can click on the *Save table and configure fields *button to start adding fields. After clicking we get the add fields modal

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/0dT5qFN5nMQarQqdFa_ZZ_image.png)

We will add one field named *Chip family* which will be a *Choice* field with two possible values: Intel or Apple Silicon. You can use the *Choice* editor to add the choices at this stage by typing the choice label into the *Choice label* box and clicking *Add/Update*. The *Choice key* and *Order* will be generated automatically.

All other settings on the other panels can be left at their defaults

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/yujio8wa_QvTwbn9X3Cjp_image.png)

Click the *Create* button to add the field. *Create and new* is a a shortcut for adding the field and then re-presenting the add field modal again to add more, but we only have the one in this scenario.

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/DRwU1MVeVWYUcN1H5VJim_image.png)

You will see that the field has been added to the form. You can modify the form as you wish at this stage but there is an important consideration to not add any other fields to the form from the *Available fields* list on the right. This is because we are creating a View Definition fragment in this scenario to take advantage of the rollup capability of CMDB forms. 

Click the Save button to save the newly created table to the database. A progress modal will appear.

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/ydpJZnd63qO2VpSFlw-Om_image.png)

# Add CMDBMetadata record

When it has finished the form will appear. Note that this will not display the rollup capability until the metadata record has been added to the CMDBMetadata table for the newly created CI class

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/bXxrFmdw3g8jnFgUJgMJa_image.png)

Choose the *CMDB/Administration/CMDB metadata* menu item and you will see the existing records

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/PrMxojNC3XLAPUiTfWEO1_image.png)

Click the *New *button to create a new record. The create form will open

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/OAA2wJugptFoIxLl9s3h7_image.png)

The *Name* by convention is the underlying table name so it will be *CMDBAppleLaptop*. The *Title* is by convention is the underlying table label and so it will be CMDB* Apple laptop*. The logical domain can be *Abstract domain* for now. It is important that *View definition is fragment* is set to true for rollup behaviour to work. Icon selection and custom infobox template can be left alone for now as the defaults are acceptable.

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/9iravFVyY6-S5_jy-reyF_image.png)

Click Create to create the record

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/l9qmoXCi0GFxik_39YJF1_image.png)

Now if you go to the URL /#/CMDBAppleLaptop/\_create you will see the rolled up view definition with all the other fields and view definition fragments made available on tabs. You will notice that there is no table for CMDB Laptop - this is because it currently has no fields. In one were added then a tab would appear automatically.

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/_DeO9l1a7cUFStqheImRY_image.png)

# Add a CMDB relationship

Let’s create an Apple laptop and add a relationship between it and a router. Fill in the form as follows and click Create.

Go to the URL /#/CMDBRouter/\_create and fill in the form as follows and click Create

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/9qUwePTtCQZW9qOJQJ7yZ_image.png)

Go to the menu item *CMDB/Relationships/New relationship* and fill in the form as follows and click Create

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/Eaui6Xn-qw1h1z9_Im8WK_image.png)

Go to the list of all CMDB Apple laptops by going to the URL /#/CMDBAppleLaptop

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/g6f3KLnnkro716u_iyusG_image.png)

Click on the first record and you will see the record form. It now has one relationship

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/d2KYFs-tPJVefaivT2bXj_image.png)

# View related CIs

Click on the *View related items button* to see the CMDB diagram

![](https://api.archbee.com/api/optimize/RDSPJwtKQ5B5sE-oMCN16/kp0EXtepuqf9Mgl2DOz1i_image.png)