One attendance punch: a single check-in or check-out by a resource. The mobile app writes a punch for every accepted check-in and check-out, and the automatic checkout writes a Check-Out at 23:59:59 local time for a check-in left open from an ended day. Supervisors can add, correct or delete punches on the Related tab of an attendance day. On save, a punch joins its resource's Resource Availability record for the local calendar day, creating it with Availability Type Present when none exists. The day's First Check-In Time and Last Check-Out Time are recalculated from its punches whenever a punch is added, changed or deleted. Saving a Check-In on a day that already has a check-out adds the gap between them to the day's Penalty Hours. The list is in no standard app.
Fields
| Field | Label | Type | Required | What it does |
AttendanceTime | Attendance Time | DateAndTime | | When the punch happened, stored as a point in time and shown in the viewer's time zone. The punch counts towards the resource's local calendar day, taken from the resource's business hours, else its default branch's, else the UTC date. First Check-In Time, Last Check-Out Time and Penalty Hours are calculated from it. A punch without it joins no day. |
BranchId | Branch | Lookup → Branch | | The resource's default branch at the time of the punch, not the place the punch was made. An automatic checkout copies it from the check-in it closes. The device location is used only to check the location gate and is not stored. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
Id | Id | Guid | Yes | |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Resource Availability Data Name | Text | Yes | The punch's reference. While the RAD document name setting is active, the next number from that series replaces any value supplied, for example RAD-10072026-000001, so don't search punches by a name pattern. A replayed offline punch is recognised by the record's identifier, not its name. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
RecordTypeId | Record Type | Guid, hidden | | |
ResourceAvailabilityId | Resource Availability | Lookup → ResourceAvailability | | The attendance day this punch belongs to. Leave it empty: on save, xMatix finds or creates the day for the punch's resource and local date. A day chosen by hand is kept as given. |
ResourceId | Resource | Lookup → Resource | | The person who punched. Required for the punch to join an attendance day. |
Time | Time | DateAndTime | | A second copy of the moment of the punch, kept for punches recorded before Attendance Time was stored as a point in time. For current punches it equals Attendance Time. If Attendance Time is corrected on the web, Attendance Time wins. The automatic checkout leaves it empty when the resource has no time zone. |
Type | Type | PickList | | Check-In or Check-Out. Only these two values count towards the day's times, the mobile check-in status and the automatic checkout. The list also offers Auto-Check-Out, but a punch of that type is ignored; automatic checkouts are saved as Check-Out. Values: Check-In, Check-Out, Auto-Check-Out. |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
BulkDelete | Delete | Delete | Delete the selected records. |
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Delete | Delete | Delete | Delete |
DeleteInList | Delete | Delete | Delete in a list page |
Edit | Edit | Edit | Edit |
EditInLine | Edit | Edit | Edit in page. |
New | New | New | New |