A diagnosed fault code under a complaint: the complaint is the symptom the customer reports, and each of its fault codes names one cause a technician can find. Fault codes are master data maintained from the complaint's Related tab (Complaint Faults list, Quick Add). On a service order, estimate, opportunity or field visit the user picks a complaint and optionally one of its fault codes on the complaint line; the fault picker shows only the selected complaint's faults. The fault code decides which complaint items are recommended: items with no fault code apply to every fault of the complaint, items with a fault code only when the line names that fault. Changing a complaint line's fault code re-checks its recommendations, adding new ones and removing those that no longer apply unless they were accepted, already have a document line, or were used.
Fields
| Field | Label | Type | Required | What it does |
|---|
ApplicableToItemGroupId | Applicable To Item Group | Lookup → ItemGroup | | The item group this fault concerns. AI Mechanic offers the fault only when the job asset's item is a member of the group; the complaint-line and field-visit pickers ignore it and no save checks it. It is not on the Quick Add row; set it by editing the fault record. |
ApplicableToItemId | Applicable To Item | Lookup → Item | | The single item this fault concerns. AI Mechanic offers the fault only on jobs whose asset is this item. The complaint-line and field-visit fault pickers do not filter by it, and no save checks that a job's item matches it. |
ComplaintId | Complaint | Lookup → Complaint | | The complaint this fault explains. Filled automatically when the fault is added from the complaint's Complaint Faults list. The complaint-line fault picker offers only faults of the selected complaint, so a fault with no complaint is never offered, and a complaint item can only use a fault of its own complaint. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
ExternalId | External | Text | | |
FaultCode | Fault Code | Text | | The workshop's short code for the fault. Optional free text up to 100 characters, with no format or uniqueness check. The field app's fault picker shows this code, falling back to the name when it is empty. |
Id | Id | Guid | Yes | |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Complaint Fault Code Name | Text | Yes | The fault as people read it, for example Coolant leak. Required. Shown in the remarks of the service recommendations the fault produces. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
RecordTypeId | Record Type | Guid, hidden | | |
ServiceOrderId | Service Order | Lookup → ServiceOrder | | A service order linked directly to the fault record. Not on the shipped form. Jobs normally reach a fault through their complaint lines, and this field is not kept in step with them. |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Edit | Edit | EditInline | Edit |
Edit2 | Edit | EditInline | Edit |
New | New | NewInline | New |
