# Logs

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

A log is a record of a person’s observations, intentions, actions and decisions. In an emergency context this is typically a position log and the system enables you to record these electronically. Logs are accessible by other users with the same position, as well as coordinators.

Log records are deliberately simple and include the date, the person who created the log and the message to keep it easy to use and manage.

Logs are also permanently kept in the audit trail so take care when creating one. Even if you update it, the original unedited message stays in the [Activity Log](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/viewing-items#activity).

{% hint style="info" %}
There are a number of ways to publish information in the system. Logs are typically shared only with others in your position.

If you wish to share information with others, or send something as a formal [Communication](https://docs.cw.crisisworks.com/modules/communication), consider using an [Information](https://docs.cw.crisisworks.com/modules/operations/information) record instead.

If you wish to add notes to an existing record such as a case note on a recovery record.
{% endhint %}

### Types  <a href="#types" id="types"></a>

All types of logs essentially functions like a digital version of a log book or diary and are used for auditing purposes, however they are recorded differently.

The following are available types of Logs:

<table><thead><tr><th width="137">Name</th><th>Summary of use</th></tr></thead><tbody><tr><td><a href="logs/log-entry">Log Entry</a></td><td>Record a person's account of a situation or a message that is important for the whole team to see.</td></tr><tr><td><a href="logs/decision">Decision</a></td><td>Record a decision that has been made and the reasons for the decision.</td></tr></tbody></table>

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

To access Logs:

1. [Go on duty](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/working-with-events#setting-your-duties-for-events) with an [Operations position](https://docs.cw.crisisworks.com/modules/operations/..#positions).&#x20;
2. Navigate to:\
   Operations → Logs

{% hint style="info" %}
If you can't access it after following these steps, contact your System Administrator (Logs must be correctly configured - refer to [Setup and Configuration](#finding)).
{% endhint %}

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FZZJV5u5aAE1YQhl1xTY2%2Fimage.png?alt=media&#x26;token=a63e5a64-8e7d-4cff-badd-5ddd6d36dafe" alt="" width="375"><figcaption><p>Location of the Logs register in the Operations module</p></figcaption></figure>

### Setup and Configuration <a href="#finding" id="finding"></a>

To enable Logs, Administrators need to add the Log register [to the Event](https://docs.cw.crisisworks.com/system-administration/managing-events#registers), along with [Operations positions](https://docs.cw.crisisworks.com/modules/operations/..#positions). Most Operations positions support use of Logs. In addition [security policies](#security-policies) for Logs can be assigned to any position.

#### Security Policies <a href="#security-policies" id="security-policies"></a>

Refer to: [Positions: Security Policies](https://docs.cw.crisisworks.com/system-administration/configuring-the-system/positions#security-policies)

<details>

<summary><strong>Security Policy explanations</strong></summary>

The following security policies apply to Logs:

<table><thead><tr><th width="239.546875">Security Policy</th><th>Use</th></tr></thead><tbody><tr><td><p>Log Coordination</p><p></p></td><td>Full access to view and edit all Logs</td></tr><tr><td><p>Log Officer</p><p></p></td><td>Can view all logs and update own log items</td></tr><tr><td>Log Read Only</td><td>Can view all logs but not update</td></tr></tbody></table>

</details>

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

{% content-ref url="../../concepts-and-fundamentals/on-a-computer/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 *Logs*:

* [Datagrid](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid#data-grid-view) view
* [Filters](#information-editinganexistinginformationitem-1) including workflow, type and region
* 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%2FfOrS0UNNXlqCcztCAP4Y%2Fimage.png?alt=media&#x26;token=e5d05404-3677-40f1-a990-66957e4565fd" alt=""><figcaption><p>Logs register datagrid (sample view)</p></figcaption></figure>

#### Filters <a href="#filters" id="filters"></a>

Filters help make management of *Logs* easier by focusing on specific groups of items on the datagrid.

<details>

<summary>Filter menu explanations</summary>

| Filter Group | Filter/s                                        | Use                                                                                                                                                                                                                                              |
| ------------ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Main         | ​Active                                         | ​                                                                                                                                                                                                                                                |
|              | Recently Updated                                |                                                                                                                                                                                                                                                  |
|              | All                                             |                                                                                                                                                                                                                                                  |
| Types        | ​Decision                                       | ​Finds all items with Type of Decision                                                                                                                                                                                                           |
|              | Log Entry                                       | Finds all items with Type of Log Entry                                                                                                                                                                                                           |
| Region       | \[List is based on your system configuration]\* | Refer to: Regions                                                                                                                                                                                                                                |
| Workflow     | Logged                                          | Finds all items with Status of Logged                                                                                                                                                                                                            |
| Active tags  | \[List is based on your system configuration]\* | <p>Any tags in use.<br>Refer to: <a href="https://app.gitbook.com/o/XTVHxRDLJsgVRj4dNFUc/s/Ny7IznbrPLUq6GJDDQDk/concepts-and-fundamentals/registers-and-datagrid/working-with-register-items/editing-register-items/tagging-items">Tags</a>​</p> |
| Assignments  | Unassigned                                      | Finds all items that are Unassigned                                                                                                                                                                                                              |

\* May vary based on your system configuration

</details>

## Opening and Viewing <a href="#opening-and-viewing" id="opening-and-viewing"></a>

{% content-ref url="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/viewing-items" %}
[viewing-items](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/viewing-items)
{% endcontent-ref %}

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

Logs are divided into the following sections (sections may or may not appear depending on what information is entered, your permissions level, and what mode you're viewing):&#x20;

| Left Column                   | Right Column                      |
| ----------------------------- | --------------------------------- |
| [Record Notes](#record-notes) | [Options](#options)               |
| [Main](#main)                 | [Classification](#classification) |
|                               | [Administrative](#administrative) |
|                               | [Activity](#activity)             |

### Record Notes <a href="#record-notes" id="record-notes"></a>

When editing, record notes in the [rich text field](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#rich-text-fields) as you make changes which will appear in the Activity log.

Refer to: [Recording Notes](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#recording-notes)

### Main <a href="#main" id="main"></a>

The Main section presents the settings for the selected [Log Type](#types).

Refer to the Log Type article for relevant type specific settings:

{% content-ref url="logs/log-entry" %}
[log-entry](https://docs.cw.crisisworks.com/modules/operations/logs/log-entry)
{% endcontent-ref %}

{% content-ref url="logs/decision" %}
[decision](https://docs.cw.crisisworks.com/modules/operations/logs/decision)
{% endcontent-ref %}

#### Status

Refer to: [Viewing Items: Workflow](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/viewing-items#workflow)

This setting is used to indicate the workflow stage that the Log is in.

Refer to the Log Type setting.

* [Log Entry Status](https://docs.cw.crisisworks.com/modules/operations/log-entry#status)
* [Decision Status](https://docs.cw.crisisworks.com/modules/operations/decision#status)

#### Attachments

The Attachments field supports adding as many files as necessary to the log.  These are uploaded using the [Add File button](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#attaching-files).

### Options

#### Type

Enables selection of a Log [Type](#types).&#x20;

{% hint style="info" %}
It is recommended to chose the type once only. It is not recommended to switch between types
{% endhint %}

#### Tags

Used to classify logs and navigate to a specific collection of items.&#x20;

For example logs related to Emergency Operations Centre could use the tag EOC to distinguish them from other logs.&#x20;

Refer to: [Tagging Items](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/tagging-items)

### Classification <a href="#classification" id="classification"></a>

The event that the Log belongs to is set here. Allows Logs to be moved from one event to another.

Refer to:  [Editing Items: Classification](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#classification)

### Administrative

#### Save this item as a template

This setting can be used to create a template with presets which can be copied and re-used.

A template can help with this.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F4bRT7MVt6sClggopzO1G%2Fimage.png?alt=media&#x26;token=1e8414fe-f83a-4e23-9f62-5626444f3e3a" alt="" width="375"><figcaption><p>Save this item as a Template option</p></figcaption></figure>

### Activity

Refer to: [Viewing and Opening Register Items: Activity](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/viewing-items#activity)

## Updating <a href="#updating" id="updating"></a>

{% content-ref url="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items" %}
[editing-items](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items)
{% endcontent-ref %}

{% hint style="info" %}
Logs are also permanently kept in the audit trail so take care when creating one. Even if you update it, the original unedited message stays in the [Activity Log](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/viewing-items#activity).
{% endhint %}

When updating *Logs*:

* Add notes on your edits in the **Record Notes** field
* Do not change the Type. Consider creating a new Log if you wish to use a different type.
* Complete each section of the [Settings](#settings) as required including the Log Message or Decision. Note that some options may open up new sections to complete.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F2eZepcC75ggkpClSONik%2Fimage.png?alt=media&#x26;token=28e242c0-c76f-42cb-a889-d1227157870f" alt=""><figcaption><p>Editing a log message. Note that the original unedited message is preserved in the Activity log at the bottom right.</p></figcaption></figure>

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

1. From the register, in the New item menu select the **New Log**   <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FxhOnDvtGl7QzdrgxVBqr%2Fimage.png?alt=media&#x26;token=83ca3c44-dd70-4e04-b3f9-ca84a9c33cda" alt="" data-size="line"> button (or drop down the list from any other register and select it)
2. Under [Options](#options) section, select the [Type](#type) then complete each section of the [Settings](#register-item-settings) for that Type as required.&#x20;
3. Save <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F2qJNRqfHczOPl1cKEcMo%2Fimage.png?alt=media&#x26;token=1f653f47-1199-4f87-88da-313768ca3dac" alt="" data-size="line">

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FvGQcDvVsxWW7D1h7ETiY%2Fimage.png?alt=media&#x26;token=01109a3e-5fb0-4ac5-8bfe-80bdc851d803" alt=""><figcaption><p>New Log screen</p></figcaption></figure>

## Bulk Actions <a href="#bulk-actions" id="bulk-actions"></a>

{% content-ref url="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions" %}
[bulk-actions](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions)
{% endcontent-ref %}

The following additional bulk actions can be performed via the Actions menu:

| Action           | Description                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Copy IDs         | Refer to: [Copy IDs](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#copy-ids)                                    |
| Export to Report | <p>Refer to: <a href="../../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#export-to-report">Export to Report</a><br>Runs the Logs Report</p> |
| Create a Copy    | Refer to: [Create a Copy](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#create-a-copy)                          |

## Reports <a href="#reports" id="reports"></a>

{% content-ref url="../../system-administration/reporting/running-reports" %}
[running-reports](https://docs.cw.crisisworks.com/system-administration/reporting/running-reports)
{% endcontent-ref %}

The main report for Logs is the  Logs Report found in [Operations Reports](https://docs.cw.crisisworks.com/modules/reports/operations-reports).
