For the complete documentation index, see llms.txt. This page is also available as Markdown.

Activities

The base unit for FieldDoc data.

IN THIS ARTICLE

FieldDoc Data Manager provides a digital portfolio where your organization can document, manage, and track nature-based work. The foundational unit in FieldDoc is the Activity record. These records can represent conservation, restoration, or other nature-based work that your organization plans, implements, monitors, or reports.

Each Activity record can store a range of information about the work it represents. This may include a mapped location or footprint, implementation dates, descriptive details, progress status, and environmental model results that estimate benefits. You can use Activity records to track work from early planning through installation, completion, and long-term monitoring.

Within your portfolio, you can organize Activity records using Folders. You can also share records with funders or program managers, export data, and use integrations to connect FieldDoc with other applications.

In Legacy FieldDoc, Activities were called Practices. The change in FieldDoc 2.0 reflects the expanded list of nature-based work that can be tracked in FieldDoc. Restoration BMPs like cover crops, tree plantings, and wetland restoration are still supported as Activity_Types. The expanded list includes additional work such as convenings, monitoring, and research.


Each activity record is accessible by a tile in your portfolio. Each record contain a wealth of qualitative, quantitative, geospatial, and standardized information about your nature-based work. Activity records help you track where you're implementing conservation and restoration activities, what you're implementing, and their impact.

What is an activity record?

An activity record should represent a single implementation or a representative example of a single implementation. Each activity record should be verifiable, if required, by the activity owner or by other authorized FieldDoc users, such as Program Managers or Collaborators. Keep this in mind when creating an activity record and delineating its geospatial boundary. For example, activity record geometries should not be delineated at the scale of an entire watershed, county, or state. Doing so may disrupt FieldDoc’s functionality.

🌱 Learn more about delineating the geometry

Create Activity Records

FieldDoc makes it easy to create activity records within the platform, but if you already have data ready to port into the system, we have options to get that data into the system too!

When to use in-app Create Activity?

Use the Create Activity button if you do not have a geospatial file for this record or a spreadsheet with prepared data. This will allow you to use FieldDoc's Map Editor to delinate the activity footprint.

Where to find Create Activity?

You can create an activity from multiple entry points: on Home Page, within a Project, or within a Pact.

Step-by-Step Instructions

  1. Open the Workspace where you want to create the activity record.

  2. Enter a Name for the Activity.

  3. From the Activity Overview Page, open the three vertical ellipses and select Edit Activity. This opens up the Edit Activity Modal.

  4. Now you can enter in all of the attribute information that you have for this record.

    • Activity Type - Choose from the universal list. Click Save once you have selected the activity type.

    • Geometry - use the point, line, or polygon draw tools to delineate the activity location on the map. TIP - if you draw a line or polygon, you can grab the extentor set a custom extent on the Extent tab.

    • Organization Metrics - If you have a list of organization metrics, you can select metrics and set planned_values for all relevant metrics. (TIP - the activity must be assigned to a Pact before you can add programmatic metrics!)

    • Models - If you selected an Activity Type and there is an associated model, you can calculate model outputs on this tab. Most models require a geographic component, taken from the geometry, and an Unit Value.

Dig in! Interactive Tutorial

spinner

For more information on any individual section, please visit the corresponding article.

When to use Batch Import

Use the batch import option if you have geospatial file(s) or a spreadsheet of multiple activity records that you would like to create simultaneously. You can batch import a file with projects, activities, or metrics.

If you have a single geometry, you will use the Batch Import feature to create the activity record and add the geometry to it in one step.

Where to find Batch Impact?

You can batch import from multiple entry points: on Home Page, within a Project, on the Activity page, or within a Pact. Once in the Batch Import modal, check the upper left hand-corner to confirm what the system thinks that you are importing.

Step-by-Step Instructions

  1. Prepare your source file.

  2. Select the File Import button.

  3. Select your source file and drop it in the modal.

  4. Map your source file field names to the FieldDoc Field Names.

  5. Click Save. The system will tell you how many records were imported.

  6. If you were importing activity records, open the Activities within your Portfolio.

  7. Since you cannot import the activity_type:namefield, now is a good time to associate that FieldDoc managed data with your activity records. A "fast" way to add the activity_type:name is to toggle your activities to the grid view.

  8. Select the field activity_type:name . A drop down appears. Search for the appropriate option, select it, and save. Repeat for all records.

  9. If you are adding Metrics or Models to your records, check out the corresponding articles for options for how to add those in expedited actions, like using table views.

Dig in! Interactive Tutorial

spinner

When to use Table Views to create Activities?

You can create new activity records from the table views in FieldDoc. You will treat the table view like a spreadsheet to enter in an activity record within a single row.

Where to find Table Views

Table views for Activities are available within the Activity Portfolio as well as individual Projects and Pacts.

Step-by-Step Instructions

  1. Switch to the Table view.

  2. In an empty row, type in the Activity_Name

  3. Select the associated Project_name, if applicable. Tip! Activity records can only be organized in one Project.

  4. Select the associated Section_name, if applicable. Tip! Activity records can only be organized in one Section, which is a sub-folder of the Project.

  5. Select the Activity_Type:Namefrom the universal list.

  6. Add your Activity_Description. This is a text field. This is a great place to add details for you and your team about the record that you are documenting.

  7. Type in the Practice:extent. This is a number field.

  8. Use the practice:extent_unitto define the extent. Select from the available drop down list.

  9. Return to the Tile View. Open the Edit Activity modal to add a geometry and activate the model.

  10. Open the Geometry tab. Use the draw tools to delineate the geometry for this record.

  11. To activate a model, you need both an activity_type and a geometry. Keep in mind that not all activity_types have models, and some models may not work in all locations.

Dig in! Interactive Tutorial

spinner

When to use Map Editor to create Activities?

We do not recommend using the Map Editor to create mulitiple activity records.

If you want to create all of your records via a digital map editor tool, there are some excellent third party tools availble. We recommend using third party applications like ArcGIS Online, GeoJSON.io, or Placemark.io and then using our Import feature to add them to FieldDoc.

Where to find Map Editor

The Map editor view is available from the Activity Portfolio view as well as within individual Projects and Pacts. Please use the Map Editor to edit existing geometries.

Editing an Activity

To edit an existing activity record, open the Edit Activity modal. From this view, navigate to the area that you would like to update and make your change. Remember to click save!

Currently, you cannot edit existing records by importing a file.

Edits are easy in FieldDoc table views. We recommend using the Activity Table to edit activity_type, extent, extent_unit, and completed_ondate.

To edit Metrics associated with Activities, we recommend using the Metric Table and Implementation Table available in the Project, Activity, and Pact views.

If you would like to edit a geospatial feature for an Activity record, you can do that from the Map Editor view. You have the option of editing or deleting a geometry. You have the option of deleting an entire feature record too.


Activity Attributes Overview

General Settings

The following provide a brief overview of the different attributes that you can attach to each Activity record.

What fields are required?

All fields in the activity record are optional; however, some Program Managers may have specific data standard requirements that must be met. Find your Program Guide for specific instructions.

When building your organization's portfolio, we recommend creating your guidelines for your organization and collaborators to clearly indicate how you want to structure and name your data and what fields you want to include.

Activity Type

FieldDoc provides a universal Activity Type list of standard names. Users have the option to attach an activity type from this list to their activity record. This is helpful if you want to turn on environmental models or participate in funding programs with curated activity type lists.

🌱 Learn more: Activity Type

NEIEN

Map this Activity to NEIEN best management practice specifications.

Align activity metadata and implementation measurements with Environmental Information Exchange Network specifications. This information enables implementation tracking and crediting by state governments and the U.S. Environmental Protection Agency.

🌱 Learn more: NEIEN

Extent

FieldDoc calculates extent based on the dimensions (area, length, etc.) of an activity's geometry. Many models and activity types use this number to calculate estimated nutrient and sediment reductions and other parameters.

FieldDoc uses the World Geodetic System (WGS84, EPSG:4326) as its reference coordinate system. Note that the estimated extent value generated by FieldDoc may differ from values produced by other systems that process geospatial data.

If necessary, fill out the "User-defined extent" inputs below to override the FieldDoc-generated extent.

🌱 Learn more: Extent

Completion Status

Completion status indicates the date when the activity was fully installed by clicking the Mark activity as completed button. We recommend marking an activity as complete when all work is done to specification - this may

The activity completion date is never generated by FieldDoc. It must be entered manually.

🌱 Learn more: Completion Status

State Reporting

For use by users that are submitting their Activities to State Reporting Leads for crediting.

🌱 Learn more: State Reporting

Inspection Log

Demonstrate ongoing functionality of an installed Activity, or BMP.

🌱 Learn more: Inspection Log

Pacts

Look at the Pacts associated with this record, or connect the record to a new/existing Pact.

🌱 Learn More: Pacts

Project

Project folders provide organizational structure to individual activity records. Activity records can only be associated with a single project. Project folders can also include sections, which provide even further organizational options.

🌱 Learn more: Project

Privacy

The privacy setting indicates that the geometry from this record should be generalized if shared via a Pact with a third party. It does not protect the data from being shared.

🌱 Learn more: Privacy

Geometry ➜

The geometry tab opens the Map Editor. From this view users can draw a geometry type to delineate the activity record footpring. FieldDoc provides basic draw tools for points, lines, and polygons.

🌱 Learn More: Geometry

Activity Metrics ➜

Both Organizational Metrics and Programmatic Metrics can be added to individual activity records. Metrics will include a planned_valueand implemented_valueto track progress towards organizational goals.

🌱 Learn More:

Models ➜

Where available, you can choose to turn on environmental models that are associated with the selected Activity Type .

🌱 Learn More:


Share Activity Records to Funder

All activity records that you create become part of your portfolio. You can share some activity records to one or many third parties via Pacts.

There are two pathways that you can take to share an Activity with a funder:

Create an new activity record within a Pact.

Within a Pact, navigate to the Activities tab. You can create new records by clicking Create or Import File.

Tips about creating activity records within a Pact

  • The benefit of creating records within a Pact is that the programmatic metrics will be available without any further action needing to be taken.

  • When you create an activity record within a Pact, it is not assigned to a Project Folder or Section in your Portfolio. You can organize your records from within the edit activity modal or from the Activity table view in your portfolio.

All activities that you create are placed into your portfolio. All of these activities can be linked to one or many Pacts. Once an activity is linked to a Pact, programmatic metrics from that Program can be added to the activity record.

If you open an activity record, you can link it to a Pact without leaving the record from two locations: within the Edit Activity modal or from the Overview>Pact tab. From these views, you can create a new Pact or manage your Pact connections. You can also jump over to the Pact overview page using the hyperlink.

spinner

Last updated