# Basic use

There are multiple ways to navigate registers, including the Filter Menus, Search and the Datagrid.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F8q4nMyFAkM8eT5m9t4cb%2Fimage.png?alt=media&#x26;token=993b21df-1fd8-48d1-b668-6c91e73c0b8d" alt="" width="563"><figcaption><p>Register navigation</p></figcaption></figure>

## Views

Datagrid is the default view mode, however Map mode is also available.

To toggle between these modes use the corresponding grid icon.

The two main view modes are:

* Datagrid <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FrbTAihIssmarKoCpSmJg%2Fimage.png?alt=media&#x26;token=16a2f2a3-541b-4785-bb46-25d26a5788ee" alt="" data-size="line">
* Map <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FYKRhplVOvlUAPi9OUyCf%2Fimage.png?alt=media&#x26;token=2288c4fa-6444-456c-8797-c57cf2fe8d7b" alt="" data-size="line">

These icons can be found at the top right of the Register navigation bar.

***

## Datagrid View

The Datagrid by default shows all items listed over a number of pages.

The following filters are available to refine the list.

### **Filter Menus and Filters**

The easiest way to filter and view a list of items is to use a Filter menu.

Filter menus are grouped by categories. You can expand a category using the arrow symbol on the left of the category name.​

To activate a Filter, use the relevant blue link.

The MAIN filters include frequently used presets.

These vary from register to register but include:

* **Active** - any items that are in progress and not closed
* **Recently Updated** - items updated recently (i.e. in the last week)
* **Assigned to Me** - items either assigned to a position that is in your user profile, or to your user individually
* **Overdue** - items that have a due date set that have passed that date
* **All** - includes everything including items that have an active or inactive/closed status

### **Using the search**

To filter the datagrid use the Search icon <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FTArSQYBEoBMZXS3mqMNV%2Fimage.png?alt=media&#x26;token=0b61845b-ef9a-4395-ab30-9760815cda66" alt="" data-size="line"> in the Navigation Bar to open the Search Bar or activate the Register filters using the Filter icon <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FQPbmDRyKVmpmPClqpGC3%2Fimage.png?alt=media&#x26;token=de853fcd-4c63-4f07-b626-c8ec71d4f605" alt="" data-size="line">.

More information on the search parameters can be found in the [Searching and Querying](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/searching-filtering-and-querying-registers) section.

### Viewing the Datagrid and items list

The Datagrid displays the relevant items of the currently activated filter.

The default datagrid displays 50 items at a time and is typically sorted with the most recently updated records at the top by default.

### Status, Priority & Progress <a href="#conceptualoverview-status-priority-and-progress" id="conceptualoverview-status-priority-and-progress"></a>

Most registers use a **status** system controlled by strict rules known as a **state machine**. This ensures that only authorised users can set specific statuses, and that items proceed through the status workflow in a defined logical order. A core feature of Crisisworks is that each register has its own state machine, allowing workflow to be tuned to the needs of each register. To fully understand how a register operates, it's important to understand the status progression within its workflow.

While each register has its own workflow process, they generally follow a common colour-coded convention:

* **Red** ![](https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FaWqGvilKArIVjGB6p5K2%2Fimage.png?alt=media\&token=0bdf14f5-5f7c-48bb-b975-321a022d7608) is unhandled and needs to be assessed and assigned
* **Yellow** <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FzUop3V7e8wisBvxBkbRV%2Fimage.png?alt=media&#x26;token=de924ed3-565a-47c5-a01f-197e0f62c2c1" alt="" data-size="line"> is assigned but not underway
* **Blue** <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FZcSIvkCdDBsVNDk7qaJc%2Fimage.png?alt=media&#x26;token=68b88097-ab55-4aa1-aa89-fb70c5da21b0" alt="" data-size="line"> is in progress
* **Green** <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FmVhoQrw6fJcGEasWntet%2Fimage.png?alt=media&#x26;token=fab6a102-2d0d-4833-896b-09577e001741" alt="" data-size="line"> is safe or completed
* **Grey** <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Fde4cNgjE1SMZkISWhQwp%2Fimage.png?alt=media&#x26;token=8c2d7608-552d-448a-a5ac-d9272e325ca3" alt="" data-size="line"> is inactive or completed

### **Navigating Datagrid pages**

To show more items, use the pagination controls at the bottom of the item list.

Click the number of the page, or move between sets of items using the controls.

To view less or more items per page, select the number option to set the ‘Items per page’. The view will update automatically.

### **Resizing Columns**

To change the width of a column, drag and drop the bar separating the column headers left or right.

### **Sorting Ascending or Descending**

To sort the datagrid by a column, click the columns header to sort by that field (ascending or descending). The up arrow indicates ascending order and the down arrow indicates descending order.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2F0e50NS10PKtWyKOG0GSY%2Fimage.png?alt=media&#x26;token=633a34e4-56f5-4f3b-aee5-664e29730484" alt="" width="128"><figcaption><p>Sorting by a column by toggling the up and down arrow</p></figcaption></figure>

You can sort by as many columns as necessary.

{% hint style="info" %}
Sorting is only available on select columns such as ID, Name and Date.
{% endhint %}

### **Changing column order**

To change the order of the columns in view, drag and drop the column you want to move left or right in the datagrid.

### **Modifying and grouping by the column list**

The Columns menu at the top right of the datagrid allows you to customise which columns are visible.

### **Adding or removing columns**

Not all available columns may be displayed. To add or remove columns to the datagrid display:

1. Click the Columns menu at the top right corner of the datagrid and select **Choose Columns**.
2. Tick the checkboxes next to the columns you want to display. To show all columns, click **Select All**.
3. Select **OK** to save and refresh the column list

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FSW3TKtyihcKy8tDcwrT1%2Fimage.png?alt=media&#x26;token=ee20fecc-119b-4f38-b189-c017773d0388" alt="" width="175"><figcaption><p>Choose Columns and Group by Column can be found in the Columns menu</p></figcaption></figure>

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FZOSLE8yabGY0L8f2vMf3%2Fimage.png?alt=media&#x26;token=f4959baf-f9ec-4715-9ac1-3c83f824f287" alt="" width="249"><figcaption><p>Searching and selecting available columns using tick boxes</p></figcaption></figure>

### **Grouping by columns**

To group by columns:

1. Open the **Columns** menu at the top right corner of the datagrid and select **Group by column**.
2. Drag the column header into the space directly above the column headers. Groupings will be created in real time as column headers are added, showing the number of items in each group.
3. Add more column headers as needed.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FK89zfJq1LlFLW6EWsfwf%2Fimage.png?alt=media&#x26;token=060d870d-6ae6-490e-8997-c430ef908b97" alt=""><figcaption><p>Dragging items into the column header to group</p></figcaption></figure>

To **sort** within a group, click the column header. An up or down arrow will indicate the current sort direction, just like in the main datagrid view.

To **remove** a column header from the grouping, click the cross on its right.

To **restore** the datagrid view back to the default, select **Restore to initial state** from the columns menu.

### Actions Menu

The Actions menu provides access to additional functions for bulk management of records within a register. It is located in the Datagrid menu bar to the top right of the datagrid.

The available options will depend on the functions available for the register you are using, your duty and permissions and whether or not you have selected records.

{% hint style="info" %}
Most actions will only work if you have an Event selected
{% endhint %}

This can include:

* **Bulk edit** (requires selecting of one or more records - see Working with Register Items)
* **Export to Report** (exports all records, or only selected ones if any are selected)
* **Create a Copy** (duplicate an item)
* **Copy IDs** (to clipboard)
* **Generate file** (such as a Mail Merge) (requires selecting of one or more records)

***

## Map View

The Map View displays register items from the current filter in a geo-spatial format, using markers, polygons and overlays (layers).

* To activate Map View select the pin icon <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FYKRhplVOvlUAPi9OUyCf%2Fimage.png?alt=media&#x26;token=2288c4fa-6444-456c-8797-c57cf2fe8d7b" alt="" data-size="line"> from the top right of the Register navigation bar.
* Zoom in and out using the ![](https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FSCUlsECyzwvJrIzZPWEQ%2Fimage.png?alt=media\&token=bd8820d5-af95-464b-b199-41745a28d993) and ![](https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Fy4oLCjk6KpcjfHpbLWRB%2Fimage.png?alt=media\&token=8a3b7656-ff42-4a37-96d7-d85367949f37) controls at the top left, or use the pinch/spread gestures if using a touch screen or mobile device.
* To move the map around, select and drag the map area.
* Click the **full screen icon**<img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Fq47EAoDrwnSXJTepxTnf%2Fimage.png?alt=media&#x26;token=bb09db4c-3475-4c48-a6b1-6d72ecc4102b" alt="" data-size="line">(bottom left) to expand the map.
* You can filter by asset class using the drop down list at the bottom of the screen.
* Click the **Layers icon**<img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Fxj3UwqYkeDtgVDf9r1Gf%2Fimage.png?alt=media&#x26;token=f4ec4202-694e-4309-a916-e81358879f01" alt="" data-size="line"> (bottom right) to toggle available map overlays.
* To **exit Map view**, click the datagrid view button <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FZ77y3sj0X3ryszhkTIeE%2Fimage.png?alt=media&#x26;token=adc1982f-2033-4215-8f8b-fda932decb2a" alt="" data-size="line"> (top right).

### Viewing Items from the Map

* Items on the map are indicated by **Points**, **LineStrings** and **Polygons**, typically colour coded according to their workflow state.
* Pins can have icons depending on their register. For example, on the map a [Request that is 'Requested](https://docs.cw.crisisworks.com/modules/operations/requests#request-workflow)' has an icon that looks like an blue in-tray <img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FDlZz0bGe2VCvqUNawfxm%2Fimage.png?alt=media&#x26;token=3d2668bb-7202-47b6-8ae7-f7821f4d68ad" alt="" data-size="line">.
* To **view a summary** of an item, tap the icon on the map.
* Selecting **View** in the summary links you directly to the full item details.

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2Ftl9Ay2XL8mRuRGmecBNv%2Fimage.png?alt=media&#x26;token=368b4c30-2c46-44ba-8522-558002fa247f" alt="" width="210"><figcaption><p>Tapping an icon on the map reveals a summary of the icon.</p></figcaption></figure>
