# Work Time Entries

## Overview <a href="#overview" id="overview"></a>

This register helps manage staff work times for an event by recording the specifics of a shift as a work time entry.&#x20;

Work Time Entries is a sub-register of Work Summaries. New work times are added as sub-items through a [Work Summary Work Times](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/..#work-times) as such you can also view them there.

This register is especially useful for [finding](#finding) and [viewing](#viewing) work times, for example by Date, Staff Member or Location, and [editing](#editing) them directly.&#x20;

{% hint style="info" %}
You can only add new Work Time Entries via the [Work Summary](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries).
{% endhint %}

### Access <a href="#access" id="access"></a>

To access the Work Time Entries register:

1. Go on duty to the event with a [supported position](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/..#positions).
2. Use the *Manage My Work Times* in the User Profile menu to access the module.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F194TCM1K62JsxY6TY9OC%2Fimage.png?alt=media&#x26;token=806e2f80-bc9d-43ac-b627-53324541fe23" alt=""><figcaption></figcaption></figure>

3. Access Work Time Entries via the [Registers menu](https://docs.cw.crisisworks.com/concepts-and-fundamentals/navigation#registers-menu) on the left.

{% hint style="info" %}
If you can't access this link, contact your System Administrator. Work Summaries needs to be properly [setup and configured](#setup-and-configuration).&#x20;
{% endhint %}

### Setup and Configuration <a href="#setup-and-configuration" id="setup-and-configuration"></a>

To enable Work Time Entries, an Administrator needs to:

1. [Add the Work Time Entries register to the Event](https://docs.cw.crisisworks.com/system-administration/managing-events#positions)
2. [Add the appropriate Positions to the Event](https://docs.cw.crisisworks.com/system-administration/managing-events#positions). Most positions that support users adding Work Summaries also support adding Work Time Entries. In addition [security policies](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/..#security-policies) for Work Summaries can be assigned to any position.

## Finding <a href="#finding" id="finding"></a>

{% content-ref url="../../searching-filtering-and-querying-registers" %}
[searching-filtering-and-querying-registers](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/searching-filtering-and-querying-registers)
{% endcontent-ref %}

The register includes a number of features to assist in finding Work Time Entries:

* [Datagrid](https://docs.cw.crisisworks.com/concepts-and-fundamentals/using-the-datagrid#data-grid-view) view
* [Filters](#information-editinganexistinginformationitem-1) including Work Location, Category, Workflow and Assignments
* Combination filters and search by most fields

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FA5VDWWjvYjfrHfCMdVE7%2Fimage.png?alt=media&#x26;token=7c80efe8-f82a-4a03-b71e-c99245a03940" alt=""><figcaption><p>Register datagrid sample view</p></figcaption></figure>

### Filtering <a href="#filtering" id="filtering"></a>

Filters help make management of Work Time Entries easier by focusing on specific groups of items on the datagrid.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FHFNNnlJHnPSiJXjy5813%2Fimage.png?alt=media&#x26;token=986c5e4a-a60f-4c44-98ed-be25d349a20a" alt="" width="276"><figcaption><p>Filter menu</p></figcaption></figure>

<details>

<summary>Filter menu explanations</summary>

The following lists some of the filters and how to use them.

For CQL queries consult the [CQL Reference](https://docs.cw.crisisworks.com/security-and-support/technical-reference/cql-reference) and for field definitions consult the [Work Summary Data Dictionary](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/broken-reference).

<table><thead><tr><th width="187.91796875">Filter Group</th><th>Filter/s</th><th>CQL</th><th>Use</th></tr></thead><tbody><tr><td>Main</td><td></td><td></td><td></td></tr><tr><td></td><td>Active</td><td><code>is:active</code></td><td>Finds all Active items (with a Status of Active, Submitted or ReOpen)</td></tr><tr><td></td><td>Recently Updated</td><td><code>is:active dateUpdated:>today-5d</code></td><td>Finds all items updated in the last 5 days</td></tr><tr><td></td><td>All</td><td><code>is:any</code></td><td>Finds all items</td></tr><tr><td>Work Location</td><td>[List is based on your system configuration]*</td><td><code>is:active workLocation:</code></td><td>Finds all items for the selected Work Location</td></tr><tr><td>Category</td><td>[List is based on your system configuration]*</td><td><code>is:active category:</code></td><td>Finds all items for the selected Work Category</td></tr><tr><td>Workflow</td><td></td><td></td><td></td></tr><tr><td></td><td>Active</td><td><code>status:active</code></td><td>Finds all Active items (Active, Submitted or ReOpen)</td></tr><tr><td></td><td>Cancelled</td><td><code>status:cancelled</code></td><td>Finds all items with a Status of <em>Cancelled</em></td></tr><tr><td></td><td>Manager Approved</td><td><code>status:approved</code></td><td>Finds all items with a Status of <em>Manager Approved</em></td></tr><tr><td></td><td>ReOpen</td><td><code>status:reopen</code></td><td>Finds all items with a Status of <em>ReOpen</em></td></tr><tr><td></td><td>Rejected</td><td><code>status:rejected</code></td><td>Finds all items with a Status of <em>Rejected</em></td></tr><tr><td></td><td>Submitted</td><td><code>status:submitted</code></td><td>Finds all items with a Status of <em>Submitted</em></td></tr><tr><td>Active tags</td><td>[List is based on your system configuration]*</td><td><code>is:active #</code></td><td><p>Any tags in use.</p><p>Refer to: <a href="../../using-the-datagrid/tagging-items">tags</a></p></td></tr><tr><td>Assignments</td><td>[List is based on your system configuration]*</td><td><code>is:active assigned:</code></td><td>Finds all Items for Staff Member</td></tr></tbody></table>

&#x20;\* May vary based on your system configuration

</details>

#### Querying <a href="#querying" id="querying"></a>

CQL searches can be performed via either the Filter menu or Search bar.

<details>

<summary>Query examples</summary>

The following provides some sample searches for users. For a list of available fields, consult the [Data Dictionary](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/broken-reference).

### Related Work Expense Entries&#x20;

* `workexpenses:set` filter records where workexpenses is set to any value
* `workexpenses:unset` filter records where workexpenses is not set
* `workexpenses:(id:123)` search the related record of related record ID 123
* `workexpenses:(field1:value field2:value2)` search the related record by a nested set of filters

### Related Work Time Entries

* `worktimes:set` filter records where worktimes is set to any value
* `worktimes:unset` filter records where worktimes is not set
* `worktimes:(id:123)` search the related record of related record ID 123
* `worktimes:(field1:value field2:value2)` search the related record by a nested set of filters

</details>

## Viewing <a href="#viewing" id="viewing"></a>

Work Time Entries are listed in and searchable via the register [Datagrid](https://docs.cw.crisisworks.com/concepts-and-fundamentals/using-the-datagrid#data-grid-view).

The Work Time Entries datagrid shows details on the hours worked per staff member. These can be grouped by staff member using the datagrid grouping function.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F0dQf71kNvaLlv8dWLAua%2Fimage.png?alt=media&#x26;token=10e82e73-649e-49cd-8c97-2b26928b71c6" alt=""><figcaption><p>Work Time Entries Datagrid</p></figcaption></figure>

To view an existing Work Time Entry:

1. Navigate to the Work Time Entries register datagrid.
2. Locate the item you wish to view. The register includes filters for Totals, Workflow (Active, Submitted, ReOpen, Cancelled, Rejected, Manager Approved), Staff Members (All Unassigned), Work Location, Category and Active Tags
3. Open the item using the ID or Status
4. To return to the Datagrid use the Back button <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FkJtmQ5qacZpOVfkdqfY8%2Fimage.png?alt=media&#x26;token=b4c68b18-dc6e-48bb-8a2e-c14bf3f595be" alt="" data-size="line">

## Settings <a href="#settings" id="settings"></a>

### General <a href="#general" id="general"></a>

The General section contains details on the date, time, hours work, location and type of work.

Work Time Entries require a **Date** at minimum.

#### Date <a href="#date" id="date"></a>

This setting indicates the date when the work time starts and is entered using a [Date Selector](https://docs.cw.crisisworks.com/concepts-and-fundamentals/using-the-datagrid/editing-items#selecting-dates).

#### Start Time <a href="#start-time" id="start-time"></a>

This setting indicates the time when the work time starts.

Variations of shorthand times are accepted as inputs. For example: 9am, 9:00, 9:30 or 9:00am.

#### End Time <a href="#end-time" id="end-time"></a>

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FgTTwMqIITiGMwcaVQUYP%2Fimage.png?alt=media&#x26;token=7ef515ec-e6e8-4f0f-8e92-e6b325acc184" alt="" width="375"><figcaption></figcaption></figure>

#### Hours Worked <a href="#hours-worked" id="hours-worked"></a>

This setting indicates how many hours were worked during the work time and can work in one of two ways:

1. Manually entering the total hours worked
2. Automatically based on the Start time and End time. When both are recorded, the field is dynamically calculated.

#### Work Location <a href="#work-location" id="work-location"></a>

This setting records where the shift took place.&#x20;

In [Edit mode](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items) it is selected from the pulldown list.&#x20;

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FTLDzxgVcwXRAqM63EicR%2Fimage.png?alt=media&#x26;token=ee3c42b3-c80e-4860-b069-f9d2b9f2820d" alt="" width="341"><figcaption></figcaption></figure>

Locations are defined by an administrator using the *Work Summary: Work Location* [lookup](https://docs.cw.crisisworks.com/system-administration/configuring-the-system/lookups). &#x20;

#### Category <a href="#category" id="category"></a>

This setting records the mode of work was performed (for example, Travel, On-Site etc). This can be useful for reimbursement claims.&#x20;

In [Edit mode](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items) you can search for or select existing categories from the list.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Fir8BclJKR1l0W2cnL0Os%2Fimage.png?alt=media&#x26;token=0e16b794-13ee-4468-9529-f98fef2c18fa" alt="" width="347"><figcaption></figcaption></figure>

Categories are defined by an administrator using the lookup: *Work Summary: Work Category* [lookup](https://docs.cw.crisisworks.com/system-administration/configuring-the-system/lookups).

#### Details <a href="#details" id="details"></a>

This setting records any additional information about the work time.

#### Attachments <a href="#attachments" id="attachments"></a>

This setting enables downloading supporting files as attachments.

In [Edit mode](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items) you can upload a file using the [File Upload](https://docs.cw.crisisworks.com/concepts-and-fundamentals/using-the-datagrid/editing-items#files) feature.

### Workflow <a href="#workflow" id="workflow"></a>

#### Status

This setting indicates the current step in the process.

The following table is a guide to the Statuses. For the state machine steps refer to the [Work Summary Time Entries Workflow Data Dictionary](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/broken-reference).

<table><thead><tr><th width="176">Stage</th><th width="138.76953125">Datagrid Icon</th><th width="387.98828125">Description</th></tr></thead><tbody><tr><td><strong>Active</strong></td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FiVXFNO3A478Q2W6xmZay%2Fimage.png?alt=media&#x26;token=c3a1a7a4-a12a-4787-a890-26b291654f25" alt="" data-size="line"></td><td>All Work Time Entries begin with this status by default</td></tr><tr><td><strong>Submitted</strong></td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FSRXZXrqCrvK08DmlPWuz%2Fimage.png?alt=media&#x26;token=51b94756-ec4e-491e-ad6a-fc538cb2477a" alt="" data-size="line"></td><td>Once all of the Work Time Entries have been added, the user or Payroll Manager can change them to this status. All of the fields become read-only and data can no longer be changed.</td></tr><tr><td><strong>ReOpen</strong></td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FJMHJdY0hHaGA7vBPEjU3%2Fimage.png?alt=media&#x26;token=88e942c6-0530-4e53-844d-502d5c519483" alt="" data-size="line"></td><td>Once submitted, changes can only be made when this status is set. Payroll Managers can enter a reason back to the user on what they need to change.</td></tr><tr><td><strong>Cancelled</strong></td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FiQ0Y4KO3s081JQXzjkEs%2Fimage.png?alt=media&#x26;token=66e526cb-ce10-433c-bdaf-cdcfaa2e1c8d" alt="" data-size="line"></td><td>The time entry has been cancelled. Once set to this Status it cannot be un-cancelled.</td></tr><tr><td><strong>Rejected</strong></td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F3bP58T4V44jRruJOkjPl%2Fimage.png?alt=media&#x26;token=b0e7a7ef-2722-4c38-b889-6a02ce21ee16" alt="" data-size="line"></td><td>The Payroll Manager has rejected the time entry.</td></tr><tr><td><strong>Manager</strong> <strong>Approved</strong></td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FAiXzQ50FRZLkp130Z8hI%2Fimage.png?alt=media&#x26;token=2c9ed40d-bdf7-4b50-baea-17715c709f90" alt="" data-size="line"></td><td>The Payroll Manager has approved this time entry.</td></tr></tbody></table>

## Editing <a href="#editing" id="editing"></a>

Work Time Entries can be edited from the datagrid.

1. Navigate to the register
2. Locate the item you wish to edit by using the Edit button <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FMAt3SdDCVeaavZpkxUrB%2Fimage.png?alt=media&#x26;token=bf8178b8-3a9c-4b0d-9c30-009542c2ad7b" alt="" data-size="line">
3. Make the necessary changes to the settings
4. Save <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FN4Q1ymwZJ5s252DI8Xac%2Fimage.png?alt=media&#x26;token=ea3758c1-f326-47ba-ac4c-c1460bcfcd0f" alt="" data-size="line">

## Adding <a href="#adding" id="adding"></a>

Work Time Entries are sub-items of Work Summaries and as such can only be added via the Work Summary [Work Times](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/your-user-profile-and-duties/work-summaries/..#work-times).
