Import
Last updated
Last updated
IN THIS ARTICLE
Learn how to build your portfolio using external .csv, .GeoJSON, or Shapefiles. Get existing geospatial data into FieldDoc in a breeze.
Import is a powerful feature in FieldDoc that allows users to create records with existing geospatial data or create batch records. Let's walk through the import process.
When you import activity records, FieldDoc helps organize them for you. Here’s how it works:
Importing from a Project or Pact If you start the import from inside a specific Project or Pact, all the activity records in your file will automatically be added to that grouping.
Importing from the Home Page If you begin the import from the Home Page, the activity records will be unassociated with a Project or Pact, unless you have included that information to your source file. This gives you more flexibility.
Including Project and Section in Your Source File If your import file includes columns for Project and Section, FieldDoc will create new digital representations of of those for you—no need to set them up ahead of time.
FieldDoc accepts .csv, .GeoJSON, and Shapefiles for import. FieldDoc follows industry standard practices in our source file requirements. If your file meets these requirements, it will be imported into FieldDoc successfully.
Value
Supported column headers
geometry
wkt
latitude
lat latitude y
longitude
lng lon long longitude x
In addition to the mandatory .shp, .shx, and .dbf files, shapefile archives must include a .prj file that describes the coordinate system and projection. All files must be compressed into a .zip file before uploading. To ensure that FieldDoc reads the archive correctly, the archive itself and the files it contains should share the same name. File names must not contain spaces.
Important: Nested ZIP folders are not supported (e.g. example.zip > example > example.shp). All required files must be stored in the top level of the ZIP folder (e.g. example.zip > example.shp, example.shx, …).
File size and feature count
You can find the Import File button in several places across FieldDoc.
Tip: Starting your import from the right place saves time and helps keep your activities organized automatically.
Open the Import File button. Drop in your source file and click upload.
Map your source file fields to the FieldDoc fields.
Click save.
FieldDoc may take a few moments to generate all of the new records. Once it has completed the task the button will turn green and indicate how many records were imported.
Some fields cannot be imported. So once you have imported your file, you must complete the configuration for each activity record. Look below for more guidance on that.
FieldDoc's importer cannot import the following fields:
Activity Type
Extent
Extent Unit
Model Input
Open the Edit Activity modal.
Navigate to Activity type view.
Select Choose Activity type to open the universal list.
Search for the appropriate activity type
. Select it. Save. Close modal.
Save on the overview page.
Open the Edit Activity modal.
Navigate to the Models view.
Follow the instructions to input all required fields and run the model.
Click save.
Open the Edit Activity modal.
Navigate to the Metrics tab.
Select the associated Pact to access the relevant Programmatic Metrics list.
Tips:
Link your activity record to a Pact in order to access the Programmatic metrics.
Activity records can be assigned to multiple Pacts.
Files in comma-separated value (CSV) format may contain spatial data, but it isn't required. If included, geometry values should be provided as coordinates or . When your file contains coordinates, columns for latitude and longitude must be present. Please refer to the following column header mappings before uploading CSV files with spatial data.
GeoJSON files must use the .json or .geojson file extensions and follow the format described in . We recommend testing GeoJSON data with before uploading it to FieldDoc. See for more help with the GeoJSON format.
Regardless of type, file uploads cannot exceed 10 MB. For shapefile archives, this is the maximum total size of all un-compressed files. FieldDoc processes up to 1,000 features per upload. Additional features beyond that limit will be ignored. For larger workloads, please .
Prepare your source file. Review our to make sure that your file will be successfully imported.
Before you begin, we recommend reviewing to choose the best place to start your import—whether that’s from the Home Page, a Project, or a Pact. Your starting point helps determine how your data will be grouped and displayed.
These are critical fields in the FieldDoc system, so users will need to manually input this information. Both Activity Type and Extent fields can be quickly inputted using the . Alternatively, you can open the Edit Activity modal and enter this information in manually.
For more detailed instructions, visit the pages.
At this time, models cannot be activated from the table view. To to calculate environmental benefits, you must open the modal within each activity record.