Skip to main content

system.kanoa.operators.operatorLogin(sessionInfo, userId)

Logs an operator into an asset by inserting an open mes.operatorAssetSession row. By default, any other open session this user has on a different asset is closed first, so badging into a new line implicitly logs them out of the old one

Parameters​

sessionInfo Object:

  • userId Integer: the sec.user being logged in
  • assetId Integer
  • workOrderId Integer: optional
  • tStamp String
  • allowMultiSession Boolean: optional, default False - pass True to allow this user to have open sessions on more than one asset at once (e.g. a floater/lead covering two assets)

userId Integer: the actor performing this action (used for createdBy/changedBy audit) - can differ from sessionInfo['userId'], e.g. a supervisor badging an operator in at a shared kiosk session

Returns​

operatorAssetSessionId Integer: the new session's id on success, None on failure (including when a duplicate open session for this user+asset pair already exists)
message String: None on success, an error message on failure

Example​

sessionInfo = {
	'userId': 5,
	'assetId': 4,
	'workOrderId': None,
	'tStamp': system.date.now(),
	'allowMultiSession': False
}
userId = 12
operatorAssetSessionId, message = system.kanoa.operators.operatorLogin(sessionInfo, userId)