Skip to main content

system.kanoa.cmms.addWorkOrderEvent(workOrderEventInfo, userId)

Creates a new work order event, representing a single scheduled or requested occurrence of a work order being carried out on an asset (as opposed to the work order definition/schedule itself) � for example, a specific technician's maintenance visit to a specific pump on a specific date. Every key in the workOrderEventInfo dictionary is required; omitting any of them will cause the call to fail. On success, the function returns the id of the newly created work order event.


Parameters

workOrderEventInfo Dictionary

- assetIdInteger
- assignedToInteger
- dueDateDateTime
- maintenanceSubTypeIdInteger
- requestedByInteger
- requestedDateDateTime
- workOrderEventNameStringName of the workOrder
- workOrderEventStatusIdInteger
- workOrderIdIntegerId of the reference workOrder template
- workOrderPriorityIdInteger

userId Integer:Id of the user executing the function


Returns

workOrderEventId Integer
message String None if success


Example

# Create a new work order event for unscheduled pump maintenance
workOrderPriorityId = system.kanoa.utilities.getFieldValue('workOrderPriorityId', system.kanoa.cmms.getWorkOrderPriorities({'workOrderPriorityName': 'High'}))
workOrderEventStatusId = system.kanoa.utilities.getFieldValue('workOrderStatusId', system.kanoa.cmms.getWorkOrderStatus({'workOrderStatusName': 'Released'}))
workOrderId = system.kanoa.utilities.getFieldValue('workOrderId', system.kanoa.cmms.getWorkOrder({'workOrderName': 'Seal Inspection'}))
workOrderEventInfo = {
"assetId": 4021,
"assignedTo": 118,
"dueDate": system.date.parse("2026-08-01 08:00:00"),
"maintenanceSubTypeId": 3,
"requestedBy": 205,
"requestedDate": system.date.parse("2026-07-27 09:15:00"),
"workOrderEventName": "Pump 12 - Seal Inspection",
"workOrderEventStatusId": workOrderPriorityId,
"workOrderPriorityId": workOrderEventStatusId,
"workOrderId": workOrderId
}
userId = system.kanoa.security.getIDPUserId({'userName': 'SYSTEM'})
workOrderEventId, message = system.kanoa.cmms.addWorkOrderEvent(workOrderEventInfo, userId)
print workOrderEventId, message