# Library

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

You can use the Library register to store procedures, policies, job descriptions, minutes of meetings, plans, references guides, facility guides and anything else that you need to share with your users.

The Library register contains *Library Items*. There are different types of Library Items for different purposes, the type is known as the **Reference Type**. You will have the option of choosing what type of you are creating when you add a new Library Item.

Library Items can be for a specific event, or accessible across all events.

Library Items provide the following features:

* Ability to manage access to items by saving in the current event, an agency workspace or the global workspace.
* Set a review date and assign the item to a position to maintain the record.
* Library items are captured simply using free-text **subject,** **description** and **attachment** fields.
* Various workflow fields allow you to manage the **status**, **set a review date, assign** and **tag** to aid in management.
* **Tagging** to help manage groups of items to make them quick and easy to find in an emergency.
* Library items can be assigned to **positions** to own and maintain.
* Assignment and management of library items are handled by **coordinators**
* Users with permission can to send the library item or a link to the item as a **Communication Message.**

### Types of Library items

The Library register offers different types (sometimes known as schemas or templates) that can be added. To select a different type, under [Details](#details) select a [Reference Type](#reference-type) before proceeding. You will have the option to choose the type of library item to create when adding a new *Library item* record.

{% hint style="info" %}
Take care to select the appropriate Reference Type first before creating an Item because it can be difficult to convert between them later.
{% endhint %}

<table><thead><tr><th width="397">Type</th><th>Summary of use</th></tr></thead><tbody><tr><td>Document</td><td>This is the most general library schema, and most commonly used for general documentation and information sharing.</td></tr><tr><td>Geospatial Feature</td><td>A flexible information storage record with geospatial (map-based) information, which allows storage of data such as affected area extents, location of key facilities, etc.</td></tr><tr><td>Meeting</td><td>An agenda and minutes of a meeting, including audio recording and attachments such as photos of whiteboards.</td></tr><tr><td>System Text</td><td>Help text that appears on public forms pages such as Relief Registration, Offers and Permits. <br>See <a href="library/system-text">Special Library Items</a></td></tr></tbody></table>

{% hint style="info" %}
Enterprise customers: you may have additional schemas as part of your custom deployment. Consult your enterprise solution guide for details.
{% endhint %}

### Access <a href="#requests-usingrequests" id="requests-usingrequests"></a>

To access the Library:

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/operations#positions). If you can't access it after doing this, contact your System Administrator (Requests must be enabled within the current event).
2. Navigate to:\
   Library → Library Items

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FpSbG91jyO7Kr5garmlfP%2Fimage.png?alt=media&#x26;token=c268554a-e84b-4903-81b6-0b138dbe6c7f" alt=""><figcaption><p>Location of Library module and Library Items register in the menu</p></figcaption></figure>

### Setup and Configuration

To enable the Library module, you need to [add the Library Item register to the Event](https://docs.cw.crisisworks.com/system-administration/managing-events#registers), along with [Operations positions](https://docs.cw.crisisworks.com/operations#information-editinganexistinginformationitem). Most Operations positions support management of Library items. In addition, [security policies](#security-policies) for Library items, can be assigned to any position.

You can set up Workspaces for secure access areas restricted to specific positions [using the Document type with Global Events](https://docs.cw.crisisworks.com/modules/document#workspaces).

#### 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 Information:

<table><thead><tr><th width="239.546875">Security Policy</th><th>Use</th></tr></thead><tbody><tr><td><p>Library Access</p><p></p></td><td>Read only access to library items in involved events.</td></tr><tr><td><p>Library Officer</p><p></p></td><td>Full read/write access to library items in involved events</td></tr></tbody></table>

</details>

## Finding Library items <a href="#information-editinganexistinginformationitem" id="information-editinganexistinginformationitem"></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 Library items:

* [Datagrid](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid#data-grid-view) view
* [Map](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid#map-view) view&#x20;
* Filters including workflow status, assigned to me, overdue items, types, tags and more.
* Combination filters and search by most fields including assignment, status, review date, type and more.

## Viewing Library items <a href="#information-editinganexistinginformationitem" id="information-editinganexistinginformationitem"></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 %}

Library items are listed in and searchable via the register [Datagrid](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid#data-grid-view).

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FOyzpgX9oqyKj4KXCuquX%2Fimage.png?alt=media&#x26;token=7bf0920e-9283-4c16-9fd8-3f614eb228b2" alt=""><figcaption><p>Sample Library items datagrid</p></figcaption></figure>

## Updating Library items <a href="#information-editinganexistinginformationitem" id="information-editinganexistinginformationitem"></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 %}

To edit an existing library record:

1. Navigate to the Library register
2. Select the Library item you wish to edit and select the Edit button <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FlKVt1ZIkWu060DBQjwaJ%2Fimage.png?alt=media&#x26;token=b1cadc33-da3e-4210-b171-1c207cbfea57" alt="" data-size="line">&#x20;
3. Make any necessary changes to the settings (see below).
4. Save <img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcqOFDnLQJrycDuF92TBup_FZEti4cn7CV1cnHFqdDlcTKCqVGKvuvurkzQb_ejVeqPcdo_aC-IdZrD75fRxUrJhBoGgIEJDYzrlgua29OXuhAvotyqmWMu0fC2PubloPavivkPbg=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line">

## Library Settings

Library records are divided into the following sections (sections may or may not appear depending on information entered, your permissions level, and what mode you're viewing):

| Left Column                   | Right Column                      |
| ----------------------------- | --------------------------------- |
| [Record Notes](#record-notes) | [Details](#details)               |
| [Content](#content)           | [Communication](#communication)   |
|                               | [Classification](#classification) |

### Content

The Content selection presents the settings for the selected [Reference Type](#types).

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

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

{% content-ref url="library/geospatial-feature" %}
[geospatial-feature](https://docs.cw.crisisworks.com/modules/library/geospatial-feature)
{% endcontent-ref %}

{% content-ref url="library/system-text" %}
[system-text](https://docs.cw.crisisworks.com/modules/library/system-text)
{% endcontent-ref %}

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

#### Reference Type <a href="#reference-type" id="reference-type"></a>

The Type field controls the [type of library item](#type) and will change the list of fields. The default type is Document which is the most flexible and commonly used type.

To select a different type, under **Details** select the **Reference Type** field before proceeding.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FFgZODJForUEXYz5reqe9%2Fimage.png?alt=media&#x26;token=33edd61e-31c5-419f-9883-b8e1c66a64d7" alt="" width="375"><figcaption><p>Select Library Type</p></figcaption></figure>

Depending on the type selected you will be presented with a different set of fields and options for data entry.

#### Status

The following workflow applies to library document.

<table><thead><tr><th width="156">Status</th><th width="119.796875">Datagrid Icon</th><th>Usage</th></tr></thead><tbody><tr><td>Current</td><td><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUeKV1-75Rd4TiBkQz2KfZk_gkViZjeRb7pHOZkaMnPH-uVNNdd2SIxYvDLhcDcLVn5HohAt_LNK_CvpD-BGnVDo3vgxYfo_Jg60zY5lWsD6qsjKDTWefc5gY3US0E2-Uh0iAG8DgQ=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line"></td><td>The document contacts current information</td></tr><tr><td>Expired</td><td><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfXM6RML9OfeB4leTDYLFqSKIaTmY_T6-rFYwOj3PjibKAmJIenXhfVyugzjE8l9zI-finofiR_N0YXYUlvU3YqYh5wkWVOgCzguLQ-8yPESkApQn0l2CaxvyrdMErs1h1Prt1nOw=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line"></td><td>The document has expired and is no longer current</td></tr><tr><td>Review</td><td><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUeCkcfa82sQF-OOufjyi4j8mL68T0w9B6qBGyuus2FuEOHweEwyP4cf2AlexXQJuIeD43GCKr0UcfdfNcbJXjebz56SYBCUEz6qezLAFf0zvu_goEJu82OVh2pJ8SOMCJuS3hxc=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line"></td><td>The document should be reviewed for currency. This status is transitioned automatically whenever a review date is set and becomes due</td></tr><tr><td>Delete</td><td><img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfvga6F5gTZwYDG9y-XwsPevnF0OJwmYT4UAjAfFtO47hAyLNRx1m8LNAbGFpQHlDMh2Q1nHzkSDldlYevH5Erv3vcWY8pcDfYy-LIuJ2x44xaOuTXF-mUvLLukr1pVKM4qGOw9=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line"></td><td><p>The library item is marked as deleted and is no longer current.</p><p>Note there is no way to physically delete items in Crisisworks, however you can <a href="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#classification">move the item</a> to an archive event to remove it completely from view.</p></td></tr></tbody></table>

#### Assignment <a href="#requests-assigningarequest" id="requests-assigningarequest"></a>

Library records can be assigned to positions or users. The assignee is responsible for maintaining accuracy of the information, and will receive notifications whenever items under their control become ready for review.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FbpvO9DvegyFCOs1PThHU%2Fimage.png?alt=media&#x26;token=04db34a1-c676-462d-a5c4-e89dda5a4bb7" alt="" width="375"><figcaption></figcaption></figure>

#### Review <a href="#referencelibrary-review" id="referencelibrary-review"></a>

Tick the **Set a Review Date** checkbox and enter a review date. When that date is reached, the record will automatically be set to the Review status <img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUdTMdNo0bVAQ3nwbG7xB7p87jzw9BgRIhkl-c89T3dnEIojL8h-Of1NcDOury3Cbc3wCz1GSOQUSdRSiLitJ-L1Vx8ryd57WQ7_bz6imHd9w8E7bcR0vDZoO35pNTnKPE_3_Ihf=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line"> and a notification will be sent to users on duty on the assigned position.

#### Featured

Tick the **Featured** checkbox to include the document in the "Featured" counter.

### Communication

The Library supports the **Create a new communication** function to Share this record via email or SMS.

This function is only available for certain user types.

For more on this function see [Communication](https://docs.cw.crisisworks.com/modules/communication).

### Classification

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

## Updating Library items

{% 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 %}

When updating Library items:

* Make sure to add notes using the yellow [**Record Notes**](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#recording-notes) field, these can be useful as the item is managed.
* ​**Workflow** should be progressively updated to reflect the current status of the item.

### Record Notes

When editing, you can record notes as you make changes to the Library item in this section which will appear in the Activity log.

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

## Adding Library items

To add a new library item:

1. Select the **New Library Item** <img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUf_GtbbC_xeU67Sqi-NbZuZZTra5gE621OS-bNEGVuieTSh5tdXT_hVJFmKZqrsLiNv-bjheNU7_painiCMC79jq-6vq3ZpvDfYJ09YIOPPdX3jBqn1ryzLQtqtzgLts0M1CX1o=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line"> button.
2. Select the schema [**Type**](#types-of-library-items)
3. Enter the **Title** and add details in the **Body** of the document.
4. Upload any **Attachments** by dragging and dropping files from your computer into the attachments box, or by clicking Add File.
5. Optionally add **Tags** to identify the document, and set **Is Featured** to add the document to the **Featured** filter.
6. Select the **Event** to save the document. By default this will be the currently-selected event, however, you may wish to save the document into the Global Workspace or the Agency Workspace, if the document is to be permanently accessible.
7. Optionally **Assign** the record to a Position and set a review date.
8. Save <img src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUcqOFDnLQJrycDuF92TBup_FZEti4cn7CV1cnHFqdDlcTKCqVGKvuvurkzQb_ejVeqPcdo_aC-IdZrD75fRxUrJhBoGgIEJDYzrlgua29OXuhAvotyqmWMu0fC2PubloPavivkPbg=s2048?key=h-L5f5l-fE0G5R1N5-x9jS7u" alt="" data-size="line">

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Fbje4lbIPRqRLcKAp5KHU%2Fimage.png?alt=media&#x26;token=2cacc1cc-ab92-4f45-9997-ed1425a69b90" alt=""><figcaption><p>Sample Library Item</p></figcaption></figure>

## Bulk Actions

{% 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 on Library items via the [Actions menu](#bulk-actions).

| Action                    | Description                                                                                                                                                                              |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Copy IDs                  | See [Copy IDs](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#copy-ids)                                                         |
| Bulk Edit                 | <p>See <a href="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#bulk-edit">Bulk Edit</a></p><p>Update for multiple Library items: Record Notes, Status</p> |
| Export Selected to Report | <p>See <a href="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#export-to-report">Export to Report</a></p><p>Generates Library Report</p>                  |

## Reports

A **Library Documents Report** can be found under the Reports menu. Enter the search term 'library' to find it quickly.&#x20;
