This macro must be configured to run at regular intervals – e.g. every 30 minutes. The macro will investigate all operations in the current schedule. For started operations (or planned operations with start before time NOW), the current planned hours and quantity and the current actual completed hours/quantity, is saved at operation level per day.
The information is persisted as JSON into the field “Operation.Properties” with the keyword “res_mon”. The information is also available in a more user friendly way by using the analysis service of the REST web service
The macro only considers operations within the current active period. The active period is the time bucket to aggregate planned and actual work in and will default be the time bucket around the point in time where the macro runs.
The active period is a 24 hours interval (cannot be changed). If the macro as an example is running at “2024-01-23 10:00” the active period would be “2024-01-23 00:00 – 2024-01-24 00:00” per default.
Example parameter configuration
Please notice that most parameter values are case sensitive!
Parameter descriptions
(* = configuration required)
periodOffset
Use this parameter to simulate that the macro is being run as an example yesterday (periodOffset=-1)
With the default value of 0 the macro will look at planned and actual work for the current day.
startHourOfDay
Use this parameter to manipulate the starting hour of the active period. The start and end time of intervals that progress is grouped in can be changed. The default value is 0 and will cause the active period time bucket to go from 00:00 today to 00:00 the next day. Setting startHourOfDay to 5, will as an example cause the time bucket to go from 05:00 today to 05:00 the next day. The maximum allowed value is 23.
Post your comment on this topic.