Data Connections and Integrations

Agronomic Technology Corp provides a full service REST API for customers and partners who wish to leverage Adapt-N and N-Insight in their own software interfaces.  For current documentation, developer access, pricing, and support, please contact support@agronomic.com.  

Linking an Adapt-N account with the Agrian software system

Agrian's software system provides users with a full suite of agronomic data management tools.  Your Adapt-N account can be connected with Agrian's software, enabling various data to automatically be populated in Adapt-N, streamlining the field configuration process.

Overview Video

Linking your Adapt-N account to your Agrian account

Follow these steps:

1. Login to Adapt-N at www.adapt-n.com, by clicking the Login link in the upper right.
2. Click on Settings in the navigation bar, and select Agrian Settings.  
3. Click the “Authenticate with Agrian” button.  You will then be prompted to authenticate using your Agrian credentials (the same information you use to login on Agrian's website). Complete the steps as prompted.

Your Adapt-N account has now been granted access to data from your Agrian account.  The above steps are generally a one-time process for new Adapt-N accounts.  In the event that your authentication with Agrian expires, you may be prompted to re-authenticate.  Note that the linkage between an Adapt-N and Agrian account occurs at the user level, not at the grower, farm, or account level.

Generating Adapt-N recommendations using Agrian source data

Using Agrian data as a source for Adapt-N recommendation involves 3 broad steps:

1. Importing the Agrian Grower into Adapt-N (this makes the Grower’s fields available to Adapt-N for selection in the next step).
2. Importing individual Fields from that Grower into Adapt-N (this creates the Grower/Farm/Field relationship in Adapt-N and pulls in the field’s boundary and optionally zone geometries).  Single field and bulk import options are available.
3. Configuring the fields and producing the Adapt-N nitrogen recommendation (this sets the necessary information for Adapt-N to run a recommendation, including tillage method, planting information, soil test results, etc.).  

Detailed instructions on these steps

Importing the Agrian Grower into Adapt-N

To import a Grower from Agrian into Adapt-N, find the Grower in the list at the bottom of the page, select "Create as new grower," and press "Import".  This will cause the Grower's fields to become available on the "Fields" tab of the Agrian Sync page.  You may optionally import all Growers at once.

Importing a Grower’s Fields into Adapt-N: one field at a time

On the Fields tab of the Agrian Sync page, select a Grower whose field you wish to import.  Check the box for the appropriate field and click the Import Selected Field button at the bottom of the page.

The field's boundaries will then be displayed, along with the Farm and Field name as found in Agrian.   Select an appropriate Field Mode and Automatic Zone Configuration Option and click submit.  If Management Zones have been created in Agrian, then an "Agrian Zones" option will also be displayed:

If you select Agrian Zones, then a list of available management zones will be displayed.  You can optionally choose an attribute from those management zones to use for zone names in Adapt-N.  If this option isn't specified, zones in Adapt-N will be named "Zone 1", "Zone 2", etc.

Importing a Grower’s Fields into Adapt-N: Bulk import option

On the Bulk Import tab of the Agrian Sync page, select a Grower whose fields you wish to import. You may also select an option to display all Growers' fields.  Check the boxes for each field you wish to import, then fill out the form below.  Field Mode and Zone Creation option are required; all other values are optional. The values you select will apply to all fields during the import.  Note that field-specific Agrian zones cannot be utilized via the Bulk Import tool.

Configuring the fields

Once a field is imported, the Map View in Adapt-N displays a field link indicator, showing the source system for each field.  Click on "Configure Field" to access the Variable Rate field configuration page.  Or, use the Field and Zone menus to edit one or more zones details.

Soil Organic Matter Sync

Once a field is imported, Adapt-N automatically imports the most recent Soil Organic Matter test for the field (as long as that test is within the last 5 seasons).  You can also manually sync the most recent soil test, or import Soil Organic Matter data via shapefile or constant value, from the Configure Field tool: 

Additional Information: 

Currently, the Agrian integration supports the import of Growers, Farms, Fields, Field Boundaries, Management Zones, Soil Organic Matter, and pH test results into Adapt-N.  Additional features will be added down the road.

agX can be used as a data source to configure variable rate fields in Adapt-N. Different sync options exist depending on the zone management field mode .  For information on linking an Adapt-N account to an agX Platform account, please visit this page.

Point-Based and Zone-Based Fields

When importing an agX field into Adapt-N, if Management Zones exist for the field in agX, an additional Automatic Zone Creation method will become available.  When selected, a drop-down list will let the user choose from a saved Management Zone set in agX to use for creation of Zones in Adapt-N:

Select the desired Management Zone option and complete the field import.  An Adapt-N zone will be created for each agX Management Zone.  If present in agX, the Yield Goal for each zone will be also be applied to the new zones.  If the Management Zones are named in agX, those names will be used in Adapt-N, else zones will be numbered.  In all cases, when Management Zones are used, soil texture, slope, drainage class, and rooting depth will be set automatically (but may be adjusted by visiting the Land Details page for each zone).

Grid-Based Fields

When configuring a Grid-Based field in Adapt-N, layers with agX sync capabilities will have a "Sync with a Source" option presented.  

Soil Type and Soil Slope: by default, Soil Type, Slope, drainage status, and rooting depth for the field values are automatically set based on Soil Survey data during field import.  These values can be overridden from the Field Configuration screen.   Default values on the Sync with a Source screen are optional, and will only be utilized in parts of the field where the Soil Survey database lacks sufficient information.

Soil Organic Matter: by default, the most recent soil test results from the past 5 seasons will be used to automatically set the Soil Organic Matter configuration for fields up on import.  If the soil sampling operation in agX is polygon-based, the Adapt-N field's organic matter values will be configured based on those sampling polygons.  If the sampling operation in agX is grid-sampled, Adapt-N will automatically interpolate those values as necessary.  

Expected Harvest Population: when Sync with a Source is selected, Adapt-N will display all available datasets containing planting rate information, including some basic statistics about those planting records.  The default value is optional, and will only be used in cases when the selected agX data does not cover the entire field.  This includes:

1. Crop Establishment and Input (CEI) Applications
2. Crop Establishment and Input (CEI) Recommendations

 Adapt-N takes 90% of the seeding rate for use as Expected Harvest Population

Expected Yield: when Sync with a Source is selected, Adapt-N will display all available datasets containing yield goal information, including some basic statistics about those records.  This includes:

1. Crop Establishment and Input (CEI) Applications
2. Crop Establishment and Input (CEI) Recommendations
3. Management Zones containing yield goal information

Regardless of which data source is selected, the Maturity Class and Planting Date controls must be specified in the Adapt-N interface, as these values will be used in all cases.  The Default Expected Yield input is optional, and will only be used when a portion of the field lacks yield goal information in the specified dataset.  Note that if Management Zones from agX are used during the field import process, yield goals associated with those management zones will be used by default, but can be updated by the user via the Configure Field interface.

Other Input Layers: can be set via constant value or Shapefile upload.

Bulk Import

View this article for information on how to import multiple agX fields at once with common field characteristics.

Completed Recommendations

Adapt-N recommendations can be exported back to agX. See this article for details.

Users with access to the agX integration will find a Bulk Import tab in their agX settings.  This allows users to import multiple fields at once under a common field configuration.  Once an import is initiated, a popup box will display progress and details.  Please leave this window open until the import completes.  Any errors will be displayed at the end of the process.

Please contact support@agronomic.com for additional questions or assistance with this feature.

The agX Platform provides a geospatial infrastructure for a community of integrated ag products and services to seamlessly share data with applications authorized by its users.  Adapt-N is an agX compliant application, enabling users to pull source data from products like Proagrica's Summit and Sirrus tools, and push Adapt-N recommendations back into those or other systems for application in the field.  If you have an agX account but do not yet have an Adapt-N account, please register here.

Linking your Adapt-N account to your agX account

Follow these steps:

1. Login to Adapt-N at www.adapt-n.com, by clicking the Login link in the upper right.
2. Click on Settings in the navigation bar, and select agX Settings.  You may also access this section by clicking “Import agX Grower” when choosing a Grower Account within Adapt-N.
3. Click the “Initiate agX Connection” button.  You will then be prompted to authenticate using your agX credentials, and to authorize Adapt-N to access your field boundaries and collected data.  Complete the steps as prompted.

Your Adapt-N account has now been granted access to data through the agX Platform.  The above steps are generally a one-time process for new Adapt-N account.  In the event that your authentication with agX expires, you may be prompted to re-authenticate.  Note that the linkage between an Adapt-N and agX account occurs at the user level, not at the grower, farm, or account level.

Generating Adapt-N recommendations using agX source data

Using agX data as a source for Adapt-N recommendation involves 3 broad steps:

1. Importing the agX Grower into Adapt-N (this makes the Grower’s fields available to Adapt-N for selection in the next step).
2. Importing individual Fields from that Grower into Adapt-N (this creates the Grower/Farm/Field relationship in Adapt-N and pulls in the field’s boundary geometries).
3. Configuring the fields and producing the Adapt-N nitrogen recommendation (this sets the necessary information for Adapt-N to run a recommendation, including tillage method, planting information, soil test results, etc.).  See this article for specific information on using agX as a data source for various input layers.

Detailed instructions on these steps

Importing the agX Grower into Adapt-N

To import a Grower from agX into Adapt-N, find the Grower in the list at the bottom of the page, select "Create as new grower," and press "Import".  This will cause the Grower's fields to become available on the "Fields" tab of the agX Sync page.

Importing a Grower’s Fields into Adapt-N

On the Fields tab of the agX Sync page, select the field you'd like to import by checking the box next to the field name.  Click the Import Selected Field button at the bottom of the page.

The field's boundaries will then be displayed, along with the Farm and Field name as found in agX.  Select an appropriate Zone Configuration Method and Automatic Zone Creation option and submit the field.

Additional Tips: 

The agX Data Sync page can be accessed from multiple parts of the Adapt-N interface:

• By clicking on the “Import agX Grower” option when selecting a Grower Account
• By clicking the “agX Settings” link within the Settings menu
• By clicking “Sync with a source” during the field creation process

All three of these take you to the same place.

The agX Sync page in Adapt-N is comprised of four tabs:

• Growers: this tab shows a list of all Growers in Adapt-N system (top, indicating which are linked to an agX Grower) and all Growers in agX that do not yet exist Adapt-N (bottom).  To import a Grower into Adapt-N, use the “Create as new grower” menu item, then click the "Import" button to the right.
• Fields: this tab shows a list of the fields in agX for the imported Growers.  A field with an available checkbox has not yet been imported into Adapt-N.  A field with a disabled checkbox has already been imported into Adapt-N; click the link to view it in Adapt-N.
• Bulk Import: this tab lets multiple fields be imported simultaneously under similar field characteristics.
• Custom Fertilizers: this displays all Custom Fertilizers that exist in the user’s agX account.  Check the boxes next to whichever fertilizers you would like available for us in exporting completed Adapt-N recommendations back to agX.
• Account: in the event that you receive an authentication error while using the agX integration, you may return to this page to re-establish your agX connection, or to view the agX account to which the Adapt-N account is linked.

See this article for details on how to import different layers of data from agX.

The EFC Systems FieldAlytics system has completed an integration with the Adapt-N API, enabling users to remain within the FieldAlytics interface to generate, view, and export Adapt-N recommendations and N-Insight reports.  Please contact EFC Systems support for assistance.

John Deere Operations allows users to quickly move data to and from Adapt-N.  Your Adapt-N account can be authenticated with John Deere Operations Center using MyJohnDeere credentials.

Linking your Adapt-N account to John Deere Operations Center

Follow these steps:

1. Login to Adapt-N at www.adapt-n.com, by clicking the Login link in the upper right.
2. Click on Settings in the navigation bar, and select John Deere Operations Center Settings
3. Click the "Authenticate with John Deere Operations Center" button.  You then be directed to the MyJohnDeere page where you can enter the login credentials for the MyJohnDeere account.  Complete the steps as prompted.