# Logging Known Issues

The issue tracker allows logging known issues related to a Partner, CP Output, or Site/Location. These issues will then appear in the Data Collection plan during field monitoring activities involving any of the above categories.

![A filterable list of issues](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQDavrve7MsI3kN%2Fissues_overall.png?generation=1587653018391617\&alt=media)

For each issue shown, the default is a compact list. Clicking the down arrow shows who has raised the issue, who last modified it, and when. If an issue were closed, the user would see who closed it and when:

![](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQFAFT510bf_cw4%2Fissues_overall_details_red.png?generation=1587653020021186\&alt=media)

Issues also can contain associated files that may be downloaded by the user. To get access to attached files, click the corresponding field in the Attachment(s) column:

![](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQH6Up9M5P1gjoD%2Fissues_overall_files_red.png?generation=1587653019988882\&alt=media)

In the appeared window, click the **Download button**:

![Downloading the attached file](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQJkZjKFRfFkWfD%2Fissues_overall_download_red.png?generation=1587653019947568\&alt=media)

## Issues Filtering

The issue tracker allows filtering available issues by CP Output, Partner, and Location/Site. Users can apply as many filters as needed selecting them from the drop-down list. The search field helps to find a required filter by its name:

![Applying filters](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQL_J0MyvMcSCkE%2Fissues_overall_apply_filers_red.png?generation=1587653019026503\&alt=media)

Users can also filter by New Issues. The new issue is defined as being active and currently relevant. An issue ceases to be new after its status has been changed to Past by a user. Only the New issues will be visible in the activities:

![Filtering results](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQNgYmRx1jD7sLb%2Fissues_overall_filtering_red.png?generation=1587653020840830\&alt=media)

## Adding a New Issue

To add a new issue, click the "+" button:

![Adding a new issue](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQPVth9RvJs6aOy%2Fissues_overall_add_red.png?generation=1587653020662740\&alt=media)

The following form will appear on the screen:

![Issue editing form](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQRRBg0Kc-ACCgf%2Fissues_overall_add_form%20\(1\).png?generation=1587653018956257\&alt=media)

It allows creating issues related to a particular CP Output, Partner, or Location/Site. According to the chosen option, users can select Partner name from the list of all Partners, CP Output from list of all CP Outputs, or Site from a list of all Sites using a drop-down list:

![Selecting Location/Site for a new issue](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQTxUTAwVV_N2aH%2Fissues_overall_add_form_2_red.png?generation=1587653019900842\&alt=media)

The Status of the newly created Issue can be set as New or Past:

![Issue status](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQVGhpHCTYIlVOq%2Fissues_overall_add_form_new_past_red.png?generation=1587653019946779\&alt=media)

The Issue field allows adding a short description of the issue:

![Issue description](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQXFYttj1Xcyuf2%2Fissues_overall_add_form_new_lorem_red.png?generation=1587653020119014\&alt=media)

If required, users can attach documents to the new issues. To do this, click the **Upload File** button and choose the file you want to attach. Users can add as many files as needed:

![Attaching files to the new issue ](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQZ_AgI1TCCnojq%2Fissues_overall_add_form_attach_file_red.png?generation=1587653020385687\&alt=media)

To add a new issue, click the **Add button**.

## Issues Editing

To edit one of the available issues, click the **Edit button**:

![Editing the issue](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQaxQNMu2_8AGHg%2Fissues_overall_add_form_edit_red.png?generation=1587653018608222\&alt=media)

The editing form is identical to the one described in the [Adding a New Issue](#adding-a-new-issue) chapter of this documentation:

![](https://245990476-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXtssvPDq8TYbsiKTaP%2F-M5bUO5Fa033kc-Uco99%2F-M5bUUQcxn7JOcgXsceU%2Fissues_overall_add_form_edit_2.png?generation=1587653020994362\&alt=media)

