Configuration Items
On this page
A configuration item, or CI, belongs to one of fourteen classes: Computer, Hardware, Software License, Document, Network, Configuration, Service, Tracked Software, Contract, Library Item, Group, Location, Organization, and Person. So people, locations, and organizations are configuration items too. This topic covers the five classes under Configuration Management in the sidebar (Computers, Hardware, Networks, Documents, and Configurations) and the All CIs list.
In the Web App
What each class holds
Computer, hardware, network, document, and configuration records share a common set of fields: a name, a type, a category, a status, an owner, an organization, a location, a data segment, and notes. Beyond that shared set, each class holds its own fields:
| Class | Holds |
|---|---|
| Computer | The audited machine: computer name, domain, workgroup, CPU, CPU count and speed, core count, RAM, HDD and free HDD space, SSD, display adapter, monitor, LAN card, MAC address, primary IP address, operating system name, version, and service pack, virtual machine and hypervisor flags, its host, network, audit date, last logged-on user, and a picture, plus every field that Hardware holds. |
| Hardware | A non-computer device: manufacturer, model, product, serial number, install date, network, primary IP address, audit date, and a picture. |
| Network | Its IPv4 address range, its IPv6 address range, and its domain. |
| Document | The tracked document: title, author (a person), version, keywords, and the date it was last reviewed. |
| Configuration | Nothing beyond the shared fields except an associated CI. The rest of what a configuration represents comes from field customization and from its relationships; see CI Relationships. |
As shipped, a configuration's associated CI can be a computer, document, group, hardware, location, network, organization, person, service, software license, or tracked software record. On the configuration form, the associated CI lookup sits next to a read-only summary that, once a CI is chosen, shows that CI's name, class, type, category, and status.
On the default forms, the tabs of each class are listed below. A computer has the Virtual Machines tab only under the conditions given in A computer's Configuration tab.
| Class | Tabs |
|---|---|
| Computer | General, Activity, Configuration, Virtual Machines, Software (with Discovered Installations and Allocated Licenses), Finance, Custom Data, Related Objects, Ticket History, Notes, History, Attachments |
| Hardware | General, Activity, Configuration, Allocated Licenses, Finance, Custom Data, Related Objects, Ticket History, Notes, History, Attachments |
| Network | General, Activity, IP Addresses, Custom Data, Related Objects, Ticket History, Notes, History, Attachments |
| Document | General, Activity, Custom Data, Related Objects, Ticket History, Notes, History, Attachments |
| Configuration | General, Activity, Custom Data, Related Objects, Ticket History, Notes, History, Attachments |
A form shows the Custom Data tab only when the class has custom fields placed on that tab, and the custom data section of the General tab only when the class has custom fields placed on the General tab.
On a computer, document, or configuration record, the Ticket History tab's count is the number of tickets that name the record as their related CI.
Records at the inactive status
A record at its class's inactive status opens read-only: every field is locked, Save is disabled, and its attachments cannot be edited. A record also opens read-only in this way when you do not have the right to edit records of its class. On a read-only computer or hardware record, the Allocate and Deallocate buttons of the Allocated Licenses tab are disabled, and so is the Reconcile button of a computer's Discovered Installations tab.
The picker of a field that selects a computer, hardware, network, document, or configuration record leaves records at the inactive status out of its search and offers no switch to include them. A record with no status is still found. The picker that chooses the target of a merge is the exception: it searches records at the inactive status too, but a merge onto a computer or hardware record at the inactive status is refused. The related-objects picker shows a Closed switch; while the switch is off, its search leaves those records out too. Outside a record's tabs, the built-in default view of a list also leaves out records at the inactive status when the list has a Status column and its default view sets no filter of its own.
Workflow triggers, which are all of the On Condition kind, no longer select a record at the inactive status, so no trigger runs on the record or sends a notification about it. An action marked as a reopen action is offered only while the record is at the inactive status of its class. An action that lists no statuses is offered at every status except the inactive one, so a record at the inactive status is offered only the reopen actions and the actions that list the inactive status among their statuses.
A computer's General tab
On the default computer form, the General tab has two columns:
- The first column holds Details (the ID, status, name, description, and install date), Categorization (data segment, type, tags, and category), Ownership Information (organization, owner, and location), the custom data section, and the lines that say when and by whom the record was created and modified.
- The second column holds the picture, Identification (computer name and serial number), and Product (manufacturer, model, and product).
The computer name and serial number are on the General tab, not on the Configuration tab. The Details, Categorization, Ownership Information, Identification, and Product sections can each be collapsed. The created and modified lines are not shown while you create a new record, and for a record that the system created they name no user.
A computer's Configuration tab
On the default computer form, the Configuration tab groups the audited fields in three columns, followed by the computer's IP addresses:
- Operating system; CPU (CPU, CPU count, CPU speed, core count); disk and memory (HDD, free HDD space, RAM, SSD).
- Virtualization (the virtual machine and hypervisor flags and the host); network (domain, workgroup, network, LAN card).
- User activity (last logged-on user); audit information (the audit date and a button that opens the computer's audit); display (display adapter, monitor).
The audit button stays disabled until the computer's audit date has a value. It opens the audit in a new tab, or downloads it as a file when no viewer address is available; see Inventory Data and Audit Conflicts.
Only a computer can be the host of a virtual machine. A guest names its host in the virtualization section of its Configuration tab. A saved computer that is marked as a hypervisor, or that another computer already names as its host, also has a Virtual Machines tab that lists the computers whose host it is. Adding computers there sets this computer as their host. Deleting a row clears the guest's host and leaves the guest computer in place.
A hardware record's Configuration tab
On the default hardware form, the Configuration tab holds the record's network and audit date, followed by its IP addresses.
The Finance tab of a computer or hardware record
A computer's or hardware record's Finance tab shows the fields of the asset associated with the record, all read-only. The asset is a separate record that names the computer or hardware record as its associated CI; the two are joined by that association, not by being the same record. The tab is shown whether or not an asset is associated. On the default forms, it has three columns:
- Finance (purchase order, purchase date, vendor, SKU, invoice number, quantity, unit cost, and price) and Lease (lease and lease return date).
- Asset (the asset's ID, name, asset tag, and barcode) and Additional Dates (received date, retirement date, warranty expiration, last inventory date, and who took that inventory).
- Depreciation (depreciation method, salvage value, lifespan, last depreciation, and current value) and Stock Room (the stock room).
Pictures
A computer or hardware record holds one picture. On the default computer and hardware forms, the picture sits at the top of the General tab's second column, above Identification. On the form, you add it by clicking the picture field or dropping an image file on it, and remove it with the field's clear button. A PNG image is stored unchanged. Any other image is shrunk so that its longer side is at most 300 pixels, turned upright, and stored as JPEG. A file that does not decode as an image leaves the record with no picture, as the clear button does.
All CIs
All CIs lists configuration items of all fourteen classes, not only computers, hardware, networks, documents, and configurations. It is always the last entry under Configuration Management in the sidebar, whatever entries are added above it. On the Advanced Search page, All CIs is one of the entries at the top of the class picker; in the related-object class picker, it is under the picker's Groups heading. You cannot create a record from All CIs, and it does not offer batch update; it has a preview pane and an Actions menu.
All CIs is a list only; it has no record form of its own:
- Opening a row in the current tab, by double-clicking it or with Open, opens that record's own form: a computer row opens the computer form, a location row the location form.
- For one row, or several rows of the same class, the Actions menu offers that class's actions, and Delete follows that class's own delete permission. Without it, Delete is disabled.
- For rows of more than one class, the Actions submenu reads "No Actions" and Delete is disabled under "Permission denied".
Network identity (IP and MAC)
A network holds its own IPv4 and IPv6 address ranges. A computer record also holds a MAC address; a hardware record has no MAC address field.
Each IP address is its own record under a network, and links bind addresses to objects. One object can link several addresses. A computer or hardware record also keeps a single primary IP address field, which stays in step with the links:
- Marking a link primary writes its address into the primary IP address field.
- Deleting the primary link clears the field.
- When the field itself is set, the address is created and linked as primary, and the object's links to other addresses that were not set by hand are removed.
- An object can have only one primary link.
The IP address list of a computer or hardware record
The IP address list on the Configuration tab of a computer or hardware form has these buttons:
- Attach IP opens a blank IP address flyout for this record.
- Set Primary IP Address marks the selected address as the primary one. It is enabled only when exactly one row is selected.
- Release IP deletes the link between the record and the selected addresses. The IP address records themselves are not deleted.
Double-clicking a row opens the address in the IP address flyout, not in a full form. The flyout is editable when you can edit the computer or hardware record.
The IP address flyout
The flyout holds, in order, a network lookup, an IPv4 option with the IPv4 address field and a Suggest button, an IPv6 option with the IPv6 address field, and notes. Choosing one option blanks the other address field and makes it read-only. Suggest is disabled while no network is selected or the flyout is read-only; otherwise it asks for a free address on the selected network.
When you edit an address that already exists, the flyout also shows a read-only Used table (ID and name) of the records that hold the address, each a link that opens the record in a new tab. A new address has no Used table.
A network's IP Addresses tab
A network's IP Addresses tab lists the addresses whose network is this network. Its toolbar offers only a Delete button. An address opened from this tab always opens read-only.
Merge duplicate computer or hardware records
When one device has two computer records, or two hardware records, you can merge one record into the other. On a computer or hardware form whose layout shows it, the toolbar has a Merge with button. It opens a drawer for merging the open record, the source, into a target record that you pick. The target picker also finds records at the inactive status, but a merge onto a computer or hardware record at the inactive status is refused; see Records at the inactive status.
The drawer offers four overwrite modes, in this order, and starts at the first:
- The first mode overwrites only blank values: a source field that has a value is copied into the target's field when the target's field is blank.
- The second mode overwrites no values: no field is copied.
- The third mode overwrites all values: a source field that has a value is copied into the target's field whether the target's field is blank or not.
- The fourth mode overwrites only non-blank values: a source field that has a value is copied into the target's field only when the target's field already has a value.
The mode also decides the tags. With the third or the fourth mode, a target that has tags ends with exactly the source's tags, or none if the source has none. With the first or the third mode, a target that has no tags receives the source's tags.
Whatever the mode, the records that depend on the source move to the target. Among them:
- Its relationships, on both sides. A relationship that the target already has with the same record and of the same type is dropped from the source first, and a relationship that would link the target to itself is deleted.
- The configurations whose associated CI is the source.
- The virtual machines whose host is the source.
- Its discovered software, except the products the target already has discovered.
- Its license allocations, except allocations of a license that is already allocated to the target.
- Its IP address links, except links to an address the target already links. When the target has a primary IP address, the moved links are not primary.
- Its attachments, except an attachment the target already has.
The source's audit snapshots move as a set, and here the mode matters. With the third or the fourth mode, the source's snapshots, if it has any, replace the target's; with the first or the second mode, they move only when the target has none.
The merge also handles the source's associated asset (see The Finance tab of a computer or hardware record). If no asset is associated with the target, the source's asset becomes the target's asset. If the target already has an asset, the source asset's fields that have a value are copied into the target's asset under the chosen mode, with nothing copied under the second mode.
A merge in the Web App always removes the source record: once its data has moved, the source computer or hardware record is deleted. An asset that is still associated with it at that point is detached, not deleted: it stays as an asset with no associated CI.
When the merge finishes, the drawer refreshes the lists of the class and closes the source record's form. It also opens the target in a new tab while the drawer's go-to-target setting is on, as it is when the drawer opens.
In the Default Workflow
A new 2026.1 database created with the Default Workflow (see Default Workflow Configuration) contains the items below. An upgraded database need not contain them, and an administrator may have changed or replaced them.
- The inactive status of computers, hardware, documents, and configurations is labeled Retired. The Retire Computer, Retire Hardware, Retire Document, and Retire Configuration actions set it. What these actions do, including what happens to the asset associated with a computer or hardware record, is described in Retire a record.
- On a retired computer, hardware, document, or configuration record, the only action offered is Unretire Computer, Unretire Hardware, Unretire Document, or Unretire Configuration, for the record's class. Other actions, such as Add Comment, Follow, and Create Incident, are not offered.
- A shared computer view named Virtual Machines lists the computers marked as virtual machines.
Related topics
- CI Relationships - how configuration items relate to each other.
- Inventory Data and Audit Conflicts - what inventory writes to a computer's audited fields.