Edit Template Event

The Edit Template Event tab on the Edit Template form is used to add a Meal or Break event to a day in a schedule edit template. You can also define events that may not be posted, such as when an employee is not allowed to take a break or meal.

If the Meal or Break is configured to post automatically, the automatic event posting is triggered when the employee posts an event after the time of the scheduled automatic event. For example, if the automatic lunch is from 12:00 p.m. to 12:30 p.m., when the employee stops labor at 12:05 p.m., the automatic lunch will post. If you want to allow a punched meal or break to override an automatic one, see Meal/Break Override for the configurations needed. If you want to allow a punched meal or break to override an automatic one, see "Meal/Break Override" in your help file for the configurations needed.

See Also:

Edit Template Event Field Descriptions

Add an Edit Template Event

Modify or Delete an Edit Template Event

 

Edit Template Event Field Descriptions

Event

Available options are ATTENDANCE:BREAK and ATTENDANCE:MEAL events. Typically, MEAL is used for meal breaks such as lunch, and BREAK is used for any other kind of break within the schedule.

Posting Basis

Determines when the Event will post.

STRICT - The Event has a specific start and stop time, no matter when the person clocks in or out. The start and stop times are defined in the Start Day, Start Time, End Day, and End Time fields.

OFFSET - The Event will post for a specified number of hours after the raw timestamp of the most recent clock in, based on the Start Hours Offset and End Hours Offset. For example, the employee's schedule is 7 a.m. to 3:30 p.m. with an automatic half-hour lunch. The Posting Basis for the lunch is OFFSET, Start Hours Offset is 4, and End Hours Offset is 4.5. The employee clocks in at 6:45 a.m., which rounds to 7 a.m. based on his Rounding Policy. The OFFSET for the lunch event is based on the raw clock-in time, which is 6:45 a.m. Therefore the lunch posts from 10:45 a.m. to 11:15 a.m.

Required

MANDATORY- The employee is expected to post the Event.

OPTIONAL- The employee may post the Event but there will not be a violation if the Event is not posted.

PROHIBITED- The employee is not allowed to post the Event.

When Auto Event is set to AUTO or OVERRIDE, the Required field is always set to Mandatory.

When Auto Event is set to PUNCH, you can select Mandatory, Optional, or Prohibited.

Auto Event

Defines how the Event will post.

AUTO - The Event will post automatically according to the Start Time and End Time or the Start Hours Offset and End Hours Offset.

OVERRIDE - The Event will post automatically unless it the employee posts it manually. For example, an employee is scheduled to work from 7:00 a.m. to 3:30 p.m. with a lunch break from 11:30 a.m. to 12:00 p.m. that is set to OVERRIDE. The employee works from 7:00 a.m. to 10:30 a.m. and then punches out for lunch. The employee returns from lunch at 12:30 p.m. The automatic lunch (11:30 – 12:00) will not post and the punched lunch (10:30 – 12:30) will remain. See Meal/Break Override for more information.

PUNCH - The Event posts only when the employee posts it manually.

Note: If you are using the Smart Clock feature, make sure you set Auto Event to PUNCH.

Start Day, End Day
Start Time, End Time

When you add or modify an Edit Template Event, and the Posting Basis is STRICT, the Start Day, End Day, Start Time, and End Time fields will display. These four fields are used to define the date and time when the Event can post.

Start Day and End Day can be set to TODAY, YESTERDAY, or TOMORROW. For example, a schedule is from 10 PM Today to 7 AM Tomorrow. An automatic meal event is scheduled to post from 2 AM to 3 AM; both the Start Day and End Day are set to Tomorrow.

Start Time, End Time

These columns display in the grid section of the Edit Template Event form. If the Posting Basis is STRICT, these fields show the date and time when the Event can start and end. The Start Time and End Time are defined by the Start Day, End Day, Start Time, and End Time fields when you add or modify an Edit Template Event.

Start Hours Offset, End Hours Offset

When the Posting Basis is OFFSET, these fields define the number of hours after the raw timestamp of the most recent clock in when the Event will start and end. For example, the Meal event has a Start Hours Offset of 4 and an End Hours Offset of 5. If the employee's raw clock-in time is 8 a.m., the Meal event will be posted from 12 p.m. to 1 p.m.

Start Early Margin

Number of minutes before the Meal or Break start that a person can leave for the Meal or Break without receiving a violation notice. Margins are only used when Auto Event is set to PUNCH or OVERRIDE.

You can enter a value in minutes, seconds, or hours (based on the Unit setting - see below) but the Edit Template Event tab will always display in minutes.

When you modify a Margin value, the form will use the largest possible Unit (Hours, Minutes, Seconds) for which all the values can be expressed as integers. For example, you enter 120 Seconds for a Margin value and click Save. The Edit Template Event tab will display the value as 2 Minutes. When you modify the record, it will also display as 2 minutes. If you enter 90 seconds for a Margin value and click Save, the Edit Template Event tab will display the value as 1.5 minutes but when you modify the record it will display as 90 Seconds.

Start Late Margin

Number of minutes after the Meal or Break start that a person can leave for the Meal or Break without receiving a violation notice. Margins are only used when Auto Event is set to PUNCH or OVERRIDE.

You can enter a value in minutes, seconds, or hours (based on the Unit setting - see below) but the Edit Template Event tab will always display in minutes.

When you modify a Margin value, the form will use the largest possible Unit (Hours, Minutes, Seconds) for which all the values can be expressed as integers. For example, you enter 120 Seconds for a Margin value and click Save. The Edit Template Event tab will display the value as 2 Minutes. When you modify the record, it will also display as 2 minutes. If you enter 90 seconds for a Margin value and click Save, the Edit Template Event tab will display the value as 1.5 minutes but when you modify the record it will display as 90 Seconds.

End Early Margin

Number of minutes before the Meal or Break end that a person can return from the Meal or Break without receiving a violation notice. Margins are only used when Auto Event is set to PUNCH or OVERRIDE.

You can enter a value in minutes, seconds, or hours (based on the Unit setting - see below) but the Edit Template Event tab will always display in minutes.

When you modify a Margin value, the form will use the largest possible Unit (Hours, Minutes, Seconds) for which all the values can be expressed as integers. For example, you enter 120 Seconds for a Margin value and click Save. The Edit Template Event tab will display the value as 2 Minutes. When you modify the record, it will also display as 2 minutes. If you enter 90 seconds for a Margin value and click Save, the Edit Template Event tab will display the value as 1.5 minutes but when you modify the record it will display as 90 Seconds.

End Late Margin

Number of minutes after the Meal or Break end that a person can return from the Meal or Break without receiving a violation notice. Margins are only used when Auto Event is set to PUNCH or OVERRIDE.

You can enter a value in minutes, seconds, or hours (based on the Unit setting - see below) but the Edit Template Event tab will always display in minutes.

When you modify a Margin value, the form will use the largest possible Unit (Hours, Minutes, Seconds) for which all the values can be expressed as integers. For example, you enter 120 Seconds for a Margin value and click Save. The Edit Template Event tab will display the value as 2 Minutes. When you modify the record, it will also display as 2 minutes. If you enter 90 seconds for a Margin value and click Save, the Edit Template Event tab will display the value as 1.5 minutes but when you modify the record it will display as 90 Seconds.

Margin Unit

Unit of time used to define the Start Early Margin, Start Late Margin, End Early Margin, and End Late Margin. Select Hours, Minute or Seconds.

The Edit Template Event tab will always display the value in Minutes.

When you modify an Edit Template Event, the form will display these values using the largest possible Margin Unit (Hours, Minutes, Seconds) for which all the margin values can be expressed as integers. For example, you enter 120 Seconds for the margin values and click Save. When you modify the record, the margin values will display as 2 Minutes. If you enter 90 seconds for the margin values and click Save, the form will display the values as 90 Seconds when you click Modify.

Update Date, Updated By

These fields display when the record was created or updated, and the person who created or updated the record.

 

Add an Edit Template Event

  1. Click Main Menu > Administration > Schedules > Edit Template and select the template to which you want to add a Meal or Break.

  2. Go to the Edit Template Event tab and click Add.

  3. Select the Event, Posting Basis, Required, and Auto Event settings.

  4. If the Posting Basis is STRICT, set the Start Day, Start Time, End Day, and End Time for the Event.

  5. If the Posting Basis is OFFSET, set the Start Hours Offset and End Hours Offset for the Event.

  6. If Auto Event is set to PUNCH or OVERRIDE, set the Start Early Margin, Start Late Margin, End Early Margin, End Late Margin, and Margin Unit.

  7. Click Save.

 

Modify or Delete an Edit Template Event

  1. Click Main Menu > Administration > Schedules > Edit Template and select the template for which you want to modify or delete a Meal or Break.

  2. Go to the Edit Template Event tab and select the event you want to modify or delete.

  3. Click Modify to change all the Event's settings. Click Save when you are done.

  4. Click Delete to delete the event from the template.