Files won't save, load, import or export

All files access isn't allowed Most likely

Check: While the permission is off, Ditch Assist opens Android's All files access page by itself every time it starts. If you've been tapping Back past that page, this is your problem. There's no storage button inside the app.

Fix, the quick way:

1. Close Ditch Assist fully (how to close an app).
2. Open Ditch Assist again. Android's All files access page opens.
3. Tap the switch next to Allow access to manage all files, on the right. It turns on.
4. Tap the back arrow at the top left. Ditch Assist carries on starting up.

1 2 3

Or from the tablet's Settings app (Samsung):

1. Open the tablet's Settings app.
2. Tap Apps.
3. Tap Ditch Assist.
4. Tap Permissions.
5. Tap Files and media.
6. Choose Allow management of all files.
7. Close Ditch Assist fully and open it again.

On other tablets the setting sits in a different place: in the Settings app, tap Apps, then look for Special app access and, inside it, All files access. The quick way above works on every tablet.

The tablet is full

Check: In the tablet's Settings app, look at the storage. Export failed: … or Save failed: … with the permission allowed usually means no space.

Fix: Free up space (old LiDAR fields and cached imagery take the most) and try again.

Field Mode shows only the active field Most likely

Check: The list says No surveys in … and Tap "All fields" above to see every saved survey.

Fix: Tap All fields, the second choice in the row at the top of the list, next to your field's name. See Field Mode.

1

Storage permission

Fix: See Saves fail, or saved files have disappeared.

It's a contour tile or terrace design

Check: Tapping Implement says Contour tile design — use the wizard or Terrace design — use the wizard.

Fix: These need their survey pieces loaded together, so they open from their own workflow card. If the Connect window opens first, connect and tap Continue. Contour tile design:

1. On the Home screen, tap the Tiling card.
2. Under Tiling Method, tap Contour Tiling.
3. Tap Load Existing Design.

Terrace design:

1. On the Home screen, tap the Terracing card.
2. Under Terracing Method, tap Standard Terracing.
3. Tap Load Surveys and pick the channel and berm surveys. Or tap Resume Job to carry on a job.

A contour tile job you already started also comes back from the Resume button on the Grade screen.

A saved file couldn't be read

Check: The small red text under the message is the technical reason.

Fix:

1. Close the window and open it again.
2. If it keeps failing, write down the red text.
3. Send your logs and call support.

Documents/DitchAssist on the tablet

Check:

1. Open the tablet's My Files app.
2. Tap Documents.
3. Tap DitchAssist. Logs are in logs, LiDAR fields in lidar-fields.

Fix:

1. Plug the tablet into a PC with a USB cable.
2. On the tablet, allow file transfer when it asks.
3. On the PC, copy the whole DitchAssist folder.

To send one survey to design software, use the export (share) button on the survey's row in the Load list: XYZ or KML. See Move files on and off the tablet.

Wrong format Most likely

Check: Open the file in a text editor. The line importers want latitude, longitude, elevation (XYZ), or latitude, longitude, survey elevation, proposed elevation (XYZP), in decimal degrees, separated by tabs, commas, semicolons or spaces. The file needs at least two points with valid coordinates. means fewer than two rows could be read.

Fix: Export again in that layout, for example from Geo-Surface™. Land Forming files: see Land Forming problems.

Wrong workflow

Check: The app says File import is not available for this workflow. Use Ditching, Excavation or Tiling.

Fix: Go to Home, open Ditching, Excavation or Tiling, and import there.

Storage permission or space Most likely

Fix: Check the permission and free space (steps), then export again.

The survey file is damaged

Check: Could not load survey data for export. shows for one survey only, or its preview says No points to display.

Fix: Try another survey. Send logs if a survey you need won't open.

It's a KMZ Most likely

Check: The file name ends in .kmz. Add KML takes .kml files only; other files show greyed out in the picker.

Fix: On a PC, rename the .kmz to .zip, open it, copy out doc.kml and import that.

Nothing in it to draw

Fix: Export the KML again with its lines, points or polygons included.

The world file is missing Most likely

Fix: pick the picture and its world file together.

1. Tap the layers button on the map: the round button with stacked squares, at the bottom right of the map. The Map Layers window opens.
2. Tap + at its top right.
3. Tap Add Image Overlay. The tablet's file picker opens.
4. Press and hold the picture (.jpg) until it's ticked (long-press).
5. Tap its world file (.jgw) so both are ticked. Or pick one .zip that holds both.
6. Tap Select.

1 2

No image file found… means the picture itself wasn't picked.

The world file is in metres

Check: The app says World file uses projected coordinates (UTM/meters). Only WGS84 (EPSG:4326) geographic coordinates are supported. Re-export the world file in lat/lon.

Fix: Export the picture and world file again in WGS84 latitude/longitude.

The file isn't on the tablet itself

Check: The app says Image file not accessible: …

Fix: Copy the files into Downloads on the tablet and pick them from there. See Import a map overlay.

Overlays aren't kept between sessions in v1.5.4

Check: Image overlays (a .jpg/.jgw pair, or a zipped overlay such as an owner-portal map.zip) and KML layers added with the + in Map Layers last until the app closes. LiDAR & Mapping fields and drainage plans are saved and stay.

Fix: Add them again each session. Keep the files in Downloads so they're quick to pick.