'start_activity' Command

The command affects only the activity specified by key fields of 'command/appointment' element that exists in the system within an active route for the current day and sets the activity status to 'started'. The command will:

1) If the activity processed is not the first in the route:

1a) move the activity into the first position in the route

1b) issue 'the appointment starting order is invalid' warning

2) If/when the activity processed is the first in the route:

2a) start the activity specified by key fields of 'command/appointment' element

2b) update activity properties if 'command/appointment/properties' element is present

2c) record travel time (time from the end of the previous activity to the start of the processed activity) in the statistics table unless the activity was not initially the first in the route

The command will fail if:

  • activity does not exist in OFSC

  • activity is in an inactive route

  • 'command/time' is not current day (except overnight work)

  • another activity in route has status 'started'

  • 'command/time' is less than route activation time

  • 'command/time' is less than the time the previous activity was finished

  • activity has the 'Enable segmenting and extended duration' feature enabled