Data Export

Export bulk data for analysis or backup

For Designers & Managers

Roles: Manager only

Export bulk data including device inventory, measurements, and configuration for analysis or backup.

Accessing Data Export

From the sidebar, tap Export data in bulk under the Other section.

Export Options

Date Range

  1. Select Start date
  2. Select End date

Note: Export range is limited to 7 days by default (or 360 days with experimental features enabled) to prevent excessively large downloads.

Digital Twin Data

Select static configuration data to export:

  • Spaces: Site hierarchy (sites, buildings, floors, zones)
  • Devices: Device inventory and properties
  • Zones: Zone definitions and boundaries
  • Keywords: Keyword list and assignments

Measurement Data

Select measurement types to export:

Position Data:

  • position
  • positionZones

Environmental:

  • ambientTemperature
  • humidity
  • co2
  • tvoc
  • ambientLight
  • barometricPressure

Device Health:

  • batteryVoltage
  • batteryLevel
  • rssi

Activity:

  • movementLevel
  • movementDetections
  • occupancyStatus

And more… (depends on deployed device types)

Performing Export

  1. Select desired data types using checkboxes
  2. Set date range (for measurement data)
  3. Tap Download selected
  4. Wait for the download to complete
  5. Find files in your iCloud Drive under “Haltian IoT Studio”

Export Progress

  • Progress indicator shows export status
  • Large exports may take several minutes
  • You can continue using the app while export runs

Export Format

Data is exported as JSON files, organized in folders by:

  • Host: API server hostname
  • Organization: Your organization name
  • Export timestamp: When the export was created

File Structure

Haltian IoT Studio/
└── [hostname]/
    └── [organization]/
        └── [timestamp]/
            ├── spaces.json
            ├── devices.json
            ├── zones.json
            ├── keywords.json
            ├── measurements/
            │   ├── temperature.json
            │   ├── humidity.json
            │   └── ...
            └── export-manifest.json

JSON Format

Each file contains an array of objects:

[
  {
    "id": "...",
    "timestamp": "...",
    "value": ...,
    ...
  }
]

Using Exported Data

Analysis

  • Import JSON into data analysis tools (Python, R, Excel)
  • Create visualizations and reports
  • Perform statistical analysis
  • Correlate measurements across devices

Backup

  • Store exports as historical backups
  • Archive data beyond retention periods
  • Maintain compliance records
  • Disaster recovery planning

Integration

  • Import into external systems
  • Feed data warehouses
  • Synchronize with other platforms
  • Custom application development

Export Best Practices

Planning Exports

  • Small date ranges: Export 1-7 days at a time for faster processing
  • Selective data: Only export measurement types you need
  • Schedule exports: Regular exports (weekly, monthly) for continuous backup
  • Storage: Ensure sufficient iCloud storage space

Data Management

  • Organize exports: Create a folder structure for different export purposes
  • Document exports: Note what each export contains and why it was created
  • Cleanup old exports: Delete exports you no longer need
  • Compress data: Zip files for long-term storage

Performance

  • Off-peak hours: Run large exports during off-peak times
  • Wi-Fi connection: Use Wi-Fi for large exports to avoid cellular data usage
  • Device resources: Close other apps during large exports
  • Patience: Large exports can take 10-30 minutes

Troubleshooting

Export Fails

If an export fails:

  • Check internet connection
  • Reduce date range
  • Select fewer measurement types
  • Try again later (server may be busy)
  • Contact support if problem persists

Export Too Large

If the export is too large:

  • Reduce the date range
  • Select fewer measurement types
  • Export in smaller batches
  • Contact support to increase limits if needed

Missing Data

If expected data is missing from export:

  • Verify date range includes the data period
  • Check that measurement type was selected
  • Ensure devices were reporting during that period
  • Verify permissions for data access

File Not Found

If you can’t find the exported file:

  • Check iCloud Drive > Haltian IoT Studio folder
  • Ensure iCloud Drive is enabled on your device
  • Check Available/Offline status in iCloud
  • Look in Files app > iCloud Drive

Data Privacy and Security

Exported Data Contains

  • Device identifiers
  • Measurements
  • Timestamps
  • Location information
  • Organization data

Handling Exported Data

  • Secure storage: Keep exports in secure locations
  • Access control: Limit who can access exported files
  • Encryption: Consider encrypting sensitive exports
  • Disposal: Securely delete exports when no longer needed

Next Steps