EarthRanger automatically creates subjects based on employee records in SMART CA.

Example

Employees in SMART:

Subjects created in EarthRanger:

This integration automatically creates event categories and event types in EarthRanger using the data model as a reference.

This integration will also create event categories and event types in EarthRanger using configurable data models only if they have been configured in SMART Desktop to sync with Gundi. To include a Configurable Data Model in this integration:

1. Open SMART Desktop
2. Select the configurable data model
3. Click "Edit," select the model
4. Enable Use with SMART Integrate.

Example

In this example, the configurable data model “ខនិក គូលែន ព្រហ្មទេព 092022” will appear in EarthRanger as follows:

Events created in EarthRanger are sent to SMART as independent incidents or waypoints.

Example
 

In this example, the event will show in SMART as an Independent incident:

Events in EarthRanger linked to patrols are created or updated as “patrol waypoints” in SMART.

Example

Attachments added to EarthRanger events are included in the corresponding incident or patrol waypoint in SMART.

Example

Patrols created in EarthRanger are synchronized and updated in SMART if they meet certain conditions:

• The patrol is assigned to a patrol leader from the subjects generated by this integration.
• The patrol has a start time.
• The patrol has a start location.

Audience: Support Team.

Go to Gundi v1 

1. Go to Outbound Configurations.

2. Click Add Integration

Follow the steps below to complete the form:

Name:  Enter a name for your connection (e.g., SMART Server Name).

Owner: Enter your organization.

Type: SMART Connect

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

Login/Password: SMART Connect username and password.

State:

{}

Additional:

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

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

{
  "ca_uuids": [
    "e485dbf8-7f66-4fc0-bf7e-277a30ef0ae8"
  ],
  "configurable_models_lists": {},
  "version": "7.5.7"
}

3. In EarthRanger, create a superuser named “earthranger_to_smart” and define a password for it.

5. In Gundi v1, go to Inbound Integrations.

6. Click Add Integration.

Name:  Enter a name for your inbound (e.g., ER Site name).

Owner: Enter your organization.

Type: EarthRanger.

Provider_key: Leave empty.

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

Token: Leave empty.

Login: Enter “earthranger_to_smart”

Password:  Enter the password previously defined for the user “earthranger_to_smart”.

4. Click Save.

5. To configure the Device Group, use the browser's search functionality and searching for the Outbound Integration you created in a previous step.

6. Click Save.

4. Wait for the periodic tasks to run (up to 4 hours), or ask the Gundi team to trigger it manually.

These periodic tasks need to be run one by one, with a minute of wait.

• 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.

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 4 hours).

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

If this duration seems too long, please contact support.

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.

1. Analyze Traces

Use GCP Trace Explorer to filter activity with the following:

Project: CDIP-Prod1 

RootSpan: gundi_er_smart_sync

Optional Filters:

event_type: Event Number (without “ER-”)

event_title: Title

serial_number: Event Number

2. Analyze Code

Code location: cdip/cdip_admin/sync_integrations/er_smart_sync.py

3. Analyze Logs

Use GCP Log Explorer to filter activity with the following query

Project: CDIP 

"celery" OR jsonPayload.name="smartconnect" 
("configurable model"  OR "failed" OR "from ER"  OR "error" OR "event_types" OR "event_categories" OR "subject" OR "traceback" OR "exception" OR "patrol" OR "404")
-resource.labels.container_name="proxy"
"{{smart server}}" OR "{{ca name}}" OR "{{ca id}}"