Use ArcGIS Online data in FMX to connect GIS-managed assets to work management and mapping workflows.

Summary

This article explains what the FMX ArcGIS Online integration does and how to connect ArcGIS Online feature layers to FMX so you can work with GIS-managed assets inside FMX.

Audience And Prerequisites

💡 Note: You need access to ArcGIS Online and FMX configuration settings to set up an integration connection.

Who This Is For

• FMX Administrators
• GIS Administrators supporting FMX

What You Need Before You Start

• Admin access in FMX
• Confirmation from your FMX customer success representative that the integration has been added to your site
• An ArcGIS Online account with permission to create API credentials and access the target feature layers
• A list of the ArcGIS Online feature layers you want to sync to FMX

Overview

What This Integration Does

FMX can connect to ESRI ArcGIS Online and use your existing GIS data to populate location-aware records in FMX. You can also optionally allow FMX to populate work order data into ArcGIS Online. This integration helps teams avoid double entry and lets staff work from FMX while still leveraging GIS as the source of truth for geospatial data.

Key Capabilities

• Sync selected ArcGIS Online feature layers into FMX Equipment or FMX Work Requests (ArcGIS → FMX)
• Map ArcGIS attributes (including coordinates) into FMX fields
• (Optionally) Sync selected FMX Work Requests to assets in ArcGIS Online
• Use FMX mapping features to view records geographically and jump into FMX work (work requests and planned maintenance)

⚠️ Warning: ArcGIS data governance varies by organization. Many teams prefer ArcGIS to remain the system of record and may not want edits made in FMX to write back to ArcGIS. Confirm your data ownership and change control approach before enabling any write-back workflow.

Instructions

Completing The Core Workflow

1. In ArcGIS Online, identify the feature layers you want to use in FMX.
2. Confirm each layer includes, at minimum, a unique identifier, a readable name, and geometry (latitude/longitude for points, or a compatible geometry type).
3. In FMX, open the ArcGIS Online integration setup.
4. Provide ArcGIS Online API credentials.
5. Select the ArcGIS Online feature layers you want FMX to read.
6. Map ArcGIS layer fields to FMX fields.
   • Include Name and address (when available).
   • Include latitude and longitude so FMX can place records on the map.
7. Run the initial sync to create or update the corresponding FMX records.
8. Validate a small sample of records.
   • Confirm the location is correct on the FMX map.
   • Confirm key attributes (like identifiers and names) match ArcGIS.

✅ Best Practice: Start with one layer and a limited subset of records to confirm field mappings before syncing your full dataset.

Confirming It Worked

• You can find the synced records in FMX and see their mapped fields populated.
• You can open FMX mapping and see the records appear in the correct geographic location.
• If your workflow includes work requests or planned maintenance linked to assets, you can open a mapped record and navigate into its associated FMX work.

Variations And Advanced Options

Common Variations

• One-way sync (ArcGIS → FMX) only: Common when GIS teams want to prevent non-GIS users from overwriting authoritative GIS data.
• Write-back / review-based updates: Some workflows require FMX-originated updates to be reviewed and accepted in GIS. This requires careful change handling to avoid conflicts.

Related Settings

• Layer selection and field mapping settings in the ArcGIS Online integration configuration
• FMX mapping settings that control how records appear and what details are shown on map popovers

Troubleshooting

Common Issues

• Records sync but do not appear on the map
  • Cause: Coordinates are missing or not mapped to FMX geolocation fields.
  • Fix: Confirm the ArcGIS layer provides geometry and that latitude/longitude fields are mapped correctly.
• Some expected records do not sync
  • Cause: The layer query, permissions, or filters exclude those features.
  • Fix: Confirm ArcGIS Online permissions for the integration credentials and verify which layer (and which subset) is being read.
• Layers with lines or polygons do not render as expected in FMX
  • Cause: FMX mapping may support point pins today while line and polygon layers require additional support.
  • Fix: Start with point-based asset layers first. Document which additional layers you want to visualize so your team can plan next steps.

FAQ

• Does this integration need to be two-way?
  • Many organizations prefer a one-way sync from ArcGIS into FMX. If you need write-back, plan permissions and conflict handling carefully.