Hydrant Import / ArcGIS Sync Tool Guidelines

Hydrant Import / ArcGIS Sync Tool Guidelines

Purpose


To assist agencies in field mapping when using the Hydrant Upload Tool or the ArcGIS Sync Tool.





Instructions


Hydrant Identifying Fields

These fields should be mapped according to client data. First Due ID's are created for all hydrants. Make sure you are mapping any accurate and useful identifiers to the correct fields. 

Hydrant Identifiers
Unique Requirement?
Null Value Accepted? 
Suggested Use Case
First Due ID
Yes - First Due creates this
Yes - But values should be added during import
First Due created ID, not editable by clients. Best ID number to display if other ID numbers are not coming from a clean source or multiple sources
Facility ID
No - Multiple Hydrants can be associated with a Facility ID
Yes - First Due ID will be used as primary if other ID does not come from source data. (Note: not all hydrants are associated with a Facility) 
Hydrants that are associated with a facility, building, complex, etc.
This ID is helpful in those scenarios
Hydrant ID (Xref_id)
Yes
Yes - First Due ID is available still if this field is blank. Null values should be addressed though
Fire Departments internal, common knowledge Hydrant Identifier



Hydrant Import vs ArcGIS Tool: Major Differences

Hydrant Imports are "static" and are typically completed once.

Agencies that utilize the hydrant import tool typically:
• Manage all hydrant data within First Due. This included status changes, changes to details, or addition/removal of hydrants.
• Do not have access to reliable or up-to-date hydrant rest services. 
• Run Flow Testing and Service Testing within First Due - maintain hydrants and are responsible for tracking status. 

The ArcGIS Sync tool updates the client hydrant list from a Rest Service on a schedule. These layers will OVERWRITE data that is entered into First 
Due via the UI if the included fields in the sync conflict with data entered in First Due. We DO NOT currently offer a bidirectional sync - agencies 
should not expect data they enter via the UI to be maintained if that field is included in the list of fields that are updated from an ArcGIS sync.

The ArcGIS tool is typically used: 
• By agencies that have access to accurate and reliably updated hydrant information from a municipal water department or similar agency. 
• Are not responsible for hydrant maintenance, hydrant status changes and other hydrant maintenance schedules. 

Please note: Agencies that use an ArcGIS sync are still able to use our Flow Test, Service Test and Work Order tools - but it is important that we do not 
map fields via an ArcGIS Sync to fields that are updated by agency personnel performing Flow Testing. 


Best Practices for Importing Hydrants

Suggestions for Agencies Using the Tool for the first time: 

File Formatting: To use the Import Wizard tool, hydrant information should be converted into a .csv file. If your current set of hydrant data was not 
provided as a .csv file, please contact the member of your team that provided you with the data and ask for assistance with getting this conversion 
completed. 
• If your hydrant information can already be opened within Excel - you can likely complete this conversion yourself.
Simply open the file in Excel > select "Save As" > Choose the option that contains ".csv" you may notice the wording "Comma Delimited". 
• Once you have saved your file as a .csv, you should be able to upload the document via the import wizard. Before you do - please check 
out the suggestions below to avoid errors/confusion. 

Data: One of the most important steps you can take before uploading your hydrant data is to confirm a few items:

• Does the number of hydrants included in the file match the number of hydrants that are present within your response area? 
            If not, it is important to confirm why this number is higher or lower than you would expect.
• Does each column of data meet the following standards:
             You understand what this data represents (this will be important during the import process)
• Does the column contain data that is important or required to your agency? 
             Is there a clear correlation to where this data should be mapped within First Due? 

Existing Agencies Updating their Hydrant Data: 

Agencies looking to update their hydrant information need to ensure that the NEW hydrant information they are hoping to add or update via a new 
import has the same exact identifier. Any discrepancy in these Identifiers will result in a new hydrant being created - not the hydrant being updated.

Alert
If you are a dept/agency that has a protected rest service layer for your hydrant info, we are currently unable to support syncing a protected rest service layer at this time. 

Info
A protected rest service layer, means that a username/password is required in order to access the data contained within the layer and sync the data to First Due.


Mappable Fields

Below you will find all expected values for the mappable fields in the ArcGIS Sync Tool. 

 Field
 Expected Value
 Example
 Hydrant ID Column
 Up to 32 characters (almost always a number)
The "Hydrant ID Column" in First Due should be mapped to the field in your rest service layer that stores the unique identification number for your hydrants. This field can be named different for each dept/agency. Please reach out to your GIS contact if needing help identifying the correct field. This is a required field and null values are not accepted.

Example: AFD-1234
 Barrel Size
 Any number (two decimal places allowed)
 10
 Facility ID
Up to 32 characters
 101-2
 Fire District
 Up to 50 characters
 Station 126
 Flow Hydrant Rate
 Number (This is Flow Hydrant #1 value)
 900 GPM
 Hydrant Address
 Free Text up to 255 characters (does not match to database)
 123 Main Street
 Hydrant ID
 Up to 32 characters (almost always a number)
 FD-102
 Hydrant Status
 *Hydrant Upload Tool: in_service / out_of_service
 
 ArcGIS Sync: "1" = In Service / Any other value = Out of Service
 in_service/out_service
 operational/non operational

 Hydrant Type
 Must match one of the Hydrant Types created in Setup
 Cistern, Private Hydrant 
 Last Flow Test Date
 Timestamp without time zone 
 mm/dd/yyyy and timestamp
 01/01/2025 01:00
 Location description
 Up to 128 characters
 Behind the giant rock on South Street. 
Placement

 South side of the main highway
 Main Size
 Number
 12
 Manufacturer
 Up to 128 characters
 Kennedy, Mueller
 Notes
 Free Text 
 This hydrant is often hidden by bushes. 
 Number of Outlets
 Number
 3
 Latitude
 2-3 numbers (decimal) 7 numbers
 31.9159550
 Longitude
 2-3 numbers (decimal) 7 numbers
 -81.0736890
 Private
 Boolean
 
 Residual Pressure
 Number (with up to 2 decimal places)
 55
 Serviced/Inspected  Date
 Timestamp without time zone (mm/dd/yyyy)
 08/27/2025 
 Shift
 Matches agency setup for personnel shifts
 B-Shift (must be created in First Due)
 Station
 Matches agency setup for stations Station 126
 Size of Outlet 2
 Number (with up to 2 decimal places)
 2.25
 Size of Outlet 3
 Number (with up to 2 decimal places)
 5.25
 Static Pressure
 Number (with up to 2 decimal places)
 1234.12
 Steamer Port
 Up to 128 characters
 Threaded
 Year Installed
 4 number year
 1975




    • Related Articles

    • Web Responder: ArcGIS Features

      Purpose To give an overview of using the ArcGIS map in the Responder view. Video Overview 1. Navigate to the Responder Module and select the Responder view. 2. The responder view may default to Google Maps. To Ensure that you are in the ArcGIS map ...
    • ArcGIS Permissions

      Purpose To provide descriptions on the various permissions related to ArcGIS. ArcGIS Permissions ArcGIS Layers This permission allows a user to setup, manage and configure which REST service layers can be used with ArcGIS maps within FIrst Due. ...
    • Release Notes - Hydrant Module

      In order to provide you with more detailed information on our updates we have broken the Release Notes down by module. Video Feature Enhancements 1. Hydrant Types now in Hydrant Setup What: Hydrant Types page has been moved to Hydrant Setup as a new ...
    • Adding ArcGIS Hydrants

      Purpose To explain how to add ArcGIS Hydrants Video Directions 1. Click on Hydrants> ArcGIS Hydrants. 2. Click on New ArcGIS Hydrant Sync. 3. Here you will type in the Service URL that you received from your local GIS department. When done, select ...
    • Hydrant Permissions

      Purpose To provide guidance on setting/modifying role permissions for the Hydrants module: Use the "Search Permission" field to quickly find a module’s permission(s) Permissions for the Hydrants Module Hydrant Setup Users can access the Hydrants ...