Field reference
Every field on every Maintenance form: label in English and Arabic, type, whether it is required, its limits, a valid example and what the system refuses.
On this page (48)
New Asset / Asset 360 > Asset InformationAsset 360 > Asset InformationNew Asset / New Child AssetAsset 360 > Edit (API)Asset 360 > railReport an IssueReport an Issue (API / offline)Request record > RejectRequest record > Approve (API note)Request record > Create Work OrderNew Work OrderNew Work Order / ScheduleWork order (API only)Work order > AssignWork order > Pause / Cancel / ReopenWork order > CompleteWork order > Tasks > Add TaskWork order > Tasks (row)Work order > Labor > Record LaborWork order > Parts > Add PartWork order > Parts > Issue / Return UnusedWork order > Request ShortageWork order > Create Purchase OrderWork order > Failure AnalysisRecord DowntimeRecord Downtime (API)Schedule Maintenance (New Plan)Plan (API only)Asset 360 > Add MeterLog Meter ReadingNew InspectionInspection recordAsset 360 > Add WarrantyAsset 360 > Create Warranty ClaimRecord CalibrationAdd CostNew ContractRecord VisitLocations > New LocationMaintenance Teams > NewTechnicians > NewInspection Templates > New TemplateAlert Rules > NewIoT Sensors > NewAsset Types / Categories / Failure Codes / Root Causes / Warranty Types > AddMaintenance SettingsApplications > Maintenance > FeaturesApplications > Maintenance > Fields
New Asset / Asset 360 > Asset Information
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset Code | رمز الأصل | Text | No | Max 40, stored in CAPITALS; unique per company; empty on a new asset = next AST-000001 style number; cannot be blanked on edit | Automatic (AST-nnnnnn) | HVAC-DXB-001 | A code another asset has -> 'Another asset already has that code.'; blank on edit -> 'Give the asset a code.' |
| Asset Name | اسم الأصل | Text | Yes | Max 200 | Chiller 1 - Al Quoz Warehouse | (empty) -> 'Give the asset a name.' | |
| Asset Type | نوع الأصل | Select (Asset Types list) | No | Must be a code in the Asset Types list | HVAC | (API) 'XYZ' -> 'Choose one from the list.' | |
| Category | الفئة | Select (Asset Categories list) | No | Must be a code in the Asset Categories list; condition rules can target a category | CHILLER | (API) unknown code -> 'Choose one from the list.' | |
| Manufacturer | الشركة المصنعة | Text | Conditional | Max 120. Field rule 'Asset manufacturer': Hidden = not shown and a value sent is refused; Required = asset not saved without it | Carrier | Rule Required, empty -> 'Asset manufacturer is required by this company.'; rule Hidden, value sent (API) -> 'Asset manufacturer is turned off for this company.' | |
| Model | الطراز | Text | No | Max 120 | 30XA-252 | ||
| Serial Number | الرقم التسلسلي | Text | Conditional | Max 120; searchable; can be scanned. Field rule 'Asset serial number' Hidden / Required | SN-TEST-0001 | Rule Required, empty -> 'Asset serial number is required by this company.' | |
| Location | الموقع | Select (locations, full path) | No | An active location of this company; a request on this asset takes its location | Al Quoz - Warehouse 2 - Plant room | (API) other company's location -> 'Choose a location of this company.' | |
| Installation Date | تاريخ التركيب | Date | No | YYYY-MM-DD; availability is counted from this date when it is later than 1 January | 2026-01-15 | (API) '15/01/2026' -> 'Enter a date as YYYY-MM-DD.' | |
| Purchase Cost | تكلفة الشراء | Money (AED) | No | Shown and sent only with maintenance.cost.view; not below 0; part of lifecycle cost | 0 | 185000.00 | -5 -> 'It cannot be less than 0.'; 'abc' -> 'Enter a number.'; without cost.view (API) -> 'You do not have permission for this action.' |
| Criticality | الأهمية | Select | Yes | Low, Medium, High, Critical; copied to new work orders | Medium | High | (API) 'SEVERE' -> 'Choose how critical it is.' |
Asset 360 > Asset Information
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Barcode / QR | الباركود / QR | Text | No | Max 120; scanning this value opens the asset. Shows the asset code when empty | BC-100200 | ||
| Asset Status | حالة الأصل | Select | Yes | Active, Inactive, Under Maintenance, Breakdown, Out of Service, Decommissioned, Disposed. Under Maintenance / Breakdown / Out of Service count as 'down'. Decommissioned / Disposed assets take no new work order and are never moved by work | Active | Active | (API) 'BROKEN' -> 'Choose a status.' |
| Company | الشركة | Read only | Yes | The current company | (shown) | ||
| Branch | الفرع | Select (branches) | No | A branch of this company; copied to new work orders; used as a journal dimension on parts issue | Dubai branch | (API) other company's branch -> 'Choose a branch of this company.' | |
| Department | القسم | Select (Department dimension) | No | Active value of the Department dimension | Facilities | (API) unknown id -> 'Choose a value of this company.' | |
| Responsible Person | المسؤول | Select (employees) | No | Employees not terminated / candidate / offered | A test employee | (API) other company's employee -> 'Choose a employee of this company.' | |
| Purchase Date | تاريخ الشراء | Date | No | YYYY-MM-DD | 2025-12-20 | ||
| Warranty Start / Warranty End | بداية الضمان / نهاية الضمان | Date | No | End not before start. Overwritten by the longest warranty record added | 2026-01-15 / 2028-01-14 | End 2025-01-01 with start 2026-01-15 -> 'The warranty cannot end before it starts.' |
New Asset / New Child Asset
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Parent Asset | الأصل الأب | Asset picker | No | Another asset of this company; cannot be itself or one of its own children; cost, downtime, failures and open work roll up to the parent | Production Line 1 | (API) set a child as the parent -> 'An asset cannot sit under itself or its own child.' |
Asset 360 > Edit (API)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Revision | رقم المراجعة | Hidden number | Yes | Sent on save; must equal the stored revision | (automatic) | Stale tab -> 'Someone else changed this asset. Reload it and try again.' |
Asset 360 > rail
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset picture | صورة الأصل | Image upload | No | Any image; stored as a record attachment and linked to the asset (maintenance.edit) | chiller.jpg |
Report an Issue
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset | الأصل | Asset picker | No | Optional ('Not sure / no asset') but approval and conversion need it; an asset of this company. Type Breakdown with an asset puts the asset to Breakdown at once | CHL-001 | (API) other company's asset -> 'Choose an asset of this company.' | |
| Issue | المشكلة | Text | Yes | Max 240 | Chiller tripping on high pressure | (empty) -> 'Say what the problem is.' | |
| Priority | الأولوية | Select | Yes | Low, Normal, High, Urgent | Normal | High | (API) 'asap' -> 'Choose a priority.' |
| Severity | الخطورة | Select | Yes | Low, Medium, High, Critical | Medium | High | (API) 'major' -> 'Choose a severity.' |
| Maintenance Type | نوع الصيانة | Select | Yes | 11 types: Corrective, Preventive, Predictive, Condition Based, Emergency, Inspection, Calibration, Breakdown, Improvement, Shutdown, Warranty | Corrective | Breakdown | (API) 'repair' -> 'Choose a maintenance type.' |
| Source | المصدر | Select | Yes | Screen offers Manual, Employee ESS, Helpdesk, Production, Fleet, Project, API; server also accepts iot, inspection, ai | Manual | Helpdesk | (API) 'email' -> 'Choose where the request came from.' |
| Location | الموقع | Text | Conditional | Max 160. Field rule 'Request location' Hidden / Required | Warehouse 2, plant room | Rule Required, empty -> 'Request location is required by this company.' | |
| Description | الوصف | Long text | No | Max 20,000 | Trips 3 times a day since Monday |
Report an Issue (API / offline)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| client_uuid | معرف العميل | Hidden text | No | Max 40; a second submit with the same value returns the first request instead of a new one | (random UUID made by the browser) |
Request record > Reject
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Reason | السبب | Long text | Yes | Max 500; stored as the decision note | Duplicate of an open request | (empty) -> 'Say why it is rejected.' |
Request record > Approve (API note)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Note | ملاحظة | Text | No | Max 500; stored as the decision note | Approved for this week |
Request record > Create Work Order
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Team / Technician | الفريق / الفني | Select | No | Active teams / technicians of this company; the technician is set on the new Draft work order and notified | HVAC team / a test technician |
New Work Order
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset | الأصل | Asset picker | Yes | An asset of this company not Decommissioned / Disposed; criticality, branch, cost centre, project and team copy from the asset; can be changed only while Draft / Approved | CHL-001 | (empty) -> 'Choose the asset.'; a disposed asset -> 'That asset is no longer in service.' | |
| Issue | المشكلة | Text | Yes | Max 240 | Replace condenser fan motor | (empty) -> 'Say what the job is.' | |
| Maintenance Type | نوع الصيانة | Select | Yes | 11 types. Corrective / Emergency / Breakdown are 'repairs': completing needs a failure record and their downtime is unplanned | Corrective | Corrective | (API) 'fix' -> 'Choose a maintenance type.' |
| Priority | الأولوية | Select | Yes | Low, Normal, High, Urgent (Urgent shows in Breakdowns) | Normal | Urgent | (API) 'top' -> 'Choose a priority.' |
| Team | الفريق | Select | No | Active maintenance team of this company; default the asset's team | HVAC team | (API) other company's team -> 'Choose a maintenance team of this company.' | |
| Technician | الفني | Select | No | Active technician of this company; the technician's user gets a bell notification 'WO-... assigned to you' | A test technician | (API) other company's technician -> 'Choose a technician of this company.' | |
| Estimated Hours | الساعات المقدرة | Number | No | Not below 0; used for workload | 0 | 4 | -1 -> 'It cannot be less than 0.' |
| Description | الوصف | Long text | No | Max 20,000 | Fan motor bearing noisy |
New Work Order / Schedule
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Planned Start | البداية المخططة | Date and time | Conditional | Needed to Schedule; shown on the calendar and workload | 2026-10-05 08:00 | Schedule with it empty -> 'Say when it is planned to start.' | |
| Planned Finish | النهاية المخططة | Date and time | No | Not before Planned Start; a passed planned finish on an open job = Overdue | 2026-10-05 12:00 | Before the start -> 'It cannot finish before it starts.' |
Work order (API only)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Vendor / Contract / Branch / Cost Centre / Project / Project Task / Cost Code / Meter | المورد / العقد / الفرع / مركز التكلفة / المشروع / مهمة المشروع / رمز التكلفة / العداد | References | No | Each must belong to this company; a meter must be on the work order's asset. Not editable on the screen today | (API) | Meter of another asset -> 'Choose a meter of this asset.'; other company's project -> 'Choose a project of this company.' |
Work order > Assign
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Technician | الفني | Select | Yes | Active technician of this company | A test technician | (empty) -> 'Choose the technician.' |
Work order > Pause / Cancel / Reopen
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Reason | السبب | Long text | Yes | Max 300; kept as the hold reason (pause / cancel) | Waiting for permit to work | Pause empty -> 'Say why the job is paused.'; Cancel empty -> 'Say why it is cancelled.'; Reopen empty -> 'Say why it is reopened.' |
Work order > Complete
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Failure Code / Root Cause / Cause / Corrective Action | رمز العطل / السبب الجذري / السبب / الإجراء التصحيحي | Select + text | Conditional | Asked only on a repair type with no failure recorded yet; failure code from the Failure Codes list; cause max 500, corrective action max 1000 | ELEC / SUPPLY / Loose terminal / Re-terminated | Repair with no failure -> 'Record what failed (failure code and cause) before completing a repair.'; failure code empty -> 'Choose the failure code or describe the symptom.' | |
| Meter Reading at Completion | قراءة العداد عند الإتمام | Number | No | Shown when the work order has a meter (plan jobs); recorded as a reading with source Work Order; a counter cannot go below its current value | 12500 | Lower than the counter -> 'This counter was at 12600 h. A smaller reading is recorded as a meter reset.' | |
| Customer / Supervisor Signature | توقيع العميل / المشرف | Text (typed name) | No | Max 160 | Test Supervisor | ||
| Completion Notes | ملاحظات الإتمام | Long text | No | Max 20,000 | Motor replaced, tested 30 min |
Work order > Tasks > Add Task
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Task | المهمة | Text | Yes | Max 240; new tasks get sequence +10 | Isolate power and lock out | (empty) -> 'Say what the task is.' | |
| Planned Time (h) | الوقت المخطط (س) | Number | No | Not below 0 | 0.5 | -2 -> 'It cannot be less than 0.' | |
| Technician | الفني | Select | No | Active technician of this company | A test technician |
Work order > Tasks (row)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Status | الحالة | Select | Yes | Open, In Progress, Done, Skipped; Skipped needs a Result first; Complete is refused while any task is Open / In Progress | Open | Done | Skipped with no result -> 'Say why the task is skipped.' |
| Actual Time / Result | الوقت الفعلي / النتيجة | Number / Text | No | Actual time not below 0; result max 500; saved when the box loses focus | 0.75 / OK |
Work order > Labor > Record Labor
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Technician | الفني | Select | Yes | Default the work order's technician; must be a technician of this company | A test technician | None on the job and none chosen -> 'Choose the technician.' | |
| Hours | الساعات | Number | Yes | More than 0. Cost = hours x technician hourly cost, or the company default labour rate when the technician has none | 2.5 | 0 -> 'Enter the hours worked.'; -1 -> 'It cannot be less than 0.' | |
| Note | ملاحظة | Text | No | Max 300 | Overtime Friday |
Work order > Parts > Add Part
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Item | الصنف | Select (stocked products) | Yes | An active Goods product of this company (services refused) | A test spare part (e.g. V-belt B52) | (empty) -> 'Choose the part.'; (API) a service product -> '<code> is not a stocked product.' | |
| Required Qty | الكمية المطلوبة | Number | Yes | More than 0; on edit cannot go below what is already issued (net of returns) | 1 | 2 | 0 -> 'Enter how many are needed.'; (edit) 1 when 2 issued -> 'It cannot need fewer than have already been issued.' |
| Warehouse | المستودع | Select | Yes | Active warehouse of this company; default = Settings default warehouse, then the company default, then the first by code; cannot change while reserved or issued | Main warehouse | Company with no warehouse -> 'Choose the warehouse the parts come from.'; change after reserving -> 'Release the reservation before changing the warehouse.' | |
| Reserve it in Inventory now | احجزها في المخزون الآن | Tick box | No | Reserves as much free stock as possible; lot/serial-tracked products are never reserved | Ticked | Ticked |
Work order > Parts > Issue / Return Unused
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Quantity per line | الكمية لكل سطر | Number | No | Issue: up to required - (issued - returned). Return: up to issued - returned. Lot/serial products are refused | 2 | Issue more than room -> '<part>: at most 2 can be issued.'; more than free stock -> 'Only 1 of <code> is available at <warehouse>.'; tracked product -> '<code> is tracked by lot or serial - issue it from Inventory, then add its cost here.' |
Work order > Request Shortage
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Vendor | المورد | Select (vendors) | Yes | Supplier partner of this company | A test supplier LLC | (empty) -> 'Choose the vendor to ask.'; nothing short -> 'Nothing is short: stock covers every part.' |
Work order > Create Purchase Order
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Vendor | المورد | Select (vendors) | Yes | Supplier of this company; one purchase order per work order | A test contractor LLC | (empty) -> 'Choose the vendor.'; second PO -> 'This work order already has a purchase order.' | |
| Service / Quantity / Price | الخدمة / الكمية / السعر | Text / Number / Money | Conditional | One line; product = MNT-SERVICE service product (created on first use); VAT rate 5 %; description max 200 | Issue text / 1 / 0 | Rewind motor / 1 / 1200.00 |
Work order > Failure Analysis
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Failure Code | رمز العطل | Select (Failure Codes) | Conditional | Failure code or a symptom (10 characters kept) is needed | MECH | Both empty -> 'Choose the failure code or describe the symptom.' | |
| Failure Type / Symptom / Cause | نوع العطل / العَرَض / السبب | Text | No | Max 40 / 500 / 500 | Wear / Bearing noise / No lubrication | ||
| Root Cause | السبب الجذري | Select (Root Cause Codes) | No | Code from the list | LUBRICATION | (API) unknown -> 'Choose one from the list.' | |
| Corrective Action / Preventive Action | الإجراء التصحيحي / الإجراء الوقائي | Text | No | Max 1000 each | Replaced bearing / Add to monthly greasing | ||
| 5 Why | الأسئلة الخمسة (لماذا) | 5 text boxes | No | Up to 5, max 300 each; empty ones dropped | Why 1: bearing seized | ||
| Fishbone (Man, Machine, Method, Material, Measurement, Environment) | مخطط عظم السمكة | 6 boxes, one cause per line | No | Up to 10 causes per bone, max 200 each | Environment: dust |
Record Downtime
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset | الأصل | Asset picker | Yes | Asset of this company; taken from the work order when recorded on a job | CHL-001 | (empty) -> 'Choose the asset.' | |
| Downtime Start | بداية التوقف | Date and time | Yes | Stored in UTC, shown in local time | Now | 2026-10-01 09:00 | |
| Downtime End | نهاية التوقف | Date and time | No | Not before start; empty = still running; hours = end - start (2 decimals); cost = hours x Settings downtime rate when no cost given | 2026-10-01 13:30 | Before start -> 'Downtime cannot end before it starts.' | |
| Reason | السبب | Select (Downtime reasons) | No | Breakdown, Preventive maintenance, Waiting for parts, Planned shutdown, Utility failure | UTILITY | (API) unknown -> 'Choose one from the list.' | |
| Planned downtime | توقف مخطط | Tick box | No | Unplanned downtime lowers availability and MTBF; planned does not | Not ticked | Not ticked | |
| Production Impact | الأثر على الإنتاج | Text | No | Max 300 | Line 1 stopped, 400 cartons lost |
Record Downtime (API)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Cost | التكلفة | Money | No | Needs maintenance.cost.view; not below 0 | 1500.00 | Without cost.view -> 'You do not have permission for this action.' |
Schedule Maintenance (New Plan)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Plan Name | اسم الخطة | Text | Yes | Max 200; numbered MP-00001 | Quarterly chiller service | (empty) -> 'Name the plan.' | |
| Maintenance Type | نوع الصيانة | Select | Yes | 11 types; Condition Based / Predictive show under Condition-Based Plans | Preventive | Preventive | |
| Trigger | المشغل | Select | Yes | Time (calendar), Meter, Runtime, Distance, Cycles, Usage, Whichever Comes First | Time | Whichever Comes First | (API) 'weekly' -> 'Choose what triggers it.' |
| Every / Unit | كل / الوحدة | Whole number + Days/Weeks/Months/Years | Conditional | Needed for Time and Whichever First; more than 0. 31 Jan + 1 month = 28/29 Feb | 3 Months | 3 Months | 0 -> 'Say how often: every how many days, weeks, months or years.'; (API) unit 'fortnight' -> 'Choose days, weeks, months or years.' |
| First Due | أول استحقاق | Date | No | Calendar plans: the first due date for each asset; empty = today + interval | Today | 2026-10-15 | |
| Meter Type | نوع العداد | Select (8 meter types) | Conditional | Needed for meter triggers and Whichever First; the asset must have a meter of this type for the meter side to fire | Operating Hours (h) | (empty) -> 'Choose the meter it follows.' | |
| Every (on the meter) | كل (على العداد) | Number | Conditional | More than 0; next due meter = current reading + interval | 500 | 0 -> 'Say every how much on the meter.' | |
| Lead Time (days) | مهلة التجهيز (أيام) | Whole number | No | Not below 0; a calendar job is generated this many days before its due date | 7 | 7 | -1 -> 'It cannot be less than 0.' |
| Estimated Labor Hours | ساعات العمل المقدرة | Number | No | Not below 0; generated job finishes start + this many hours (1 h when 0) | 4 | ||
| Default Team / Default Technician | الفريق الافتراضي / الفني الافتراضي | Select | No | With a technician the generated job is Assigned, otherwise Scheduled | HVAC team / a test technician | (API) other company's technician -> 'Choose a technician of this company.' | |
| Inspection Checklist | قائمة الفحص | Select (templates) | No | Each generated job also gets a planned inspection from this template | Safety Inspection | (API) other company's template -> 'Choose a inspection template of this company.' | |
| Assets | الأصول | Asset chips | Yes | At least one asset of this company on a new plan; removed assets are switched off, not deleted | CHL-001, CHL-002 | None -> 'Choose the assets the plan applies to.'; other company's asset -> 'Choose assets of this company.' | |
| Checklist (one task per line) | قائمة المهام (مهمة في كل سطر) | Long text | No | Each line becomes a task (max 240) on every generated job | Clean filter\nCheck refrigerant\nTest operation |
Plan (API only)
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Priority / Default Parts / Instructions / Asset Category | الأولوية / القطع الافتراضية / التعليمات / فئة الأصل | Select / list / text | No | Parts: product + quantity more than 0, added (reserved) on every generated job; instructions max 20,000. Not settable on the screen today | (API) | Part quantity 0 -> 'Each part needs a quantity.' |
Asset 360 > Add Meter
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Meter Type | نوع العداد | Select | Yes | Operating Hours (h), Odometer (km), Cycle Count, Production Qty, Energy Usage (kWh) are counters; Temperature (°C), Pressure (bar), Vibration (mm/s) are gauges. One meter of each type per asset | Operating Hours | Operating Hours | Second meter of the same type -> 'This asset already has that meter.' |
Log Meter Reading
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Meter | العداد | Select | Yes | An active meter of the asset | Operating Hours (h) | Switched-off meter (API) -> 'That meter is switched off.'; none -> 'Choose the meter.' | |
| Reading | القراءة | Number | Yes | A counter cannot go below its current value unless 'meter was replaced or reset' is ticked; readings are never edited | 12650 | 12500 when at 12600 -> 'This counter was at 12600 h. A smaller reading is recorded as a meter reset.'; 'abc' -> 'Enter a number.' | |
| Read At | وقت القراءة | Date and time | No | Not more than 5 minutes in the future; an older read time does not change the meter's current value | Now | Now | Tomorrow -> 'A reading cannot be in the future.' |
| The meter was replaced or reset | تم استبدال العداد أو تصفيره | Tick box | No | Counters only; the note starts 'Meter reset.' | Ticked with reading 5 | ||
| Note | ملاحظة | Text | No | Max 300 | Read during PM |
New Inspection
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Template | النموذج | Select | Yes | Inspection template of this company; its checks are copied | First template | Safety Inspection | (API) none -> 'Choose the inspection template.' |
| Asset | الأصل | Asset picker | Yes | Taken from the work order when made on a job | CHL-001 | (empty) -> 'Choose the asset.'; other company's work order (API) -> 'Choose a work order of this company.' | |
| Scheduled On | موعد الفحص | Date | No | Today (company date) | 2026-10-06 | ||
| Inspector | المفتش | Select (technicians) | No | Technician of this company | A test technician |
Inspection record
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Response (Pass / Fail / N/A) | الاستجابة (ناجح / فاشل / لا ينطبق) | Buttons | Yes (to complete) | Needed on every pass/fail check before Complete | Pass | (API) 'ok' -> '<question>: answer Pass, Fail or N/A.'; unanswered on Complete -> 'Answer every check first: <question>' | |
| Response (Measurement) | الاستجابة (قياس) | Number | Yes (to complete) | Pass when min <= value <= max (either limit may be missing) | 6.5 (limits 5-8 bar) | 'high' -> 'Enter a number.' | |
| Response (Text / Photo) | الاستجابة (نص / صورة) | Text | No | Max 500; any text counts as passed; photo = a reference only (no capture) | Nameplate photo ref P-001 | ||
| Note | ملاحظة | Text | No | Max 300 per check | Guard bolt loose |
Asset 360 > Add Warranty
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Warranty Type | نوع الضمان | Select (Warranty Types) | No | Max 40 | MANUFACTURER | EXTENDED | |
| Provider | المزود | Select (vendors) | No | Supplier of this company | A test supplier LLC | (API) other company's partner -> 'Choose a vendor of this company.' | |
| Start Date / End Date | تاريخ البداية / تاريخ النهاية | Date | Yes | End not before start; the longest warranty is copied to the asset; state Valid / Expiring (60 days) / Expired | Start today | 2026-10-01 / 2028-09-30 | End empty -> 'Enter when the warranty starts and ends.'; end before start -> 'The warranty cannot end before it starts.' |
| Coverage | التغطية | Select | No | Parts & Labor, Parts only, Labor only, Full cover | Parts & Labor | Parts only | |
| Reference | المرجع | Text | Conditional | Max 80. Field rule 'Warranty reference' Hidden / Required | WTY-TEST-123 | Rule Required, empty -> 'Warranty reference is required by this company.' | |
| Terms | الشروط | Long text | No | Max 1000 | Excludes misuse |
Asset 360 > Create Warranty Claim
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Claim Reference / Amount Claimed / Notes | مرجع المطالبة / المبلغ المطالب به / ملاحظات | Text / Money / Text | No | Only while the warranty is valid today; reference max 80; amount not below 0; numbered WCL-00001, status Draft | CLM-TEST-9 / 2400.00 | Expired warranty -> 'The warranty is not valid today, so there is nothing to claim.'; no warranty -> 'This asset has no warranty to claim on.' |
Record Calibration
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Performed On | تاريخ التنفيذ | Date | No | Today | 2026-10-02 | ||
| Result | النتيجة | Select | Yes | Pass / Fail. Fail sets next calibration = performed date and raises a high-priority request | Pass | Pass | (API) 'ok' -> 'Say whether it passed.' |
| Measured / Tolerance | القيمة المقاسة / التفاوت المسموح | Text | No | Max 120 / 60; tolerance defaults to the asset's | 0.02 mm / ±0.05 mm | ||
| Certificate | الشهادة | Text | Conditional | Max 120. Field rule 'Calibration certificate' Hidden / Required | CAL-CERT-TEST-1 | Rule Required, empty -> 'Calibration certificate is required by this company.' | |
| Interval (days) | الفاصل (أيام) | Whole number | No | Used only when the asset has no interval of its own; pass: next due = performed + interval | 180 | ||
| Performed By / Vendor / Notes | نفذه / المورد / ملاحظات | Text / Select / Text | No | 160 / supplier / 1000 | Test Lab LLC | ||
| Cost | التكلفة | Money | No | Not below 0; booked in the ledger as Vendor (with vendor) or Other | 350.00 |
Add Cost
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset | الأصل | Asset picker | Yes | Taken from the work order when added on a job | CHL-001 | (empty) -> 'Choose the asset.' | |
| Category | الفئة | Select | Yes | Labor, Parts, Vendor, Travel, Tools, Downtime, Other | Other | Travel | (API) 'fuel' -> 'Choose a cost category.' |
| Amount | المبلغ | Money (AED) | Yes | More than 0; rounded to 2 decimals | 120.00 | 0 -> 'Enter the amount.'; closed job -> 'A closed work order's costs are final. Reopen it first.' | |
| Date / Vendor / Description | التاريخ / المورد / الوصف | Date / Select / Text | No | Default today; description max 300 | 2026-10-02 / - / Taxi to site |
New Contract
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Contract Name | اسم العقد | Text | Yes | Max 200; numbered AMC-00001 | HVAC AMC 2026 | (empty) -> 'Name the contract.' | |
| Kind | النوع | Select | Yes | Annual Maintenance Contract, Service Agreement, Warranty Contract, Rental Maintenance | AMC | AMC | (API) 'lease' -> 'Choose the kind of contract.' |
| Vendor | المورد | Select (vendors) | Yes | Supplier of this company | A test contractor LLC | (empty) -> 'Choose the vendor.' | |
| Start / Expiry | البداية / الانتهاء | Date | Yes | Expiry not before start; 'expiring' within 60 days | Start today | 2026-01-01 / 2026-12-31 | Expiry empty -> 'Enter when the contract starts and ends.'; before start -> 'The contract cannot end before it starts.' |
| Visits Included / Response SLA (hours) | الزيارات المشمولة / زمن الاستجابة (ساعات) | Whole number | No | Not below 0; 0 visits = unlimited (∞) | 4 / 24 | 4 / 24 | |
| Value | القيمة | Money | No | Not below 0; shown only with cost.view | 24000.00 | ||
| Parts included / Labor included / Coverage / Assets covered | القطع مشمولة / العمالة مشمولة / التغطية / الأصول المشمولة | Tick boxes / text / asset chips | No | Coverage max 300; assets of this company | Parts no, Labor yes | Labor yes; CHL-001 | (API) other company's asset -> 'Choose the asset.' |
Record Visit
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Contract / Vendor | العقد / المورد | Select | Yes (one of them) | A contract sets the vendor; without a contract choose the vendor | AMC-00001 | Neither -> 'Choose the vendor.' | |
| Asset / Visit Date / Status | الأصل / تاريخ الزيارة / الحالة | Picker / Date / Select | No | Status Planned, Done, Cancelled; date default today; inside the contract dates = Within Contract | today / Done | CHL-001 / 2026-10-02 / Done | (API) status 'open' -> 'Choose a status.' |
| Cost / Notes | التكلفة / ملاحظات | Money / Text | No | Cost needs maintenance.cost.view; booked only when Done, outside the contract dates and with an asset; notes max 1000 | 800.00 | Cost without cost.view -> 'You do not have permission for this action.' |
Locations > New Location
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name | الرمز / الاسم | Text | Yes | Code max 40 CAPITALS unique; name max 160 | DXB-WH2 / Warehouse 2 | Used code -> 'That code is already used.'; empty -> 'Give it a code.' / 'Give it a name.' | |
| Inside / Kind | داخل / النوع | Select | No | Parent location (no loops); kind Site, Building, Floor, Area, Room | - / Area | Al Quoz site / Building | (API) its own child as parent -> 'That would put the location inside its own child.' |
Maintenance Teams > New
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name / Leader / Active | الرمز / الاسم / القائد / نشط | Text / Text / Employee / Tick | Code, Name | Code max 30 unique; name max 120; description max 500 | HVAC / HVAC team | Used code -> 'That code is already used.' |
Technicians > New
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Employee | الموظف | Select (employees) | Yes | One technician row per employee; the employee's user sees My Work | A test employee | (empty) -> 'Choose the employee.'; already a technician -> 'That employee is already a technician.' | |
| Maintenance Team / Skills / Certification / Shift / Availability | فريق الصيانة / المهارات / الشهادة / الوردية / التوفر | Select / comma list / text / text / select | No | Up to 20 skills (40 chars each); certification 200; shift 40; availability Available, Busy, On leave | Available | HVAC team / HVAC, Electrical / DEWA licence / Day | |
| Hourly Cost | تكلفة الساعة | Money | No | Shown and saved only with cost.view; not below 0; used for labour cost | 85.00 | Without cost.view (API) -> 'You do not have permission for this action.' |
Inspection Templates > New Template
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name / Frequency | الرمز / الاسم / التكرار | Text / Text / Select | Code, Name | Code max 30 unique; frequency daily, weekly, monthly, quarterly, yearly, pre start, shutdown | FIRE / Fire pump weekly / weekly | ||
| Checks (Check, Response, Min, Max, Unit, Fail raises request) | البنود | Table | Yes | At least one check; question max 300; response Pass/Fail/N/A, Measurement (min/max), Text, Photo; unit max 20 | Pump pressure, Measurement, 6, 10, bar, ticked | No checks -> 'Add at least one question.'; empty question -> 'Line 1 needs a question.' |
Alert Rules > New
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name | الرمز / الاسم | Text | Yes | Code max 30 unique, name 160 | CHL-HT / Chiller high temperature | ||
| Asset | الأصل | Asset picker | No | Empty = any asset (or a category via API) | Any asset | CHL-001 | |
| Meter Type / Operator / Threshold | نوع العداد / المعامل / الحد | Select / Select / Number | Yes | Operator >, >=, <, <=, =; threshold any number | - / > / 0 | Temperature / > / 45 | No meter type -> 'Choose the meter type it watches.'; (API) operator '!=' -> 'Choose how it compares.' |
| Action / Priority | الإجراء / الأولوية | Select | Yes | Alert and raise a request / Alert only; priority of the raised request | Raise request / high | Raise request / urgent |
IoT Sensors > New
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name / Asset / Meter / Adapter / External Ref | الرمز / الاسم / الأصل / العداد / المحول / المرجع الخارجي | Text / Text / Picker / Select / Select / Text | Code, Name, Asset | Code max 40 unique; meter must be on that asset; adapter Webhook, MQTT bridge, Telematics, OPC UA; external ref max 120 | TS-CHL-01 / Chiller temp probe / CHL-001 / Temperature / Webhook | No asset -> 'Choose the asset it is fitted to.'; meter of another asset -> 'Choose a meter of that asset.' |
Asset Types / Categories / Failure Codes / Root Causes / Warranty Types > Add
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Code / Name / Arabic Name | الرمز / الاسم / الاسم بالعربية | Text | Code, Name | Code max 40, CAPITALS, spaces become _ and unique in the list; name 120; Arabic 120 | ROOFTOP / Rooftop unit / وحدة سطحية | Used code -> 'That code is already in this list.'; no name -> 'Give it a name.' |
Maintenance Settings
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Requests need approval before a work order is made | تحتاج الطلبات إلى اعتماد قبل إنشاء أمر العمل | Tick box | No | Off: New / Review requests can be converted directly | On | On | |
| Work orders need approval before they are scheduled or started | تحتاج أوامر العمل إلى اعتماد قبل الجدولة أو البدء | Tick box | No | On: a Draft cannot be scheduled, assigned or started | Off | On | Start a Draft -> 'Approve the work order before starting it.' |
| A failed inspection raises a maintenance request | الفحص الفاشل ينشئ طلب صيانة | Tick box | No | One request per inspection | On | On | |
| A work order is closed only with its costs recorded | لا يُغلق أمر العمل إلا بتسجيل تكاليفه | Tick box | No | On: Close needs total cost > 0 | Off | On | Close with 0 cost -> 'This company closes a job only with its costs recorded.' |
| Post parts issues to accounting (stock -> maintenance expense) | ترحيل صرف القطع إلى المحاسبة | Tick box | No | Off: stock still moves, no journal | On | On | |
| Default Warehouse for Parts | مستودع القطع الافتراضي | Select | No | Warehouse of this company | Main warehouse | (API) other company's -> 'Choose a warehouse of this company.' | |
| Due Soon Window (days) | نافذة الاستحقاق القريب (أيام) | Whole number | No | Not below 0; Preventive Due tile and asset Due Soon | 14 | 14 | -3 -> 'It cannot be less than 0.' |
| Default Labor Rate / hour; Downtime Cost / hour | معدل العمالة الافتراضي / ساعة؛ تكلفة التوقف / ساعة | Money | No | Shown only with cost.view; not below 0 | 0 / 0 | 60.00 / 500.00 | -1 -> 'It cannot be less than 0.' |
Applications > Maintenance > Features
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Inspections / Calibration / Warranty and claims / Service contracts and vendor visits / Meters and condition monitoring | الفحوصات / المعايرة / الضمان والمطالبات / عقود الصيانة وزيارات الموردين / العدادات ومراقبة الحالة | On / Off switches | No | Off: saves through that feature's routes are refused and its menus go; records stay readable. 'Requests and work orders' cannot be turned off | On | Inspections Off | New inspection while off -> 'Inspections is disabled for this company.' |
Applications > Maintenance > Fields
| Field | Arabic label | Type | Required | Rules and limits | Default | Example | Refused when |
|---|---|---|---|---|---|---|---|
| Asset manufacturer / Asset serial number / Request location / Warranty reference / Calibration certificate | الشركة المصنعة للأصل / الرقم التسلسلي للأصل / موقع الطلب / مرجع الضمان / شهادة المعايرة | Normal / Hidden / Required | No | Hidden: field disappears from the form and a value sent is refused; Required: save refused without it | Normal | Serial number Required |