# Agriculture

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

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

The Agriculture register records impacts to crops. Agriculture is a sub-item of [Cases](https://docs.cw.crisisworks.com/modules/recovery/cases) and as such items in the register are attached to or added in existing Case record(s). Once added you can manage existing Agriculture records directly in the register.

This register provides the following features:

* Track agriculture impacts from initial damage to recovery
* Access a map based view of agriculture impacts
* Record the **location** and extent of agriculture impacts
* Record different **agriculture types** (wheat, grains, peas etc), including the **damage level** records the extent of crop damage along with the **damaged area in hectares**
* Record a detailed description of the damage and estimate of **damage value** for financial recording purposes
* Add evidence including **photos**

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FIoBqqB8oeUIlk93RgQxa%2Fimage.png?alt=media&#x26;token=ac256a9e-5010-479c-8fe8-7c0687bd9541" alt=""><figcaption><p>Agriculture register (sample view)</p></figcaption></figure>

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

To access *Agriculture*

* Agriculture must be [enabled for the event](https://docs.cw.crisisworks.com/system-administration/managing-events).
* [Go on duty](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/working-with-events#setting-your-duties-for-events) with an appropriate role such as Recovery Officer or Recover Manager. If you can't access it, ask your administrator to check your permissions.

Locate the *Agriculture* register under **Recovery > Agriculture** in the menu.&#x20;

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FBDDmx3lGh1tQx5ZUqH58%2Fimage.png?alt=media&#x26;token=238be362-e5a4-40f9-a48d-9b9cb916eac1" alt="" width="375"><figcaption><p>Location of the Agriculture register in the Recovery module</p></figcaption></figure>

## Finding Agriculture 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 *Agriculture*:

* [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
* [Filters](#information-editinganexistinginformationitem-1) including workflow, agriculture types (barley, canola etc) and tags
* Combination filters and search by most fields

### Filters <a href="#information-editinganexistinginformationitem" id="information-editinganexistinginformationitem"></a>

Filters help make management of *Agriculture* 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%2F7jMWyB7V2vyfk9KbtWZA%2Fimage.png?alt=media&#x26;token=53e7b968-dcc3-480d-b79d-6088896dc617" alt="" width="139"><figcaption><p>Agriculture filter menu</p></figcaption></figure>

<details>

<summary>Filter menu explanations</summary>

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

<table><thead><tr><th width="247">Filter Group</th><th>Filter/s</th><th>Use</th></tr></thead><tbody><tr><td>Main</td><td><p>Active</p><p>Recently Updated<br>All</p></td><td></td></tr><tr><td>Workflow</td><td>Damaged</td><td>Finds all crops with the Status of <a href="#workflow">Damaged</a></td></tr><tr><td></td><td>In Progress</td><td>Finds all crops with the Status of <a href="#workflow">In Progress</a> (undergoing remediation)</td></tr><tr><td></td><td>Closed</td><td>Finds all <a href="#workflow">Recovered</a> crops</td></tr><tr><td>Agriculture Type</td><td>[List is based on your system configuration]*</td><td>Finds Agriculture by type (for example Barley, Canola etc)</td></tr><tr><td>Active tags</td><td>[List is based on your system configuration]*</td><td><p>Any tags in use.</p><p>Refer to: <a href="../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/tagging-items">tags</a></p></td></tr></tbody></table>

\* May vary based on your system configuration

</details>

## Viewing Agriculture <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 %}

When viewing *Agriculture*, sections can be expanded to show information.

As each section is completed, new sections may show additional information.&#x20;

Some features of the view mode include:

* **Fetch contacts** - using this button shows the relevant contact details for the property if you have access
* **View Map** - using this button shows a polygon or point outline of the item on the map

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FtxZLlXPOIG5O8TtWubCe%2Fimage.png?alt=media&#x26;token=8ab902c7-eab3-494b-92fd-b3fa1385662a" alt=""><figcaption><p>Agriculture item for Canola that is in progress</p></figcaption></figure>

## Agriculture Settings

Agriculture is 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) | [Workflow](#workflow)             |
| [General](#general)           | [Related](#related)               |
|                               | [Classification](#classification) |

### Record Notes

When editing, you can record notes 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)

### General

This section includes all the details of the impact to the crop including the address, the type, damage level, description, damage value and photos.

#### Address

The address can be different to that of the Case for situations were the crops are not on the primary property. Use the [Location](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#location) field to enter an address.

#### Agriculture Type

This field sets the type of crop (for example Barley, Canola etc). Use the lookup list to search for the specific crop. Your Administrator configures the list of levels for your site using the Recovery: Agriculture Types [lookup](https://docs.cw.crisisworks.com/system-administration/configuring-the-system/lookups).

#### Damage area in hectares

This text field records the damaged area in hectares.

#### Damage Level

This field records the damage level as a percentage in 10% increments. 100% corresponds with Completely Destroyed. Use the pulldown list to select a percentage.

#### Description

This field is used to record a detailed

### Workflow

#### Precise Geographical Location

The [Location](https://docs.cw.crisisworks.com/concepts-and-fundamentals/on-a-computer/using-the-datagrid/editing-items#location) field is used to record map points, lines or polygons to outline the crop.

#### Tags

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

### Related

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

Links to parent [Cases](https://docs.cw.crisisworks.com/modules/recovery/cases) are listed here.

### Classification

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

#### Status

<table><thead><tr><th width="130">Status</th><th width="143">Datagrid Icon</th><th>Next available steps</th><th>Notes</th></tr></thead><tbody><tr><td>Damaged</td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FTqKs9HwRb16AjjEhzfDW%2Fimage.png?alt=media&#x26;token=91f7b645-d21e-4936-bec7-1ec888652a0e" alt="" data-size="line"></td><td>In Progress, Recovered</td><td>All new Agriculture items begin with this status</td></tr><tr><td>In Progress</td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FfgUZKsULpKCWOvLIAnXe%2Fimage.png?alt=media&#x26;token=56aa5574-c90e-4a65-9088-dccf832e50d5" alt="" data-size="line"></td><td>Damaged, Recovered</td><td>Remediation work is being undertaken</td></tr><tr><td>Recovered</td><td><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FL1OECRSX0Bv1ZZ25at7u%2Fimage.png?alt=media&#x26;token=e8a24b10-88b6-4853-bfa5-b686d89360a9" alt="" data-size="line"></td><td>In Progress, Damaged</td><td>The crop has been recovered</td></tr></tbody></table>

### 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 Agriculture

{% 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 Agriculture:

* Add notes on your edits in the **Record Notes** field
* Complete each section of the [Settings](#register-item-settings) as required
* Update the **Status** to reflect the current stage of recovery&#x20;
* Update the **Damage** levels and damaged value based on ongoing assessment
* Record additional **photos** of damage as required

<figure><img src="https://3923904090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNy7IznbrPLUq6GJDDQDk%2Fuploads%2FESgF3A2NRWTBfkxqSeXL%2Fimage.png?alt=media&#x26;token=4ee2e63c-3e7d-4eae-a391-941c7116057a" alt="" width="375"><figcaption><p>General section in Edit mode</p></figcaption></figure>

## Adding Agriculture

Refer to: [Cases - Affected Agriculture](https://docs.cw.crisisworks.com/modules/cases#recovery-people-and-property-enterdetailsonanyimpactedagriculture).\
Agriculture can only be added through their parent register - Cases.\
To add another Agriculture record to a Case (for example a different crop) when viewing an Agriculture item, follow the relevant Related Link to the Case, edit the Case. Make sure it hasn't already been added and add it from the Affected Agriculture section.

## 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 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>Exports to the Recovery Agriculture Report </p> |
| Bulk Edit        | <p>Refer to: <a href="../../../concepts-and-fundamentals/on-a-computer/using-the-datagrid/bulk-actions#bulk-edit">Bulk Edit</a><br>Change the Status and record notes</p>                        |

## Reports

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

The Recovery Agriculture Report is the main report for Agriculture. The report includes a number of parameters for extracting relevant data and supports the Export to Report bulk action from the datagrid.