RACK: Rack
The RACK entity represents an equipment rack within a room, tracking U-space, power, cooling, cabling, and mounted equipment.
RACK 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 RACK.Entity properties
| Property | Value |
|---|---|
| Entity code | RACK |
| Display name | Rack |
| Plural | Racks |
| Level | 270 |
Use cases
RACK is the fifth level in the physical hierarchy (SITE > BUILDING > FLOOR > ROOM > RACK). Each rack belongs to a parent ROOM via objectLookup and is positioned by row letter and position number within that row. Physical specifications capture manufacturer (VEN lookup), model, height in rack units (U), width/depth in mm, mounting width standard (19-inch, 23-inch, ETSI, open frame), and weight capacity vs current load. Location fields (X/Y coordinates, front orientation, starting/ending TILE references) place the rack on the room map. A rackElevation row type provides a visual U-space diagram. The related list shows child RACKMOUNTPOINT records via comboKeyEntity. Power configuration tracks total/allocated/measured power, redundancy level (N through 2N+1), power phase, PDU count/type/mounting positions, and child POWERCIRCUIT records. Cooling captures required vs provided cooling capacity, airflow pattern, containment type, and temperature sensors at top/middle/bottom positions with live readings. Equipment shows space utilisation (total/used/available/reserved U, largest contiguous gap, utilisation gauge) and a related list of ITASSET records mounted in this rack. Cabling covers cable management type, patch panel/port counts, uplink types, network zone, and VLAN range. Maintenance tracks installation date, warranty, service schedules, maintenance contract, documentation links, and photo uploads. Status uses inline singleselect options (Active, Planned, Decommissioning, Decommissioned, Maintenance) rather than a separate lookup entity.
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name. |
rackId | text | Unique identifier or asset tag. | |
room | reference → ROOM | Yes | Room. |
row | text | Row identifier (e.g., A, B, C). | |
position | number | Position number within the row. | |
rackType | reference → RACKTYPE | Rack Type. | |
status | enum | Status. Valid ids: 1 (Active), 2 (Planned), 3 (Decommissioning), 4 (Decommissioned), 5 (Maintenance). | |
manufacturer | reference → VEN | Manufacturer. | |
model | text | Model. | |
heightU | number | Yes | Rack height in rack units. |
widthMm | number | External width. | |
depthMm | number | External depth. | |
mountingWidth | enum | Mounting Width. Valid ids: 1 (19 inch), 2 (23 inch), 3 (ETSI), 4 (Open Frame). | |
weightCapacity | number | Weight Capacity (kg). | |
currentWeight | number | Current Load (kg). Read-only. | |
xCoordinate | number | Position from room origin (ft). | |
yCoordinate | number | Position from room origin (ft). | |
roomX | number | Horizontal position in mm from room grid origin. Set by Room Planner. Read-only. | |
roomY | number | Vertical position in mm from room grid origin. Set by Room Planner. Read-only. | |
orientation | enum | Front Orientation. Valid ids: 1 (North), 2 (South), 3 (East), 4 (West). | |
tileStart | reference → TILE | Starting Floor Tile. | |
tileEnd | reference → TILE | Ending Floor Tile. |
Audit
| Field | Type | Required | Notes |
|---|---|---|---|
rackAuditStatus | enum | Audit Status. Valid ids: notAssessed (Not Assessed), good (Good), needsAttention (Needs Attention), poor (Poor), critical (Critical). | |
rackAuditDate | date | Audit Date. | |
rackAuditedBy | reference → user | Audited By. | |
rackCondition | enum | Overall Condition. Valid ids: 1 (Excellent), 2 (Good), 3 (Fair), 4 (Poor), 5 (Damaged), 6 (Missing). | |
rackAuditNotes | text (multi-line) | Audit Notes. | |
frontDoorPresent | boolean | Front Door Present. | |
frontDoorCondition | enum | Front Door Condition. Valid ids: good (Good), damaged (Damaged), missingLock (Missing Lock), na (N/A). | |
rearDoorPresent | boolean | Rear Door Present. | |
rearDoorCondition | enum | Rear Door Condition. Valid ids: good (Good), damaged (Damaged), missingLock (Missing Lock), na (N/A). | |
sidePanelsPresent | enum | Side Panels. Valid ids: both (Both Present), leftOnly (Left Only), rightOnly (Right Only), neither (Neither), na (N/A (Open Frame)). | |
topPanelPresent | boolean | Top Panel Present. | |
roofFanPresent | boolean | Roof Fan Present. | |
rackLabelled | boolean | Rack ID Label Present. | |
equipmentLabelled | enum | Equipment Labelling. Valid ids: all (All), most (Most), some (Some), none (None). | |
uMarkingsVisible | boolean | U Markings Visible. | |
cableLabelling | enum | Cable Labelling. Valid ids: all (All), most (Most), some (Some), none (None). | |
pduLabelled | boolean | PDUs Labelled. | |
cableCondition | enum | Cable Condition. Valid ids: good (Good), fair (Fair), poor (Poor), critical (Critical). | |
cableTidyRequired | boolean | Cable Tidy Required. | |
blanksInstalled | enum | Are unused U spaces blanked off for airflow management. Valid ids: all (All), most (Most), some (Some), none (None). | |
powerCablesSecure | boolean | No loose or trailing power cables. | |
earthBondPresent | boolean | Rack earthing/grounding strap in place. | |
earthBondTested | boolean | Earth Bond Tested. | |
obstructions | boolean | Boxes on top, cables blocking vents, etc. | |
waterRisk | boolean | Signs of water ingress or proximity to pipes. | |
fireRisk | boolean | Combustible materials observed. | |
floorTileCondition | enum | Floor Tiles (around rack). Valid ids: good (Good), cracked (Cracked), missing (Missing), na (N/A). |
Power
| Field | Type | Required | Notes |
|---|---|---|---|
totalPowerCapacity | number | Total Power Capacity (kW). | |
allocatedPower | number | Allocated Power (kW). | |
measuredPower | number | Measured Power (kW). Read-only. | |
powerRedundancy | enum | Power Redundancy. Valid ids: 1 (N), 2 (N+1), 3 (2N), 4 (2N+1). | |
powerPhase | enum | Power Phase. Valid ids: 1 (Single Phase), 2 (Three Phase), 3 (Mixed). | |
pduCount | number | Number of PDUs. | |
pduType | enum | PDU Type. Valid ids: 1 (Basic), 2 (Metered), 3 (Monitored), 4 (Switched), 5 (Intelligent). | |
pduMounting | multiselect | PDU Mounting. |
Cooling
| Field | Type | Required | Notes |
|---|---|---|---|
coolingRequired | number | Based on equipment heat load. | |
coolingProvided | number | Cooling Provided (kW). | |
airflowPattern | enum | Airflow Pattern. Valid ids: 1 (Front to Back), 2 (Back to Front), 3 (Bottom to Top), 4 (Side to Side). | |
containmentType | enum | Containment Type. Valid ids: 1 (None), 2 (Hot Aisle Containment), 3 (Cold Aisle Containment), 4 (Chimney), 5 (Full Containment). | |
tempSensorTop | text | Top Temperature Sensor. | |
tempSensorMiddle | text | Middle Temperature Sensor. | |
tempSensorBottom | text | Bottom Temperature Sensor. | |
currentTempTop | number | Current Temp Top (°F). Read-only. | |
currentTempMiddle | number | Current Temp Middle (°F). Read-only. | |
currentTempBottom | number | Current Temp Bottom (°F). Read-only. |
Equipment
| Field | Type | Required | Notes |
|---|---|---|---|
totalU | number | Total U Space. Read-only. | |
usedU | number | Used U Space. Read-only. | |
availableU | number | Available U Space. Read-only. | |
utilizationPercent | gauge | Space Utilization %. Read-only. | |
reservedU | number | Reserved U Space. | |
largestContiguousU | number | Largest Contiguous Space (U). Read-only. |
Cabling
| Field | Type | Required | Notes |
|---|---|---|---|
cableManagementType | multiselect | Cable Management. | |
patchPanelCount | number | Patch Panel Count. | |
copperPortCount | number | Copper Ports. | |
fiberPortCount | number | Fiber Ports. | |
uplinkType | multiselect | Uplink Types. | |
networkZone | text | Network Zone. | |
vlanRange | text | VLAN Range. |
Maintenance
| Field | Type | Required | Notes |
|---|---|---|---|
installDate | date | Installation Date. | |
warrantyExpiry | date | Warranty Expiry. | |
lastMaintenanceDate | date | Last Maintenance. | |
nextMaintenanceDate | date | Next Maintenance. | |
maintenanceContract | text | Maintenance Contract. | |
serviceContact | text | Service Contact. | |
notes | text (multi-line) | Notes. | |
documentationUrl | text (URL) | Documentation Link. |
Additional panels
- Documents. Field
files. - rackElevation panel.
Relationships
- Lookups:
roompoints atROOMrecord;rackTypepoints atRACKTYPErecord;manufacturerpoints atVENrecord;tileStartpoints atTILErecord;tileEndpoints atTILErecord. - Related lists:
POWERCIRCUITvia formatSUB;COMPINVvia formatSUB|RACK;AUDITFINDINGvia formatSUB.
Creating a Rack via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "RACK",
"level": 270,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"room": "",
"heightU": 100,
"rackId": "Example text"
} Listing RACK records
# All racks in your tenant
GET /v1/entities/RACK/SUB