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
| - assetId | Integer | |
| - assignedTo | Integer | |
| - dueDate | DateTime | |
| - maintenanceSubTypeId | Integer | |
| - requestedBy | Integer | |
| - requestedDate | DateTime | |
| - workOrderEventName | String | Name of the workOrder |
| - workOrderEventStatusId | Integer | |
| - workOrderId | Integer | Id of the reference workOrder template |
| - workOrderPriorityId | Integer |
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