Using the Canvas¶
The Canvas is the visual way to build a GeoJibe workflow.
It is the default when you are signed in. If you are not signed in, use the Classic wizard on the home page instead.
Open the Canvas¶
Sign in and go to Create.
The subtitle says Start with a source from Components until you add data.
Components¶
Click Components to open the palette. It has three groups:
- Sources — Upload, URL, S3, ArcGIS, QFieldCloud, Mergin Maps
- Processing — Transform, Python, Convert, and Sync when field-data sync is enabled
- Destinations — Download, PostGIS, S3, SFTP, GeoServer, GeoNode
Drag a component onto the canvas, or click it to add it.
A workflow has one Source, one Destination, and at most one of each processing component.
Add a Source¶
Start with where the data comes from.
For a file on your computer, add Upload. Drop a file onto the canvas, or choose Choose a file.
For other Sources, click the card and fill in Properties. URL, S3, and ArcGIS need Import before fields and layers are available.
QFieldCloud and Mergin Maps are for Sync Jobs, not ordinary conversion. See Sync QFieldCloud with PostGIS.
Add optional processing¶
Add only what you need:
- Convert — format and CRS
- Transform — fields and filters
- Python — a custom script
Click a card to edit it in Properties. Click the canvas background to deselect.
Transform and Python cards include a × to remove that step.
Note
Transform is optional. If your data is already how you want it, you can go directly to the Destination.
Add a Destination¶
Choose where the finished data should go.
Download does not need a saved connection.
PostGIS, S3, SFTP, GeoServer, and GeoNode usually use a saved Destination. Pick it in Properties, then fill in the table, object key, path, or layer for this run.
Configured vs not configured¶
Each card shows a status:
| Status | Meaning |
|---|---|
| Configured | Ready to run |
| Not configured | Something is still missing |
| Running | GeoJibe is working |
| Error / Needs attention | Check Properties |
Connectors between cards are drawn for you. You do not draw the lines.
Run¶
Click Run.
If the Destination is Download, a Download button appears when the result is ready.
Save as Job¶
Save as Job is optional.
Use it when you want to run the same workflow again or put it on a schedule.
The canvas subtitle says Run this conversion without saving. Save as Job is optional.
Sync is different: Sync requires saving as a Job.
Clear canvas¶
Clear canvas removes the Source, processing, Destination, and unsaved settings. It asks for confirmation first.
Classic wizard¶
The Canvas and Classic wizard are two ways to configure the same kind of workflow.
From the Canvas, click Classic wizard (or Classic editor when you are editing a Job). From Classic, click Canvas to return.
Classic walks through Inspect, Prepare, Transform, Convert, and Destination. When you are not signed in, Classic is the whole experience, Python is hidden, and Download is the only Destination.
For day-to-day work after you sign in, stay on the Canvas.