EarthRanger to SMART Connect

Website: https://smartconservationtools.org/en-us/ 
Website: https://www.earthranger.com/ 
 

Assistance Needed

This integration require assistance from our support team for setup and configuration. Please contact our support team at support@earthranger.com and we’ll guide you through the process to ensure everything is set up correctly.

We are actively working to make this integration self-service in the future. Stay tuned for updates!

 


Scope

This integration depends on a bidirectional data exchange, ensuring EarthRanger events align with the SMART data model by pulling relevant data from SMART and automatically creating event categories and event types in EarthRanger.

Additional Details

  • EarthRanger automatically creates event categories and event types from SMART “data models” and selected “configurable data models”.
  • EarthRanger automatically creates subjects based on employee records in SMART CA.
  • Events created in EarthRanger are sent to SMART as independent incidents or waypoints.
    • Important: Only event types created by the integration are considered by this flow.
    • Events in EarthRanger not linked to patrols are created or updated as “independent incidents” in SMART.
    • Events in EarthRanger linked to patrols are created or updated as “patrol waypoints” in SMART.
    • Attachments added to EarthRanger events are included in the corresponding incident or patrol waypoint in SMART.
  • Patrols created in EarthRanger are mirrored and updated in SMART.
 
 

 

Prerequisites

You will need to be sure that the following requirements are met in EarthRanger and SMART Connect.

EarthRanger

  • Token assigned to a superuser account in EarthRanger.

SMART

  • Server version 7.5.7, or later.
  • Conservation Area UUID.
  • SMART Connect Server URL and user credentials with access to the relevant CA.
  • Patrol mandate with followup key and patrol type with foot key. For more information, refer to the details. 

 

Requesting an Integration

Contact Support and provide the following information:

  • Your SMART Connect server URL and credentials.
  • Your SMART Connect server version.
  • Your Conservation Area UUID.
  • Your EarthRanger site URL.
  • The language your Conservation Area is configured to.

 

Data latency

Data latency is influenced by:

  • The synchronization frequency between SMART CA and its SMART Connect server.
  • The scheduled interval set by the Gundi team for fetching and pulling data (approximately every hour).

If data is not available in SMART Connect with these considertations in mind, please contact our Support team for assistance.

 

Considerations

FAQ

My integration is not working, how can I troubleshoot it?

Kindly review the list of prerequisites and considerations. Contact us if you need additional assistance.

Will the integration pick up on changes I make to my SMART Data model?

Yes, every hour the integration will update EarthRanger’s event types based on changes it detects in your data models.

How often does the synchronization run?

There are two synchronization jobs:

  • Every hour (subject to change), the integration will update EarthRanger’s report categories and types to align with your CA’s data model and configurable data models.
  • Every 5 minutes (subject to change), the integration will update your CA with patrols and reports created in EarthRanger.

Why is the EarthRanger patrol not showing up in SMART?

In EarthRanger:

  • Check that the patrol has a start location and patrol leader assigned to it.

In the SMART CA:

  • Check that the patrol type foot and the patrol mandate followup exist.

 

Additional Resources

Support Notes - Configuring Gundi v1

Go to Gundi v1 

1. Go to Outbound Configurations.

2. Click Create Integration

Follow the steps below to complete the form:

Type: SMART Connect

Endpoint: SMART Connect Server  (e.g., https://XXXX.org/server) 

Login/Password: SMART Connect username and password.

Additional Schema:

{
  "ca_uuids": [
    ""
  ],
  "configurable_models_lists": {},
  "version": ""
}

Include the CA UUID (ca_uuids) and the SMART Connect version (version). If the CA is not configured in English, please specify the language. 

2. Create an inbound configuration with the details required to connect to EarthRanger.

Type: EarthRanger

Endpoint: EarthRanger site API (e.g., https://XXXXXX.pamdas.org/api/v1.0)

Token: Superuser long-lived token

3. Configure the device group.

4. Wait for the periodic tasks to run, or trigger them manually. 

  • Maintain Smart Integrations: Download the datamodel, configurable data models, and patrol leaders.
  • Run SMART+ER Integrations: Push data to SMART Connect. 

5. Confirm if the EarthRanger event categories were created.

 
 

 

 

Need Help?

Contact Support

If you need help with Gundi, here are some resources to try. 

Contact the Gundi team 

Send an email to support@earthranger.com with your questions or a description of the issue you have been experiencing.

Help Us Improve Gundi 

If you have comments, corrections or suggestions regarding our guides, website, or the Gundi portal, please contact us. Feel free to explore our website for more contact information.

 

Tags: Conservation Software, EarthRanger to SMART

Last Update: March 13, 2025

Was this article helpful?