Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 23 additions & 11 deletions src/.vitepress/sidebar/en.js
Original file line number Diff line number Diff line change
Expand Up @@ -112,24 +112,36 @@ export default {
] },
] },
{
text: 'Fieldwork', // required
text: 'Fieldwork with Mergin Maps Mobile App', // required
collapsed: true,
items: [
{ text: 'Mergin Maps Mobile App Interface', link: '/field/mobile-app-ui/' },
{ text: 'Offline Use of Mergin Maps Mobile App', link: '/field/offline-use/' },
{ text: 'External GPS', link: '/field/external_gps/' },
{ text: 'GPS Accuracy', link: '/field/gps_accuracy/' },
{ text: 'Add, Edit, Delete Features',
collapsed: true,
items: [
{ text: 'Adding Features', link: '/field/mobile-features/' },
{ text: 'Editing Features', link: '/field/editing/' },
{ text: 'Deleting Features', link: '/field/deleting/' },
{ text: 'Editing Options', link: '/field/reuse-last-values/' },
]
},
{ text: 'Layers and Features', link: '/field/layers/' },
{ text: 'Position Tracking', link: '/field/tracking/' },
{ text: 'Synchronisation in Mergin Maps Mobile App', link: '/field/autosync/' },
{ text: 'Measurement Tools', link: '/field/measure/' },
{ text: 'Layers in Mergin Maps Mobile App', link: '/field/layers/' },
{ text: 'Filtering', link: '/field/filtering/' },
{ text: 'Map Sketching', link: '/field/map-sketching/' },
{ text: 'Photo Sketching', link: '/field/photo-sketching/' },
{ text: 'How to Add, Edit, Delete Features', link: '/field/mobile-features/' },
{ text: 'How to Reuse Last Entered Values', link: '/field/reuse-last-values/' },
{ text: 'Measurement Tools', link: '/field/measure/' },
{ text: 'Positioning and GPS Configuration',
collapsed: true,
items: [
{ text: 'Field Survey Setup', link: '/field/survey-setup/' },
{ text: 'GPS Accuracy', link: '/field/gps_accuracy/' },
{ text: 'External GPS Connection', link: '/field/external_gps/' },
{ text: 'How to Stake Out Points', link: '/field/stake-out/' },
{ text: 'How to Fix a Broken Project', link: '/field/broken-project/' }
]
},
{ text: 'Offline Use', link: '/field/offline-use/' },
{ text: 'Synchronisation in the Mobile App', link: '/field/autosync/' },
] },
{
text: 'For Developers', // required
Expand Down Expand Up @@ -177,7 +189,7 @@ export default {
collapsed:true,
items: [
{ text: 'Support and Troubleshooting', link: '/misc/troubleshoot/' },
{ text: 'Project fails to sync', link: '/misc/troubleshoot/not_syncing/' },
{ text: 'Project fails to sync', link: '/misc/troubleshoot/not_syncing/' }
] },
{ text: 'Write Documentation', link: '/misc/write-docs/' }
]
Expand Down
19 changes: 16 additions & 3 deletions src/field/broken-project/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,26 @@
---
prev:
text: 'Support and Troubleshooting'
link: '../../misc/troubleshoot/'

next:
text: 'Project fails to sync'
link: '../misc/troubleshoot/not_syncing/'

description: Do you get an error message when trying to open a project or a form in Mergin Maps mobile app? Here is how to resolve some of these issues.
---

# How to Fix a Broken Project
# The Mobile App Fails to Save Changes or Fails to Read Project
[[toc]]

Do you get an error message when trying to open a project or a form in <MobileAppName />? There can be multiple reasons for what went wrong. Here we will try to guide you through some cases you may encounter.
:::danger Outdated content
These issues are related to older versions of the <MobileAppNameShort /> and <QGIS link="" text="QGIS" /> so the content on this page may display outdated versions of <MainPlatformName /> products.

If you are using <MobileAppName /> version 2.5.0 and higher and QGIS version 3.34.0 and higher, you should not encounter these issues.
:::

Note that these issues may be related to an older version of the <MobileAppNameShort /> or <QGIS link="" text="QGIS" /> so the content on this page may display outdated versions of <MainPlatformName /> products.

Do you get an error message when trying to open a project or a form in <MobileAppName />? There can be multiple reasons for what went wrong. Here we will try to guide you through some cases you may encounter.

:::tip Need more help with your issue?
The [Troubleshoot](../../misc/troubleshoot/) page has general troubleshooting tips and describes [support options](../../misc/troubleshoot/#support) that include commercial support, support for subscribed clients or community support.
Expand Down
32 changes: 32 additions & 0 deletions src/field/deleting/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
description: With Mergin Maps mobile app, you can capture and edit points, lines, polygons and non-spatial features in the field using comprehensive editing tools.
outline: deep
---

# Deleting Features

[[toc]]

## Deleting features

1. Tap on a feature on the map or find it through [**Layers**](../../field/layers/)
2. Use the **Edit** button to open the attributes form
3. Tap the **Delete** button and confirm the deletion

After confirming that you want to delete the feature, it will be removed from the layer.

![Delete feature in Mergin Maps mobile app](./mobile-delete-feature.jpg "Delete feature in Mergin Maps mobile app")

## Multi-features deleting
Multiple features can be deleted at once:

1. Select one of the features you want to delete and use the **Select more** button.

Depending on your mobile device, you may need to use a button next to **Edit** to display this option.

2. Select all features that should be deleted on the map

3. Use the **Delete** button to delete all selected features at once

![Delete multiple features in Mergin Maps mobile app](./mobile-delete-bulk.webp "Delete multiple features in Mergin Maps mobile app")

Binary file added src/field/deleting/mobile-active-layer.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-active-layer.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-add-part.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-add-part.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-added-part.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-added-part.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-capture-line.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-capture-line.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-capture-multipoint.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-capture-point.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-capture-point.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-capture-polyline.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-capture-polyline.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-delete-bulk.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-delete-bulk.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-delete-feature.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-delete-feature.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-edit-features.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-edit-features.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-edit-lines.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-edit-lines.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file added src/field/deleting/mobile-edit-streaming.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-edit-streaming.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-non-spatial-layers.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-non-spatial-layers.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-recording-mode-add.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-recording-mode-add.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-redraw-features.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-redraw-features.xcf
Binary file not shown.
Binary file added src/field/deleting/mobile-select-more.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-select-more.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file added src/field/deleting/mobile-split-features.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-split-features.xcf
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/deleting/mobile-streaming-mode-stop.xcf
Binary file not shown.
100 changes: 100 additions & 0 deletions src/field/editing/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
---
description: With Mergin Maps mobile app, you can capture and edit points, lines, polygons and non-spatial features in the field using comprehensive editing tools.
outline: deep
---

# Editing Features

[[toc]]

The <MobileAppNameShort /> can be used to add, edit and delete features in the field by users with [writer or editor permission](../../manage/permissions/) to the <MainPlatformName /> project.

Until the project is synchronised to <MainPlatformNameLink />, all changes are local (stored only on your mobile device). Changes can be [synchronised](../autosync/) manually or automatically.

## Editing features
Tap a feature on the map or *tap and hold* to select one from multiple overlaying features to display the form.

Use the **Edit** button to open the attributes form for editing. To edit the geometry of a feature, tap the **Edit geometry** button.

Once you are finished with your changes, use the **Save** :heavy_check_mark: button.

![Edit attributes and geometry in Mergin Maps mobile app](./mobile-edit-features.jpg "Edit attributes and geometry")

Features can also be browsed, edited and deleted through the [Layers](../layers/) panel. Layers that are set as [read-only](../../gis/enable_digitising/) in the project properties cannot be edited.
- Tap the **Layers** button in the bottom navigation panel and select a layer to see the list of features it contains.
- Select a feature from the list in the **Layers** panel to display its form and edit the values or geometry.

![Layers in Mergin Maps mobile app](./mobile-layers-browse-features.jpg "Layers in Mergin Maps mobile app")

### Editing geometry
There are multiple options of editing the geometry of features depending on the geometry type of the survey layer: editing the vertices, [redrawing](#redraw-geometry) or [splitting](#split-geometry-of-lines-or-areas) features.

To edit geometry of a point feature simply adjust the location in the same manner as when [adding new features](#capture-points).

Layers with MultiPoint, Line, MultiLine, Polygon and MultiPolygon geometries offer more options. Tap a feature, press the **Edit** button and then use **Edit geometry**. The vertices of the feature will be highlighted. You can move, **Release** or **Remove** them as needed. Tap the **Record** button to save the modified geometry.

![Editing line geometry in Mergin Maps mobile app](./mobile-edit-lines.jpg "Editing line geometry in Mergin Maps mobile app")

### Adding part of multipart geometry
Parts can be added to features from survey layers with multipart geometry type (MultiPoint, MultiLine, MultiPolygon) while editing geometry.

Tap the **More option** button while editing geometry and use the **Add part** option.

![Adding geometry part in Mergin Maps mobile app](./mobile-add-part.webp "Adding geometry part in Mergin Maps mobile app")

Capture the part by using the editing tools and **Record** your changes. The part is added to the geometry of the feature.

![Adding geometry part in Mergin Maps mobile app](./mobile-added-part.webp "Adding geometry part in Mergin Maps mobile app")

### Using streaming mode to edit geometry
The [streaming mode](#streaming-mode) can be also used while editing features with compatible geometry type. Tap the **More option** button and use the **Streaming mode**.

![Editing line geometry streaming](./mobile-edit-streaming.jpg "Editing line geometry streaming")

### Redraw geometry
The existing geometry of MultiPoint, Line, MultiLine, Polygon and MultiPolygon geometry can also be redrawn.

Tap the **More option** button and select the **Redraw geometry** option.

Capture the new geometry of the feature using the editing tools or streaming and use the **Record** button to save your changes.

![Redrawing geometry of a line feature](./mobile-redraw-features.jpg "Redrawing geometry of a line feature")

### Split geometry of lines or areas
Lines and areas can be split into two or more new features that will keep the same attributes as the original feature.

Tap the **More option** button and select the **Split geometry** option. Create the splitting line by using the **Add point** button.

When finished, tap **Done**.
![Edit button in Mergin Maps mobile app](./mobile-split-features.jpg "Edit button in Mergin Maps mobile app")

In this case, two individual features are created. Both have the same attributes, except for `Feature ID` (one feature keeps the original id, the other gets a new one).
![Geometry split successfully into two features](./mobile-split-features-complete.jpg "Geometry split successfully into two features")

## Multi-features editing

Attributes of multiple features from the same layer can be edited at once.
![Multi-feature editing in Mergin Maps mobile app](./mobile-multi-feature-editing.gif "Multi-feature editing in Mergin Maps mobile app")

1. Tap on a feature on the map and select the **Select more** option.

Depending on your mobile device, you may need to use a button next to **Edit** to display this option.
![Select more features button in Mergin Maps mobile app](./mobile-select-more.webp "Select more features button in Mergin Maps mobile app" )

2. Select all features that should be edited.

3. In the attributes form, enter the new values of attributes and **Save**.

All selected features have been modified at once.

## Edit non-spatial features
Non-spatial features, such as tables for [value relations](../../layer/value-select/#value-relation), can also be added or edited in the <MobileAppNameShort />.

1. Tap the **Layers** button and select the layer you want to edit
![Mergin Maps mobile app Layers panel](./mobile-non-spatial-layers.jpg "Mergin Maps mobile app Layers panel")

2. Tap an existing feature to change it or tap the **Add feature** button to create a new feature
![Editing non-spatial features in Mergin Maps mobile app](./mobile-edit-non-spatial-layers.jpg "Editing non-spatial features in Mergin Maps mobile app")

3. Fill in the attributes and **Save** :heavy_check_mark: the changes

Binary file added src/field/editing/mobile-active-layer.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/field/editing/mobile-active-layer.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-add-part.webp
Binary file added src/field/editing/mobile-add-part.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-added-part.webp
Binary file added src/field/editing/mobile-added-part.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-capture-line.jpg
Binary file added src/field/editing/mobile-capture-line.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-capture-multipoint.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-capture-point.jpg
Binary file added src/field/editing/mobile-capture-point.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-capture-polyline.webp
Binary file added src/field/editing/mobile-capture-polyline.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-delete-bulk.webp
Binary file added src/field/editing/mobile-delete-bulk.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-delete-feature.jpg
Binary file added src/field/editing/mobile-delete-feature.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-edit-features.jpg
Binary file added src/field/editing/mobile-edit-features.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-edit-lines.jpg
Binary file added src/field/editing/mobile-edit-lines.xcf
Binary file not shown.
Binary file not shown.
Binary file added src/field/editing/mobile-edit-streaming.jpg
Binary file added src/field/editing/mobile-edit-streaming.xcf
Binary file not shown.
Binary file not shown.
Binary file added src/field/editing/mobile-non-spatial-layers.jpg
Binary file added src/field/editing/mobile-non-spatial-layers.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-recording-mode-add.jpg
Binary file added src/field/editing/mobile-recording-mode-add.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-redraw-features.jpg
Binary file added src/field/editing/mobile-redraw-features.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-select-more.webp
Binary file added src/field/editing/mobile-select-more.xcf
Binary file not shown.
Binary file not shown.
Binary file added src/field/editing/mobile-split-features.jpg
Binary file added src/field/editing/mobile-split-features.xcf
Binary file not shown.
Binary file not shown.
Binary file added src/field/editing/mobile-streaming-mode-start.xcf
Binary file not shown.
Binary file added src/field/editing/mobile-streaming-mode-stop.jpg
Binary file added src/field/editing/mobile-streaming-mode-stop.xcf
Binary file not shown.
Loading
Loading