Skip to content

Data Export

Jump to bottom
Christian Beier edited this page Nov 11, 2025 · 6 revisions

Warning

This page is under review and may contain incorrect information.

Xolmis Mobile supports exporting field data in multiple formats to facilitate analysis, reporting, and sharing.

Supported Formats

Format Use Case
CSV Spreadsheet analysis, data import
Excel Rich formatting, multi-sheet exports
JSON Xolmis Desktop interoperability
KML Plot coordinates on a map

Export Services

Each module (e.g., Inventories, Nests) has its own export service located in lib/services/export/.

Example: CSV Export

final csvData = ListToCsvConverter().convert(rows);
final file = await _writeToFile(csvData, 'inventories.csv');

Example: Excel Export

var excel = Excel.createExcel();
Sheet sheet = excel['Nests'];
sheet.appendRow(['Nest ID', 'Species', 'Outcome']);
sheet.appendRow(['001', 'Tyrannus melancholicus', 'Fledged']);

File Storage

  • Files are saved using path_provider to the app’s documents directory.
  • Exported files can be shared via native share sheets or uploaded to cloud storage.

Permissions

Ensure WRITE_EXTERNAL_STORAGE is granted on Android before saving files externally.

Integration with Xolmis Desktop

Xolmis Desktop is a complementary application designed to manage, analyze, and visualize ornithological data collected in the field using Xolmis Mobile.

Workflow

  1. Export from Mobile: Users export data (e.g., inventories, nests, specimens) in JSON format.
  2. Import into Desktop: Xolmis Desktop reads these files and integrates them into its local database for further processing.
  3. Analysis and Reporting: Desktop users can generate reports, perform statistical analysis, and visualize data on maps.

File Compatibility

Mobile Format Desktop Support
.json ✔️ Recommended and fully supported
.csv ✔️ Fully supported
.xlsx ✔️ Supported via spreadsheet parser
.kml ✔️ Supported for points

Benefits

  • Enables offline fieldwork with mobile devices and centralized analysis on desktop.
  • Facilitates collaboration between field researchers and data analysts.
  • Reduces manual transcription and improves data integrity.

Notes

  • Ensure exported files are properly named and structured for seamless import.
  • Future versions may support direct sync between mobile and desktop via shared cloud storage or local network.

Clone this wiki locally