# Reviews

In MLM-AI, product searches are defined in a [**Monitor**](https://docs.biologit.com/configuration/monitor-configuration), and **Reviews** are their results for a date period. Reviews contain the search hits for users to analyse and screen. 

Click on the **Reviews menu** to see a summary list of reviews in progress and recently completed. This screen allows users to rank and select the next review to work on.

Clicking on the link of any Review will lead to the [Details page](https://docs.biologit.com/application/review-details) where users can select articles for screening.

Reviews are categorized in tabs:

1\.  **In Progress** - Reviews where articles are pending screening

2\.  **Completed** - Reviews where 100% of articles have been screened, or that have been set to Completed by the review owner

3\.  **Processing** - Reviews scheduled by the system, or actively being processing

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FlOLy8fwzdyeuFqputNzn%2Fimage.png?alt=media&#x26;token=b7e32fc2-1d94-4406-81e7-5c595195f834" alt=""><figcaption></figcaption></figure>

Within a tab, it is possible to filter reviews using keywords and sort by a number of criteria.&#x20;

It is also possible to select other columns. The example below filters Reviews for "methotrexate":&#x20;

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FXmvsP0tZfRSYkgVPAweI%2Fimage.png?alt=media&#x26;token=03726e27-dca8-4e9a-aa4e-33a08d7c0f20" alt=""><figcaption></figcaption></figure>

Adding terms to the search box matches the Monitor title field. The search box also accepts more specific queries using a mini-language. Examples:

| Example                         | Description                                                                       |
| ------------------------------- | --------------------------------------------------------------------------------- |
| `monitor:paracetamol start:jun` | Matches all results with "paracetamol" in monitor title and start date of June    |
| `rundate:july 2021`             | Matches all results with run date of July 2021                                    |
| `start:jun 2021 end:sep 2021`   | Matches all results with results start date between June 2021 and September 2021. |

## The Review Lifecycle

The tabbed view in the Review summary page groups reviews by completion. Reviews can have one of the following status:

* The **In Progress** tab are all reviews where screening decisions need to be finalized. A review stays in progress until 100% of articles receive a screening decision (unless the status is manually changed by the user)
* The **Completed** tab contains reviews where 100% of screening has been done
* Reviews may be **Archived** by users with [Review supervisor privilege](https://docs.biologit.com/configuration/team-and-user-management#permissions). Archiving a review no longer lists it in any tab removing clutter from already completed work, but the review may still be retrieved via Find Reviews (see below)
* Finally, when reviews are uploaded in error a user with [Review Supervisor privileges](https://docs.biologit.com/configuration/team-and-user-management#permissions) can set its status to **Retired**. Once set to Retired, reviews are no longer visible, and are not accounted for in reports or any other processing such as duplicate detection&#x20;

{% hint style="info" %}
If a screening decision sets any citation to a "Pending" status in Completed review, the Review moves back to "In Progress" as it now awaits review completion. This can happen on workflows where, for example, an article requires additional work after QC.&#x20;
{% endhint %}

### Changing Review Status

Users with Review Supervisor privileges can modify the status of reviews from the summary page.

* Select one or more reviews using the checkbox
* Select the "**...**" menu on top right
* Choose the target status for the selected reviews (see above discussion on each status)

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FRHqMrPI7mQwjFRBizCby%2Fimage.png?alt=media&#x26;token=d4db08c3-2214-4f16-88a3-aed67434b0e7" alt=""><figcaption><p>Supervisors can change the status of a Review</p></figcaption></figure>

## Finding Reviews

For more comprehensive Review searches you can use the **Find Reviews** functionality from the Finder Icon:

![](https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2Fd2fXfiLj7LX1KgEZH9lY%2Fimage.png?alt=media\&token=b26b6ce9-770b-45b9-8218-ac71aa0b89a0)

&#x20;Use Find Reviews to search by:

* A specific monitor
* By status: In Progress, Completed, Archived, etc.
* By assigned teams
* By target start and end dates

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FFAxP5ACaB8ZFsEaLKBVm%2Fimage.png?alt=media&#x26;token=2e6935ca-9f7a-4adb-b059-c964b1a8e4b1" alt=""><figcaption></figcaption></figure>

### The Processing Tab

The Processing tab shows the reviews processing or scheduled, for example:

* manually submitted reviews still being processed (see On Demand reviews below)&#x20;
* or *scheduled* by the system.&#x20;

If, for example, you have active scheduled monitors that run weekly, you will see results for the following week in progress and their respective ETA.

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FzCk1oz3YdIRS6nKUy8eI%2Fimage.png?alt=media&#x26;token=8fe5d53e-296d-4aa9-a444-afaf9d4bf80a" alt=""><figcaption></figcaption></figure>

## Submitting Reviews On Demand

Privileged users can request on-demand Reviews for any active monitor:&#x20;

* Click the **Add Review** button to configure your submission
* Select **On Demand**
* Select desired monitor, start and end dates for the review

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FQOI18xvE9FOzLij3xMuQ%2Fimage.png?alt=media&#x26;token=655131bc-29fe-40dc-af9d-b362fe5570e7" alt=""><figcaption></figcaption></figure>

* Click the "Verify" button to check the submission options. This will perform a validation check on the dates selected, and overall size of the review (See [System Limits](https://docs.biologit.com/more-help/faq#system-limits))
* If verification passes, the "Submit" button will become enabled, and the review is ready for submission:

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2F8ms9jruah9iHZaDREzrm%2Fimage.png?alt=media&#x26;token=40d8a572-b503-40fa-a1e2-fb1d597e195b" alt=""><figcaption></figcaption></figure>

* Once submitted, the review will be queued for processing and progress can be monitored in the [Processing tab](#the-review-lifecycle).

{% hint style="info" %}
Reviews can also be created from an external data source (ex: Embase, Dialog, ADIS). See [**Uploading Review Data**](https://docs.biologit.com/application/upload-data).
{% endhint %}

## Batch Submissions

It is also possible to submit on-demand reviews in batch simplifying the process when many monitors require reviews.

* Use the "**Batch"** tab from "Add Reviews"
* Select monitor and date range
* Add or Copy the request to create a second submission
* Repeat the process for as many monitors as required

When ready users can verify and submit all monitors in a single request

<figure><img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6pIe8UPxEvsbrxTVXkGi%2Fuploads%2FElUOO2t8wn5jxefQWHcK%2Fimage.png?alt=media&#x26;token=d6f22173-ec6e-40ff-b00a-fc706ad5bb79" alt=""><figcaption></figcaption></figure>

## Exporting Reviews

Reviews can be downloaded to your local computer as spreadsheets or HTML. From the Summary page:

* Select reviews you wish to download by checking the checkbox beside the review title
* Go to **Actions** and move the mouse to the download icon <img src="https://1171269993-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MWAcqCJbPL5YYXAvC98%2F-MWAth1X9Omgk8-FAJhm%2F-MWAug3MuvQi9XMTXF21%2Fdownload_icon.png?alt=media&#x26;token=badfcae6-d93d-4e73-9e04-a66854d381cc" alt="" data-size="line"> &#x20;
* Select the file format to download from the options available

{% hint style="info" %}
Reviews can also be exported from the [Review Detail](https://docs.biologit.com/application/review-details) page; individual articles can also be exported from the [Article Detail](https://docs.biologit.com/application/article-screening) page.
{% endhint %}

{% hint style="info" %}
In addition to exporting reviews, users can run more comprehensive reports across multiple monitors and date periods from the [**Reports**](https://docs.biologit.com/application/reports) module.
{% endhint %}