Nested Knowledge

Bringing Systematic Review to Life

User Tools

Site Tools

Trace:
wiki:autolit:admin:allocation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
wiki:autolit:admin:allocation [2023/05/26 20:55]
kevinkallmes [Dual, Two-Pass Allocation Procedure] 		wiki:autolit:admin:allocation [2024/02/10 03:36] (current)
kevinkallmes
Line 1: Line 1:
 ====== Allocation ====== ====== Allocation ======
  
-Allocation allows you (an admin) to assign modules to specific users for sets of records. By default, the feature is off.+{{youtube>_ucsc_wDbjQ}}
  
 ===== Navigate to Settings ===== ===== Navigate to Settings =====
Line 7: Line 7:
 Admins can go to the Nest Settings, scroll down to Allocation and click the toggle bar on. Admins can go to the Nest Settings, scroll down to Allocation and click the toggle bar on.
  
-{{ :undefined:allocation.png?nolink |}}+{{  :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. +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 |}} +{{  :undefined:allocationmenu.png?nolink&  }}
- +
-Note: progress bars shown for each module in the menu bar reflect the overarching progress in the nest and not the progress of each individual users' allocated modules, therefore the bars won't immediately change when allocation is turned on.+
  
 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. 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.
Line 19: Line 17:
 ===== Instructions on How to Allocate Records ===== ===== 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.+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|Screening]], [[wiki:autolit:tagging|Tagging]], [[wiki:autolit:extraction|Extraction]] and [[wiki:autolit:risk_of_bias|Critical Appraisal.]]+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 ==== ==== 1. Navigate to Allocation Admin Page ====
Line 31: Line 29:
 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. 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 |}}+{{  :undefined:alscreen.png?nolink&  }}
  
 ==== 3. Filter to Records to Assign ==== ==== 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|Study Inspector.]] This is not necessary if you want to assign all records to one user, you can move straight to the next step.+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.
  
-{{ :undefined:alscreen2.png?nolink |}}+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. 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.
Line 45: Line 45:
 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. 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 |}}+{{  :undefined:alscreen3.png?nolink&  }}
  
 === Venn Diagram Explained === === 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. +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 |}}+{{  :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. 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 |}}+{{  :undefined:alscreen5.png?nolink&  }}
  
 === Deallocate Records === === 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. +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.** **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 === === 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. 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 ==== ==== Allocation Module Status ====
  
 As you allocate records in each module, the allocation module status can be viewed in the dropdown: As you allocate records in each module, the allocation module status can be viewed in the dropdown:
  
-{{ :undefined:allstatus.png?nolink |}}+{{  :undefined:allocationmodule.png?nolink&  }}
  
   * No circle = 0 records have been allocated   * No circle = 0 records have been allocated
Line 81: Line 79:
 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. 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 |}}+{{  :undefined:progress.png?nolink&  }}
  
 ===== Allocation in Dual Modes ===== ===== Allocation in Dual Modes =====
Line 87: Line 85:
 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). 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:dual.png?nolink |}}+{{  :undefined:allocation1.png?nolink&  }}
  
 It can get a little tricky so be sure to be intentional about allocating users to different steps. It can get a little tricky so be sure to be intentional about allocating users to different steps.
  
-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 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 ==== ==== Dual, Two-Pass Allocation Procedure ====
  
-If your nest is configured for Dual, Two-pass Screening, the procedure for Allocation is:+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
  
-  * **Allocate Abstract reviewer-level screening** (description), THEN DO REVIEWER-level screens BEFORE Allocating Adjudication 
-  * **Allocate Adjudication of Abstract Screening** 
 ==== Switching between modes ==== ==== Switching between modes ====
  
-When you switch between Screening modes, all Allocation will be removed. This means that, when you switch Screening 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 ===== ===== Exporting Allocation =====
  
-In [[wiki:autolit:utilities:inspector|Study 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.+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. 
  
wiki/autolit/admin/allocation.1685134524.txt.gz · Last modified: 2023/05/26 20:55 by kevinkallmes

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki