# Configure Risk of Bias Settings

To configure the settings for Risk of Bias, go to the project and navigate to Settings > Risk of Bias. The Settings page appears. The Setting Preferences section is a drop-down that allows you to handle the permissions for the selection category and provides the following options: Allow Judicators to add selection category in Risk

Source: https://picoportal.org/docs/configure-risk-of-bias-settings/

To configure the settings for Risk of Bias, go to the project and navigate to <b>Settings \> Risk of Bias</b>. The <b>Settings </b>page appears.

The <b>Setting Preferences </b>section is a drop-down that allows you to handle the permissions for the selection category and provides the following options:

<b>Allow Judicators to add selection category in Risk of Bias:</b> Select this option if you want to allow the Judicator to add new selection categories while performing the Risk of Bias assessments.\
<b>Allow Reviewers to add selection category in Risk of Bias:</b> Select this option if you want to allow the Reviewer to add new selection categories while performing the Risk of Bias assessments.

Additionally, to <strong>C</strong><b>onfigure the Risk of Bias Workflow</b>, navigate to <b>Settings \> Setup</b> and scroll to <b>Risk of Bias Workflow</b> on the right:

<b>Single Review:</b> Each record will only need to be assessed by a single Reviewer and once marked complete by that assessor, will be finalized.\
<b>Single Review + Quality Check:</b> Each record will need to be assessed by a single Reviewer and once marked complete by that assessor, will move to Pending status. A second Reviewer must review the assessment to complete the record.\
<b>Dual Independent Review: </b>Each record will need to be assessed by two Reviewers. After both mark it complete, it will move to pending status. A Judicator is required to resolve discrepancies in the assessment before the record can be marked complete.

## <b>PICO Portal Templates</b>

You can download several <b>Risk of Bias Templates</b> for use in Excel by navigating to <b>Settings \> Risk of Bias</b>, clicking on the drop-down menu for <b>Setting Preferences </b>and scrolling down.

You can then upload the completed template to PICO Portal by clicking on the <b>Upload Category</b> button and selecting the Excel document that you want to upload. Alternatively, you can drag and drop the file in the Upload Category box. Click on the <b>Upload </b>button.

You can <b>manually</b><strong> add</strong> Categories, in general or to an already uploaded template, by typing them into the Category field. You can add multiple categories by separating them with a comma. Click on <b>Add</b> to save the new categories.

By default, PICO Portal will activate all categories and assign a display order of “1” until modified. Click the <b>Edit </b>icon under <b>Actions </b>to change the display order, add a description, etc. After you make the modifications, click the <b>Save</b> button to save your changes.

### <strong>Question Types</strong>

<b>Single Select:</b> Only one selection can be made when answering the question, i.e. “Yes” or “No”\
<b>Multi Select: </b>Multiple selections can be made when answering the question, i.e. “Who provided funding for the study? Select all that apply. A) Government, B) Pharmaceutical Industry, C) Other Industry, D) No Funding (Explicit), E) Not Reported”\
<b>Notes:</b> This is a free-text question where the answers can be copied and pasted verbatim from the article, or summarized. It is similar to having notes enabled on the Single and Multi Select questions where you may want to add additional information, but does not involve any selection criteria.\
<b>Instructions: </b>This is not a “question” to be answered by assessors. This question type is descriptor text, most commonly used to present details on how to complete the form. It can also be used to denote a “section” of the form, i.e. used to label a heading/domain.

## <b>Add New Domain</b>

You can add multiple <b>Domains</b> by clicking on the <b>+ </b>icon in the domain section. A domain is an entirely new set of questions and a Reviewer only has to extract one domain per record. This is most useful in situations where multiple different Risk of Bias tools may be relevant to a project (e.g., if multiple study types are included). Add the name of the new domain and click <b>Save</b>. 

Upload the template by clicking on the <b>Upload Category</b> button and selecting the Excel document that you want to upload. Alternatively, you can drag and drop the file in the Upload Category box. Click on the <b>Upload </b>button.

These can be configured in the same ways as described previously.

## <b>Configuring Notes and Mandatory Questions</b>

You can also configure the categories to have a free-text Notes field enabled or not, or to make certain questions mandatory. Free-text Notes adds a note field for clarifying details and additional information (e.g., providing justification for a Risk of Bias judgement). 

To configure free-text notes and mandatory questions, click on the <b>Edit </b>icon under <b>Actions </b>on the category and scroll down to <b>More Settings</b>. You can toggle “Is Required” ON and OFF for both the category and notes. If you want the category/question and notes to be enabled, <strong>but </strong><b>skippable</b>, toggle the <b>Enable</b> switch to ON. After you make the modifications, click the <b>Save</b> button to save your changes.

## <b>Adding Sets and Tabs</b>

A Set is a collection of tabs and questions that is different from a Domain: Sets are collections of questions that repeat, nested within a domain. Sets are primarily used to capture reported variations of different outcomes.

Click on <b>Add a Set </b>to create a new set. Add a short name (e.g. Results) and a long name (e.g. Study results and outcomes) for the new set, and set the display order for where it will appear in the template. The set will appear as a drop-down in the categories list and questions can be added directly to it. Existing questions can also be moved into sets. 

To use a set of questions, you must add at least one <b>Tab</b>. Tabs are the sets of repeating questions included in the set, for example used to capture the same items for various outcomes or other relevant data, e.g. “Outcome 1”, “Outcome 2”. To add Tabs, type them into the Tab field. You can add multiple tabs by separating them with a comma. Click on <b>Add</b> to save the new tabs.

To add the category/question data to the set, scroll down to <b>Add Questions</b>. Type in the question. You can add multiple questions by separating them with a comma. Click on <b>Add</b> to save the new questions. To configure the questions, find the Set in the display order of categories and click on it to open the drop-down. Click on <b>Modify</b> beside the question and select the Question <b>Type</b>, and then click <b>Save</b>.

For example, the set is titled “Results”. The Tabs for the set are “Outcome 1” and “Outcome 2”. Two questions within the set (across tabs) have been created:

1\) “Outcome definition” as Question Type “Notes”, so that the primary and secondary outcome results can be copied verbatim from the text.\
2\) “Time point” as Question Type “Multiple Select”, so that the relevant time periods for which data are presented can be selected.

Sets of questions can be <b>deleted </b>by clicking the <b>X</b> icon under <b>Actions</b>. This will delete all questions in the set.

## <b>Enabling AI Query</b>

All Risk of Bias question types, other than Instructions, can have AI assist activated for both Categories and Sets. In the <strong>Edit Question Information</strong> window, select <strong>Enable AI Query</strong> to activate. You may need to click on the Refresh icon for PICO Portal to generate an AI prompt based on the information that is included in the “Description (Long Name)”. You can edit the prompt yourself, if you would like to make modifications.

Once you have enabled AskAI on all questions and checked the prompts, you will need to contact Support in order to have the system run the AI queries on your included articles. You can contact Support by clicking <strong>Contact Us</strong> in the top right corner of your project dashboard. Please include your project number so that we are better able to assist you.

## <b>Preview</b>

When you upload a completed Risk of Bias template, you can preview how it will look to Reviewers and Judicators when they are performing Risk of Bias on the right side of the screen. Any time you make changes or add new categories, click on the <b>Refresh</b> icon to the right of <b>Preview</b> to update the preview of the form.