NWPROBLEM: Network Problem
Network problem management record for tracking root causes of recurring faults on telecom platform instances, workarounds, and known errors to prevent future outages.
Default definition. This article describes the default
NWPROBLEM 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 NWPROBLEM.Entity properties
| Property | Value |
|---|---|
| Entity code | NWPROBLEM |
| Display name | Network Problem |
| Plural | Network Problems |
| Level | 6800 |
Use cases
NWPROBLEM is the network operations equivalent of ITPROBLEM (IT problem management). The workflow is New → Investigating → Root Cause Identified → Known Error → Resolved → Closed. The Mark as Known Error toolbar button sets the status and knownError flag, confirming the problem is documented with a workaround.
Fields
Problem Information
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Problem ID |
subject | text | Yes | Subject |
description | text (multi-line) | Yes | Description |
status | enum | Yes | Status Valid ids: 1 (New), 2 (Investigating), 3 (Root Cause Identified), 4 (Known Error), 5 (Resolved), 6 (Closed). |
priority | enum | Yes | Priority Valid ids: 1 (Critical), 2 (High), 3 (Medium), 4 (Low). |
Classification
| Field | Type | Required | Notes |
|---|---|---|---|
category | enum | Category Valid ids: 1 (Radio/RF), 2 (Transport), 3 (Core Network), 4 (IP/MPLS), 5 (Optical), 6 (Access Network), 7 (Power/Environmental), 8 (Security), 9 (Other). | |
impact | enum | Impact Valid ids: 1 (Network-wide), 2 (Regional), 3 (Single Site), 4 (Single Element). | |
service | reference → NWSVC | Affected Network Service |
Assignment
| Field | Type | Required | Notes |
|---|---|---|---|
assignedTo | reference → user | Assigned To | |
assignedGroup | text | Assigned Group | |
reportedBy | reference → user | Reported By | |
reportedDate | datetime | Reported Date |
Root Cause
| Field | Type | Required | Notes |
|---|---|---|---|
rootCause | text (multi-line) | Root Cause | |
rootCauseCategory | enum | Root Cause Category Valid ids: 1 (Hardware Failure), 2 (Software Bug), 3 (Configuration Error), 4 (RF Interference), 5 (Fiber/Cable Fault), 6 (Power Failure), 7 (Capacity Exceeded), 8 (Environmental), 9 (Design Flaw), 10 (External Factor), 11 (Unknown). | |
identifiedDate | datetime | Identified Date |
Workaround
| Field | Type | Required | Notes |
|---|---|---|---|
workaround | text (multi-line) | Workaround | |
workaroundAvailable | enum | Workaround Available Valid ids: 1 (Yes), 0 (No). | |
workaroundEffectiveness | enum | Effectiveness Valid ids: 1 (High), 2 (Medium), 3 (Low), 4 (None). |
Resolution Details
| Field | Type | Required | Notes |
|---|---|---|---|
resolutionSummary | text (multi-line) | Resolution Summary | |
resolutionDate | datetime | Resolution Date | |
knownError | enum | Known Error Valid ids: 1 (Yes), 0 (No). | |
knownErrorId | text | Known Error ID |
Related
| Field | Type | Required | Notes |
|---|---|---|---|
relatedChange | reference → NWCHANGE | Related Change Request | |
platformInstance | reference → NWPLATINST | Affected Platform | |
site | reference → SITE | Site | |
affectedAssets | array of references → COMPINV | Affected Assets |
Activity. Activity timeline panel attached.
Relationships
- Lookups:
servicepoints at aNWSVCrecord.relatedChangepoints at aNWCHANGErecord.platformInstancepoints at aNWPLATINSTrecord.sitepoints at aSITErecord.affectedAssetspoints at aCOMPINVrecord. - Related lists:
NWTICKET.
Creating a Network Problem via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "NWPROBLEM",
"level": 6800,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"subject": "Example",
"description": "Example text.",
"status": "1"
}
Listing Network Problems records
# All network problems in your tenant
GET /v1/entities/NWPROBLEM/SUB