Skip to main content
  1. nid
  2. uuid
  3. vid
  4. langcode
  5. type
  6. revision_timestamp
  7. revision_uid
  8. revision_log
  9. status
  10. uid
  11. title
  12. created
  13. changed
  14. promote
  15. sticky
  16. default_langcode
  17. revision_default
  18. revision_translation_affected
  19. path
  20. rh_action
  21. rh_redirect
  22. rh_redirect_response
  23. rh_redirect_fallback_action
  24. menu_link
  25. body
  26. field_help_section
<drupal-media data-entity-type="media" data-entity-uuid="3c2a0109-a566-4f01-ac92-a1e7d2f9d674">&nbsp;</drupal-media><p>This tutorial provides instructions on how to upload water quality data using a spreadsheet in CSV format.&nbsp; These instructions assume:</p><ul><li>That you are an approved member of the project.&nbsp; See <a href="https://www.datashed.org/help/6674538"><strong>Joining a Projec</strong></a>t</li><li>The the project already exists on Datashed.&nbsp; See <a href="https://www.datashed.org/help/3478112"><strong>Creating a New Project</strong></a> if it does not exist.</li><li>That all of the sample points have been created.&nbsp; See <a href="https://www.datashed.org/help/3478116"><strong>Create a Sample Point</strong></a> if the sample points do not exist.</li><li>The data has been properly prepared.&nbsp; See <a href="https://www.datashed.org/help/6674540"><strong>Preparing Water Data for Upload.</strong></a></li></ul><p>1. Log in.&nbsp;</p><p>2. Find and select the Project that you wish to upload data. See <a href="https://www.datashed.org/help/6699869"><strong>Finding Projects</strong></a> page for guidance.&nbsp;</p><p>3. Click on the "Data" tab and a drop-down menu will appear.</p><p>4. Select "Upload CSV Data"</p><p>5.&nbsp; A new web page to Import Water Quality Data will appear.&nbsp; You must either click on the Browse button to find the csv data file to be uploaded or you can drag and drop the file from your folder into the Browse box.&nbsp; Once the file has uploaded and the title of the files appears, you can then click on the blue "Submit CSV" button.&nbsp;</p><p>6.&nbsp; A new Map CSV Data screen will appear to "map" the fields and there should be a message at the top of the screen that says "Your CSV file has successfully been uploaded. Please proceed with mapping your CSV data."</p><p>*Note:&nbsp; If you received the message&nbsp;"Your CSV file has successfully been uploaded. Please proceed with mapping your CSV data." <strong>BUT</strong> the Map CSV Data screen does not appear.&nbsp; Then some sort of error occurred which prevented Datashed from completing this process.&nbsp; At least a portion of the time this appears to be due to "empty headers".&nbsp; To fix this, open your csv file and delete several empty columns next to your last column of data and several empty rows beneath your last row of data.&nbsp; Be careful to not delete actual rows of data.&nbsp; Save the csv file and begin the import process again.&nbsp; If you continue to experience this problem contact Datashed support.</p><p>7.&nbsp; The purpose of the Map CSV screen is for the user to map (or match) the names of the various water quality data parameter types (ex: pH, alkalinity, iron, etc) contained within the columns of your spreadsheet (shown in the Top Row in Blue) with the field name used by Datashed (shown in the Bottom Row). Basically, you are telling Datashed which column of data is your Sample point, Date, pH, iron, etc. &nbsp; Before you begin to complete the mapping process, please check to make sure that Datashed has successfully imported all of the columns from your spreadsheet.&nbsp; It is much easier to check that the data is there than to try to fix it later.&nbsp; If it has not correctly imported all of the columns, use the web browser back arrows to go back and repeat the process.&nbsp;</p><p>8.&nbsp; Datashed is programmed to try to automatically map the data and will try to "guess" and auto-select the correct parameters based on key words.&nbsp; Carefully, look at your heading (Top Row) and then what Datashed selected in the bottom row.&nbsp; While the names may be slightly different, it is important that you make sure that Datashed has selected the correct field.&nbsp; It is pretty good, but it definitely makes mistakes. Pay extra attention to the difference between total and dissolved metals, method of flow vs flow.&nbsp; To move across the screen you will need to use your arrow keys or you can use the scroll bar at the bottom of the page; however, you often cannot see the scroll bar if you are importing more than a few rows of data.</p><p>While mapping the data types, you will also need to distinguish whether each particular column of data was measured in the field or the lab (Middle Row).&nbsp;&nbsp; Simply click either the Lab or Field box. &nbsp; Datashed will often auto-select this, but this is much more difficult for Datashed to do correctly and it tends to default to selecting Lab, so it is important to verify each box is correct.&nbsp; For some parameters such as pH and alkalinity you might have both a field and a lab measurement, so it is important to tell Datashed which is which.</p><p>9.&nbsp; Datashed will also automatically select the sample point (far left column), as long as they exactly match the sample point names stored in Datashed.&nbsp; Those highlighted in green were auto-selected. Anything highlighted in pink indicates there is a problem and will need corrected.&nbsp; It is a good practice to quickly look down the list to make sure Datashed made a correct match and is very quick if the sample set is not large.</p><p>10. Once the mapping is complete, click on the Submit button.&nbsp; Datashed is programmed to help identify potential errors. If Datashed detects any definitive errors, it will not allow you to proceed until you have fixed them.&nbsp; Datashed may also question your values, if they are "out of typical range".&nbsp; For some potential errors, Datashed will allow you to proceed, but you should check to make sure the values are correct before doing so. If the data upload is successful without errors, you should be taken back to the projects home page (ie project details page) and you should see a message at the top of the screen that says "Your CSV data has been saved successfully! Thank you for your data submission!"&nbsp;</p><p>&nbsp;</p>
Submitted by cdenholm on

This tutorial provides instructions on how to upload water quality data using a spreadsheet in CSV format.  These instructions assume:

1. Log in. 

2. Find and select the Project that you wish to upload data. See Finding Projects page for guidance. 

3. Click on the "Data" tab and a drop-down menu will appear.

4. Select "Upload CSV Data"

5.  A new web page to Import Water Quality Data will appear.  You must either click on the Browse button to find the csv data file to be uploaded or you can drag and drop the file from your folder into the Browse box.  Once the file has uploaded and the title of the files appears, you can then click on the blue "Submit CSV" button. 

6.  A new Map CSV Data screen will appear to "map" the fields and there should be a message at the top of the screen that says "Your CSV file has successfully been uploaded. Please proceed with mapping your CSV data."

*Note:  If you received the message "Your CSV file has successfully been uploaded. Please proceed with mapping your CSV data." BUT the Map CSV Data screen does not appear.  Then some sort of error occurred which prevented Datashed from completing this process.  At least a portion of the time this appears to be due to "empty headers".  To fix this, open your csv file and delete several empty columns next to your last column of data and several empty rows beneath your last row of data.  Be careful to not delete actual rows of data.  Save the csv file and begin the import process again.  If you continue to experience this problem contact Datashed support.

7.  The purpose of the Map CSV screen is for the user to map (or match) the names of the various water quality data parameter types (ex: pH, alkalinity, iron, etc) contained within the columns of your spreadsheet (shown in the Top Row in Blue) with the field name used by Datashed (shown in the Bottom Row). Basically, you are telling Datashed which column of data is your Sample point, Date, pH, iron, etc.   Before you begin to complete the mapping process, please check to make sure that Datashed has successfully imported all of the columns from your spreadsheet.  It is much easier to check that the data is there than to try to fix it later.  If it has not correctly imported all of the columns, use the web browser back arrows to go back and repeat the process. 

8.  Datashed is programmed to try to automatically map the data and will try to "guess" and auto-select the correct parameters based on key words.  Carefully, look at your heading (Top Row) and then what Datashed selected in the bottom row.  While the names may be slightly different, it is important that you make sure that Datashed has selected the correct field.  It is pretty good, but it definitely makes mistakes. Pay extra attention to the difference between total and dissolved metals, method of flow vs flow.  To move across the screen you will need to use your arrow keys or you can use the scroll bar at the bottom of the page; however, you often cannot see the scroll bar if you are importing more than a few rows of data.

While mapping the data types, you will also need to distinguish whether each particular column of data was measured in the field or the lab (Middle Row).   Simply click either the Lab or Field box.   Datashed will often auto-select this, but this is much more difficult for Datashed to do correctly and it tends to default to selecting Lab, so it is important to verify each box is correct.  For some parameters such as pH and alkalinity you might have both a field and a lab measurement, so it is important to tell Datashed which is which.

9.  Datashed will also automatically select the sample point (far left column), as long as they exactly match the sample point names stored in Datashed.  Those highlighted in green were auto-selected. Anything highlighted in pink indicates there is a problem and will need corrected.  It is a good practice to quickly look down the list to make sure Datashed made a correct match and is very quick if the sample set is not large.

10. Once the mapping is complete, click on the Submit button.  Datashed is programmed to help identify potential errors. If Datashed detects any definitive errors, it will not allow you to proceed until you have fixed them.  Datashed may also question your values, if they are "out of typical range".  For some potential errors, Datashed will allow you to proceed, but you should check to make sure the values are correct before doing so. If the data upload is successful without errors, you should be taken back to the projects home page (ie project details page) and you should see a message at the top of the screen that says "Your CSV data has been saved successfully! Thank you for your data submission!" 

 

Help Section