Nested Knowledge

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Allocation ======

{{youtube>_ucsc_wDbjQ}}

===== Navigate to Settings =====

Admins can go to the Nest Settings, scroll down to Allocation and click the toggle bar on.

{{  :undefined:allocation.png?nolink&  }}

Turning on Allocation will reveal an Allocation page under the Nest Home menu bar where you may allocate records on various criteria.

{{  :undefined:allocationmenu.png?nolink&  }}

If you turn on Allocation, you must assign all modules or none, at the moment there is no mix and match of allocated and unallocated modules. As an admin you can assign all user types including yourself and each assigned user will only be able to view records allocated to them (regardless of whether they are an admin). Records unallocated for a particular module will not be presented to any user in that module and must be allocated first.

===== Instructions on How to Allocate Records =====

In order to allocate records, records must be present in the nest. So first ensure you add a [[:wiki:autolit:search|Literature Search]] to pull in records to be screened.

You can allocate records for the following modules: [[:wiki:autolit:screening|]], [[:wiki:autolit:tagging|]], [[:wiki:autolit:meta_analytical_extraction:extract|Extraction]] and [[:wiki:autolit:critical_appraisal|Critical Appraisal.]]

==== 1. Navigate to Allocation Admin Page ====

This page can be accessed under the Nest Home menu bar or by clicking on any module that has unassigned records will direct you to "Allocation Admin."

==== 2. Select Allocation module ====

In the top right dropdown, you can select the module you want to allocate records in. If you have just added a search, you will only be able to add screening allocation at this time since no records have been advanced beyond screening.

{{  :undefined:alscreen.png?nolink&  }}

==== 3. Filter to Records to Assign ====

Add a filter to only assign a specific set of records to a user. These are the same filters that are available to use in [[:wiki:autolit:utilities:inspector:filters|Study Inspector.]] For instance, you can filter by a range of [[:wiki:autolit:search:refids|Ref IDs]] and assign the resulting records to a single user.

This is not necessary if you want to assign all records to one user, you can move straight to the next step.

{{  :undefined:alscreen2.png?nolink&  }}

Note: some filters are automatically added, displayed in grey, and cannot be removed for different allocation modules. This is because they are a necessary filter for studies in that module. For example, only records that have been included in Screening will be displayed in the Tagging allocation module, so a "Final Screening Status: Included" will be displayed.

==== 4. Allocate Records to User(s) ====

Below, select the user you would like to allocate these records and hit Confirm. Allocated users are not notified in anyway, but only allocated records are displayed to them when they open the nest. In the below example, 4 filtered records out of 37 are being allocated. The **A** nest to a users name means they are an admin of the nest.

{{  :undefined:alscreen3.png?nolink&  }}

=== Venn Diagram Explained ===

Once confirmed, the visual venn diagram will display names of users who have been allocated records with exact numbers when you hover over each venn, as well as unallocated records. It shows the overlap (if there is any) of assigned records between users. In this example, 4 records were allocated to Jeff Johnson, while 33 records remain unallocated.

{{  :undefined:alscreen4.png?nolink&  }}

Clicking on each venn will automatically add a filter to display a list of corresponding records below to allow ease of allocating records. For example, to quickly allocate the rest of the unallocated records, here we can click on the "Unallocated" venn and it will filter to the remaining 33 records.

{{  :undefined:alscreen5.png?nolink&  }}

=== Deallocate Records ===

In addition to allocating records, you can deallocate records from users. To do so, filter to the module and records of choice, click the "Allocate" dropdown, select "Deallocate," select the user and click Confirm.

**Note: Deallocating users from records does not remove their work performed/decisions that were made prior to deallocation.**
=== Allocating the Same Records to Multiple Users in Single Modes ===

In the case you assign a record to multiple users but your nest is configured in single modes (i.e. Standard Screening, Standard Tagging, etc.), **this does not mean it will be reviewed twice.** It just means it will show up in each users' queue until one of them completes the work on the record, where it will be removed from the other users' queue.
==== Allocation Module Status ====

As you allocate records in each module, the allocation module status can be viewed in the dropdown:

{{  :undefined:allocationmodule.png?nolink&  }}

  * No circle = 0 records have been allocated
  * Empty circle = Some records have been allocated, some are currently unallocated
  * Full circle = Everything is allocated

=== Tracking User Progress ===

While nest menu progress bars display overall nest progress, individual users can view their progress in the Navigation bars within each module. In the below example, the top bar displays progress on all studies in nest, while the navigation numbers displays individual users' progress within the specific module of the nest.

{{  :undefined:progress.png?nolink&  }}

===== Allocation in Dual Modes =====

If your nest has dual modes configured for any of the modules, separate allocation is required for reviewer-level steps and adjudicator-level steps. In the example below, both Dual Two Pass Screening (allocation modules circled in red) and Dual Extraction are configured (allocation modules circled in blue).

{{  :undefined:allocation1.png?nolink&  }}

It can get a little tricky so be sure to be intentional about allocating users to different steps.

<WRAP center round important 80%> **Note:**  you cannot prematurely allocate users to steps when decisions affecting those steps haven't been made. For example, you cannot assign adjudication steps before reviewer-level work is complete. </WRAP>

==== Dual, Two-Pass Allocation Procedure ====

If your nest is configured for Dual, Two-pass Screening, the procedure for Allocation **in order**  is:

  * **Allocate Abstract (AB) reviewer-level Screening:**
  - Follow the steps above in the allocation module "Reviewer AB Screening"
  - Then AB Screening at the reviewer-level **must be done before**  allocating AB adjudication

  * **Allocate Adjudication of Abstract Screening:**
  - Follow the steps above in the allocation module "AB Screening Adjudication"
  - Then Abstract Adjudication **must be done before**  allocating Full Text (FT) Screening

  * **Allocate Full Text (FT) reviewer-level Screening:**
  - Follow the steps above in the allocation module "Reviewer FT Screening"
  - Then FT Screening at the reviewer-level **must be done before**  allocating FT adjudication

  * **Allocate Adjudication of Full Text Screening:**
  - Follow the steps above in the allocation module "FT Screening Adjudication"
  - Then FT Adjudication **must be done before**  allocating steps in the next module: Tagging

==== Switching between modes ====

When you switch between Screening modes, **all Allocation will be removed**. This means that, when you switch Screening modes, **you will need to re-allocate all studies in the queues for Screening steps**  (such as Abstract reviewer-level screening, Abstract adjudication, etc.). If you return to a previous Screening mode, the Allocation for that mode will be saved, but the most recent Allocation will not be available.

Allocation for any study that has proceeded to the Tagging stage or later will not be impacted by switching Screening modes.

===== Exporting Allocation =====

In [[:wiki:autolit:utilities:inspector|]], you can use the [[:wiki:autolit:utilities:inspector:filters#allocation|Allocation filters]] to view a list of records and users they were assigned to. To export this as a table, click the Download button in the top right corner.
Nested Knowledge

User Tools

Site Tools

Page Tools
