Skip to main content
Exporting records from Forerunner allows you to download your data for reporting, analysis, and integration with other systems. Records can be exported in multiple formats to support different use cases, from spreadsheet analysis to GIS mapping.

Export formats

When you export the current view of a records table, you can pick:
  • Spreadsheet (.csv)
  • Geopackage (.gpkg)
  • Geodatabase (.gdb)
  • Zip (.zip) - when the view has a file column. Includes the files themselves
  • PDF (.pdf) - one PDF of the records in the view, up to 500 records
Shapefile is only offered for the built-in SI/SD, SDE, and Elevation Certificate reports.
View only users can’t export records.

CSV (Comma-Separated Values)

Best for:
  • Opening in Excel or Google Sheets
  • Simple data analysis and reporting
  • Importing to databases or other systems
  • Creating charts and pivot tables
  • Sharing with non-GIS users
What’s included:
  • All form field values
  • Calculated fields (SDE totals, percentages, etc.)
  • Property information (address, parcel ID, etc.)
  • Record metadata (created date, creator, last updated)
  • Document filenames and links
  • Status and visibility settings
File format:
  • .csv file
  • Opens in any spreadsheet application
  • Text-based, human-readable
  • No spatial data (coordinates exported as numbers)

Shapefile

Best for:
  • GIS analysis in ArcGIS or QGIS
  • Mapping records spatially
  • Overlaying with other geographic datasets
  • Spatial analysis and queries
  • Legacy GIS workflows
Only available for the SI/SD, SDE, and Elevation Certificate reports. What’s included:
  • All data from CSV export
  • Full spatial data (point geometries)
  • Coordinate reference system information
  • Attribute table with all fields
File format:
  • .zip file containing multiple files:
    • .shp - Geometry data
    • .dbf - Attribute data
    • .shx - Shape index
    • .prj - Projection information
  • Requires extraction before use
  • Compatible with most GIS software
Shapefile field names are cut to 10 characters. Use GeoPackage if you need the full names.

GeoPackage

Best for:
  • Modern GIS workflows
  • Large datasets
  • Maintaining complex data types
  • Single-file portability
  • Future-proofing data exports
What’s included:
  • All data from CSV export
  • Full spatial data (point geometries)
  • Coordinate reference system information
  • Attribute table without field name restrictions
File format:
  • .gpkg file (single file, no extraction needed)
  • SQLite database format
  • Supports longer field names than shapefile
  • Compatible with QGIS, ArcGIS Pro, and other modern GIS tools
GeoPackage is the recommended format for GIS users as it has fewer limitations than shapefile and is a single file that’s easier to manage.

Exporting from records tables

The primary method for exporting records:
1

Navigate to records table

Go to Records and select the category you want to export (Inspections, Permits, SI/SD, etc.).
2

Apply filters (optional)

Filter the table to show only records you want to export:
  • Date range
  • Record type
  • Status
  • Property attributes
  • Custom field values
Only visible filtered records will be exported.
3

Open Export

Open the … menu on the table and select Export.
4

Configure export

In the export dialog:
  • Pick Current view or one of the built-in reports
  • Choose a File type
5

Start export

Click Export to start the process.What happens:
  • System queues export job
  • Processing begins in background
  • You can continue working
  • Progress notification appears
6

Download file

When the export is ready, we’ll email you a download link. You’ll need to be signed in to Forerunner to use it.
Large exports (thousands of records) may take several minutes. You’ll receive an email when the export is ready, so you don’t need to wait on the page.

What’s included in exports

Record exports contain comprehensive data:

Form field values

All fields from the record form:
  • Text inputs
  • Numbers and calculations
  • Dates
  • Dropdown selections
  • Checkbox values
  • User selections
  • Tags and categories

Property information

If records are linked to properties:
  • Property address (full and components)
  • Parcel ID
  • Coordinates (latitude and longitude)
  • Flood zone designation
  • Property type
  • Owner information (if available)
  • Custom property attributes

Calculated fields

For records with modules (SDEs, SI/SD):
  • Structure value calculations
  • Depreciation amounts
  • Percentages and ratios
  • Derived values
  • Invariants (persisted calculations)

Metadata

System-tracked information:
  • Record ID (unique identifier)
  • Created date and time
  • Created by (user name)
  • Last updated date and time
  • Last updated by (user name)
  • Record version
  • Visibility status (public or hidden)

Document information

For uploaded files:
  • Document filenames
  • Upload dates
  • Document types
  • Links to files (for internal use)
Spreadsheet and GIS exports contain file details and links, not the files themselves. To get the files, add a file column to the view and export as Zip (.zip).

Export use cases

Reporting to state and federal agencies

FEMA Individual Assistance (IA) reporting:
  1. Navigate to Inspections > PDAs
  2. Filter to disaster date range
  3. Export to CSV
  4. Open in Excel and format for IA reporting template
  5. Include damage assessments, owner information, estimated losses
FEMA Public Assistance (PA) reporting:
  1. Filter to SDEs for public facilities
  2. Export with structural damage details
  3. Include cost estimates and damage documentation
  4. Submit with PA application
State damage reporting:
  1. Export PDAs or SDEs in required format
  2. Include GPS coordinates (use GeoPackage or Shapefile)
  3. Add summary statistics
  4. Submit within required timeframe

GIS analysis

Mapping damage patterns:
  1. Export PDAs to Shapefile or GeoPackage
  2. Import to ArcGIS or QGIS
  3. Symbolize by damage degree
  4. Overlay with flood zones, demographics, or other layers
  5. Create maps for briefings or reports
Spatial queries:
  1. Export records with spatial data
  2. Use GIS to answer questions like:
    • How many damaged properties in each flood zone?
    • Which neighborhoods had highest impact?
    • Spatial clustering of damage
    • Distance to critical facilities
Integration with other datasets:
  1. Export Forerunner records
  2. Join with tax assessor data, building permits, or other sources
  3. Perform combined analysis
  4. Generate comprehensive reports

Data analysis and reporting

Trend analysis:
  1. Export inspections over time
  2. Analyze completion rates, failure trends
  3. Identify common issues
  4. Track seasonal patterns
Compliance reporting:
  1. Export SI/SD determinations
  2. Count properties exceeding thresholds
  3. Track compliance actions
  4. Document enforcement activities
Program evaluation:
  1. Export grant-related records
  2. Analyze project completion rates
  3. Track spending and outcomes
  4. Report to funding agencies

Sharing with partners

Emergency management coordination:
  1. Export damage assessments
  2. Share with county/state emergency management
  3. Support resource allocation decisions
  4. Coordinate recovery efforts
Inter-department collaboration:
  1. Export permits or inspections
  2. Share with building, planning, or engineering departments
  3. Support coordinated reviews
  4. Avoid duplication of effort
Consultant or contractor access:
  1. Export relevant records
  2. Provide to consultants for analysis
  3. Support grant applications or studies
  4. Maintain data control (they don’t need Forerunner access)

Exporting individual records

To export a single record:
1

Open the record

Navigate to the specific record you want to export.
2

Download a PDF

Select Download PDF from the record’s actions menu. Cmd/Ctrl + P does the same thing.
3

Or export via API (advanced)

For programmatic access, use Forerunner’s API to retrieve individual record data in JSON format. Contact your Customer Success Manager for API documentation.
For SDE records, the summary page provides a well-formatted display that’s ideal for printing or saving as PDF documentation.

Export best practices

Before exporting

Filter carefully:
  • Verify filters show exactly the records you want
  • Check row count to confirm expected number
  • Review a few records to ensure data quality
  • Remove unnecessary filters that might exclude data
Choose the right format:
  • CSV for spreadsheet analysis, reporting, sharing
  • Shapefile for GIS with legacy tools or data sharing requirements
  • GeoPackage for modern GIS analysis and mapping
Consider data sensitivity:
  • Exports may contain personal information
  • Handle exported files according to privacy policies
  • Limit distribution to authorized users
  • Secure files if they contain sensitive data

After exporting

Verify export completeness:
  • Open the file and spot-check data
  • Confirm row count matches expected
  • Check that all columns are present
  • Verify spatial data loaded correctly (for GIS formats)
Document the export:
  • Note export date and filters used
  • Save export configuration for repeatability
  • Document any post-processing steps
  • Keep metadata with exported files
Clean up old exports:
  • Delete downloaded files when no longer needed
  • Don’t leave sensitive data in downloads folder
  • Sign in to Forerunner to use the download link
  • Request new exports if data has changed

Scheduled or automated exports

For recurring export needs, your Customer Success Manager can configure: Scheduled exports to ArcGIS:
  • Saved views can be sent to ArcGIS on a schedule
  • Consistent filters and format
  • Reduce manual work for regular reporting
API access:
  • Programmatic export capability
  • Integrate with other systems
  • Real-time or on-demand data access
  • Build custom reporting tools
Scheduled exports and API access require additional configuration. Contact your Customer Success Manager to discuss automated export options for your workflows.

Export limitations and considerations

Field name limitations (Shapefile only)

Shapefile field names are cut to 10 characters. Use GeoPackage if you need the full names.

File size limits

Large exports may be split into multiple files:
  • Generally not an issue for most use cases
  • Exports with tens of thousands of records may take longer
  • Email delivery may fail for very large files (alternative download provided)

Data privacy

Exports may contain:
  • Property owner names and contact information
  • Sensitive assessment or damage data
  • Internal notes and comments
Recommendations:
  • Review data privacy policies before exporting
  • Remove or redact sensitive fields if sharing externally
  • Use secure file transfer methods
  • Limit export access to authorized users

Temporal considerations

Exports are point-in-time snapshots:
  • Data may change after export
  • New records won’t appear in old exports
  • Edited records won’t update in existing exports
  • Re-export if you need current data
Exports do not automatically update. If records are created or modified after an export, you’ll need to generate a new export to capture those changes.

Troubleshooting export issues

Export fails or times out

Possible causes:
  • Too many records selected (try filtering to smaller set)
  • System temporarily busy (try again in a few minutes)
  • Browser connectivity issues
Solutions:
  • Filter to smaller date range or subset of records
  • Try different format (CSV is usually fastest)
  • Contact support if issue persists

Can’t find export email

Possible causes:
  • Email still processing (wait a few minutes)
  • Email in spam/junk folder
  • Email filtering rules
Solutions:
  • Check spam/junk folders
  • Search inbox for “export” or “forerunner”
  • Check notification center in Forerunner
  • Contact support to resend link

Exported file won’t open

Possible causes:
  • File extension association issue
  • Corrupted download
  • Incompatible software version
Solutions:
  • CSV: Open with Excel, Google Sheets, or text editor
  • Shapefile: Extract ZIP file first, then open .shp in GIS software
  • GeoPackage: Open with QGIS or ArcGIS Pro (requires modern GIS software)
  • Re-download file if download was interrupted

Missing data or fields

Possible causes:
  • Filters too restrictive
  • Permissions limiting data access
  • Record version differences
Solutions:
  • Review and adjust filters
  • Check that you have permission to view all data
  • Contact CSM if expected fields are missing