ITFORMFACTOR: Form Factor
Physical form factor for IT equipment with standard dimensions, rack units, weight, and mounting specifications.
Default definition. This article describes the default
ITFORMFACTOR definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches ITFORMFACTOR.Entity properties
| Property | Value |
|---|---|
| Entity code | ITFORMFACTOR |
| Display name | Form Factor |
| Plural | Form Factors |
| Level | 55500 |
Use cases
ITFORMFACTOR defines the physical packaging standard for IT equipment, referenced by ITASSET via the formFactor field. It captures dimensional constraints that are critical for data centre planning: standard and maximum dimensions (width, height, depth in mm), rack unit height, typical weight, mounting method, cooling requirements, and power connector type. The code field provides a short identifier (e.g., '1U', '2U', 'Blade', 'Tower', 'Desktop', 'SFF') for use in reports and compact displays.
Fields
Form Factor Information
| Field | Type | Required | Notes |
|---|---|---|---|
ref | text | Ref. | |
name | text | Yes | Form Factor Name. |
code | text | Yes | Form Factor Code. |
description | text (multi-line) | Description. | |
standard | text | Industry Standard. | |
active | enum | Yes | Valid ids: 1 (Yes), 0 (No). |
sortOrder | number | Sort Order. |
Physical Specifications
| Field | Type | Required | Notes |
|---|---|---|---|
standardWidth | number | Standard Width (mm). | |
standardHeight | number | Standard Height (mm). | |
standardDepth | number | Standard Depth (mm). | |
maxWidth | number | Max Width (mm). | |
maxHeight | number | Max Height (mm). | |
maxDepth | number | Max Depth (mm). | |
rackUnits | number | Rack Units (U). | |
typicalWeight | number | Typical Weight (kg). | |
mountingMethod | text | Mounting Method. | |
coolingRequirement | text | Cooling Requirement. | |
powerConnectorType | text | Standard Power Connector. |
Relationships
- No declared relationships in the default definition.
Creating a Form Factor via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "ITFORMFACTOR",
"level": 55500,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"code": "...",
"active": "1",
"ref": "..."
}
Listing Form Factors
# All records in your tenant
GET /v1/entities/ITFORMFACTOR/SUB:<your-sub-id>