Skip to content

Data Export

Jump to bottom
Christian Beier edited this page Aug 12, 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

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, specimens, journal entries) 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

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