Nested Knowledge

Bringing Systematic Review to Life

User Tools

Site Tools

Trace:
wiki:autolit:admin:import

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:import [2023/10/11 12:23]
jthurnham [Import Tags] 		wiki:autolit:admin:import [2024/04/01 12:57] (current)
jthurnham
Line 1: Line 1:
 ====== Import Existing Screening Decisions or Tags ====== ====== Import Existing Screening Decisions or Tags ======
  
-This page addresses how to move existing review data, specifically screening & tagging, from spreadsheets into your nest.+This page addresses how to move existing review data, specifically screening & tagging, from spreadsheets into your nest. For video instructions, see T=2:37 in this video: 
 + 
 +{{youtube>RbIKMex7yPE}}
  
 ===== Where to Import ===== ===== Where to Import =====
Line 7: Line 9:
 Import can be found under [[:wiki:autolit:admin:configure|Settings]]. Import can be found under [[:wiki:autolit:admin:configure|Settings]].
  
-{{:wiki:autolit:admin:img23_2.png?nolink&  }}+{{ :undefined:screenshot_2024-04-01_at_13.09.03.png?nolink |}}
  
   * For **Screening**, see the "Import" section under Screening - select **"Begin"**  under "Upload Data"   * For **Screening**, see the "Import" section under Screening - select **"Begin"**  under "Upload Data"
Line 24: Line 26:
 ==== Format and Template ==== ==== Format and Template ====
  
-You can download the template from the Import Modal (see first red outline below):+You can download the template from the Import Modal:
  
-{{ :undefined:screenshot_2023-10-11_at_13.17.14.png?nolink |}}+{{ :undefined:screenshot_2024-04-01_at_13.10.15.png?nolink |}}
  
 The titles of your sheet must have the following **exact column names**: The titles of your sheet must have the following **exact column names**:
Line 34: Line 36:
   * PubMed Id   * PubMed Id
   * Ref Id (if applicable)   * Ref Id (if applicable)
 +  * External Id
   * Exclusion Reason   * Exclusion Reason
   * [Optional] Full Text Review   * [Optional] Full Text Review
Line 49: Line 52:
  
 In this sheet, the third record would be Included (with full text review) while the other three would have Exclusion Reasons added matching the text in that column. In this sheet, the third record would be Included (with full text review) while the other three would have Exclusion Reasons added matching the text in that column.
- 
  
 ==== Settings: Allow Exclusion Reason Creation ==== ==== Settings: Allow Exclusion Reason Creation ====
Line 79: Line 81:
 To import Tags, you will need to bring an Excel sheet or CSV formatted **exactly**  as outlined below; you can use our template to ensure the formatting is correct. To import Tags, you will need to bring an Excel sheet or CSV formatted **exactly**  as outlined below; you can use our template to ensure the formatting is correct.
  
-Once you have selected "Begin," a modal will open showing the ability to download the template, upload an Excel or CSV, and adjust settings:+Once you have selected "Begin," a modal will open showing the ability to download the template, upload an Excel or CSV, and adjust settings. In the modal, you have the ability to import tags with accompanying text contents and tags with table contents but note these imports are separate. 
  
-==== Format and Template ====+==== Tags with Text Contents ====
  
-You can download the template from the Import Modal (see first red outline below): +By default, importing tags with text contents is selected and tags with table contents can always be imported here or configured later on in your hierarchy. Imports must follow the correct format, you can download the template from the Import Modal:
  
-{{ :undefined:screenshot_2023-10-11_at_13.20.08.png?nolink |}}+{{ :undefined:screenshot_2024-04-01_at_13.41.53.png?nolink |}}
  
-The titles of your sheet must have the following **exact column names**:+The titles of your sheet must have 1-5 of the following **exact column names**:
  
   * DOI   * DOI
Line 93: Line 95:
   * PubMed Id   * PubMed Id
   * Ref Id (if applicable)   * Ref Id (if applicable)
 +  * External Id
  
 Then, every column to the right of these **must be an exact Tag name**; the cells under the Tag Name will indicate whether that Tag should be added to the record in question with the text in the cell as the Tag Excerpt. Then, every column to the right of these **must be an exact Tag name**; the cells under the Tag Name will indicate whether that Tag should be added to the record in question with the text in the cell as the Tag Excerpt.
Line 98: Line 101:
 You must provide, in those columns: You must provide, in those columns:
  
-  * At least one bibliographic item: DOI, Title, PubMed Id and, if applicable, Ref Id +  * At least one bibliographic item: DOI, Title, PubMed Id and, if applicable, Ref Id
   * For all Tags to be applied to any record, the exact Tag name in the column header,   * For all Tags to be applied to any record, the exact Tag name in the column header,
   * For all records a Tag should be applied to, **fill in your desired Text Content**  in the cell. If the cell is left blank, **this indicates that the Tag in question should NOT be added to that record.**   * For all records a Tag should be applied to, **fill in your desired Text Content**  in the cell. If the cell is left blank, **this indicates that the Tag in question should NOT be added to that record.**
Line 107: Line 110:
  
 In this sheet, the first two records would have only one of the tags listed added to them; the last two records would have both tags added: "Study Type" and "Intervention." The text added to each tag is found in the corresponding cell for each record. In this sheet, the first two records would have only one of the tags listed added to them; the last two records would have both tags added: "Study Type" and "Intervention." The text added to each tag is found in the corresponding cell for each record.
- 
  
 ==== Settings: Allow Tag Creation ==== ==== Settings: Allow Tag Creation ====
  
-The first setting (second red outline above) determines whether the nest should automatically create new Tags based on the imported sheet.+The first setting determines whether the nest should automatically create new Tags based on the imported sheet.
  
 <WRAP center round tip 80%> If there is a Tag listed in the sheet that is **not already configured in the nest,**  leaving this setting toggled "on" will automatically create any missing Tags. <WRAP center round tip 80%> If there is a Tag listed in the sheet that is **not already configured in the nest,**  leaving this setting toggled "on" will automatically create any missing Tags.
  
-These Tags will be added to your nest without Parent Tags, so make sure you check Configure Extraction and assign the appropriate Parent Tags after Import. </WRAP>+These Tags will be added to your nest without Parent Tags, so make sure you check Configure Tagging and assign the appropriate Parent Tags after Import. </WRAP>
  
 If you would prefer that **no new Tags be created**  in your nest, toggle this setting off. If you would prefer that **no new Tags be created**  in your nest, toggle this setting off.
Line 123: Line 125:
 ==== Settings: Allow overwrite ==== ==== Settings: Allow overwrite ====
  
-The second setting (third red outline above) determines whether the tag excerpts in your import should override tag excerpts already present in the nest. That is, if you want any existing tag excerpts to be **replaced by the imported excerpts,**  leave this setting toggled "on."+The second setting determines whether the tag excerpts in your import should override tag excerpts already present in the nest. That is, if you want any existing tag excerpts to be **replaced by the imported excerpts,**  leave this setting toggled "on."
  
 If you would prefer that **existing tags be left (and not overwritten)**, toggle this setting off. If toggled off, no overwriting will be completed over existing tags. If you would prefer that **existing tags be left (and not overwritten)**, toggle this setting off. If toggled off, no overwriting will be completed over existing tags.
Line 129: Line 131:
 <WRAP center round important 80%> Be careful about this action, because no report will be returned regarding overwriting of records! </WRAP> <WRAP center round important 80%> Be careful about this action, because no report will be returned regarding overwriting of records! </WRAP>
  
-==== Import Tags ====+==== Import Tags with Text Contents ====
  
 Once you have **ensured that your import sheet is the proper format**, upload your sheet by drag-and-drop or by selecting the Upload button. Once you have **ensured that your import sheet is the proper format**, upload your sheet by drag-and-drop or by selecting the Upload button.
Line 135: Line 137:
 When complete, check your nest for the new Tags you uploaded and to ensure that they were altered as you had planned. When complete, check your nest for the new Tags you uploaded and to ensure that they were altered as you had planned.
  
 +==== Tags with Table Contents ====
 +
 +For import of tags with accompanying tables, toggle "Import Table Contents." This time, each sheet within your workbook should correspond (case-sensitive) to a tag in your nest you'd like to import a table for. Imports must follow the correct format, you can download the template from the Import Modal:
 +
 +{{ :undefined:screenshot_2024-04-01_at_13.44.29.png?nolink |}}
 +
 +The titles of your sheet must have 1-5 of the following **exact column names**:
 +
 +  * DOI
 +  * Title
 +  * PubMed Id
 +  * Ref Id (if applicable)
 +  * External Id
 +
 +Then, each remaining column must match exactly (case-sensitive) the columns configured in the pre-existing tag table. You can also have tags and columns created for your tag table by selecting "Allow Tag & Column Creation."
 +
 +==== Settings: Allow Tag Creation ====
 +
 +The first setting determines whether the nest should automatically create new Tags based on the imported sheet.
 +
 +<WRAP center round tip 80%> When this is toggled on, new tags and corresponding tables will be created if they do not exist or they cannot be matched to existing tags in the nest.
 +
 +These Tag tables will be added to your nest without Parent Tags, so make sure you check the Configure Tagging page and assign the appropriate Parent Tags after Import. </WRAP>
 +
 +If you would prefer that **no new Tag Tables be created**  in your nest, toggle this setting off.
 +
 +<WRAP center round important 80%> If there are tag tables/sheets in your workbook that do not **exactly match**  existing tags in the nest, the import of records with those non-matching Tags will fail import and a list of records that failed Tag import will be displayed to you. </WRAP>
 +
 +==== Settings: Allow overwrite ====
 +
 +The second setting determines whether the tag tables in your import should override tag tables already present in the nest. So if you want any existing tag tables to be **replaced by the imported excerpts,**  leave this setting toggled "on."
 +
 +If you would prefer that **existing tag tables be left (and not overwritten)**, toggle this setting off. If toggled off, no overwriting will be completed over existing tags.
 +
 +<WRAP center round important 80%> Be careful about this action, because no report will be returned regarding overwriting of records! </WRAP>
  
wiki/autolit/admin/import.1697026982.txt.gz · Last modified: 2023/10/11 12:23 by jthurnham

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