Skip to content
Merged
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
62 changes: 28 additions & 34 deletions src/manage/missing-data/index.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,20 @@
---
description: There are some common techniques to retrieve your data. Resolve conflict files in Mergin Maps folder or retrieve the data from mobile devices manually.

outline: deep
---

# How to Recover Missing Data

[[toc]]

Let's say you synchronise surveyed data from multiple devices (individual surveyors) and when you examine them, you find out there is something missing - new features that were captured in the field or changes made by one or more of your team members.
Let's say you synchronise surveyed data from multiple devices (individual surveyors) and when you examine them, you find out there is something missing - new features that were captured in the field or changes made by one or more of your team members.

The reasons why you didn't get all the data can vary. For instance, the data could not be synchronised correctly because of multiple surveyors editing the same feature or synchronisation of projects with different data schema. You can read more about this topic in [Behind Data Synchronisation](../synchronisation/).

Here we will try to guide you through common techniques that can help you to retrieve your data.

::: warning
::: warning Check internet connection and storage limit
If you cannot synchronise changes, make sure you are connected to the internet and that you have not exceeded your storage limit.
:::

Expand All @@ -24,7 +27,7 @@ If you cannot synchronise changes, make sure you are connected to the internet a
Depending on your data format, you can get something like `survey_polygon (edit conflict, sarah v4).json`, which is a conflict file for data from a user called `sarah`, project version 4.

## There are conflict files in the folder
Conflict files can appear in your project when Mergin could not synchronise changes automatically and they indicate there may be some issues that should be fixed.
Conflict files can appear in your project when <MainPlatformName /> could not synchronise changes automatically and they indicate there may be some issues that should be fixed.

You can add conflict files to your QGIS project and check whether they contain the data you are missing. Then you can resolve them manually or semi-automatically, depending on the scope of your issue.

Expand All @@ -37,7 +40,7 @@ Change the schema of the table in the conflict file to match the new schema and
![QGIS Processing toolbox Detect dataset changes](./qgis-detect-dataset-changes.jpg "QGIS Processing toolbox Detect dataset changes")

## There are no conflict files in the folder
If you don't see any conflict files in your folder, try to download them manually from the mobile device. Surveyed data are stored in the device that was to collect them. So, if you have access to this device, you can download data manually and process them in your computer.
If you don't see any conflict files in your folder, try to download them manually from the mobile device. Surveyed data are stored in the device that was used to collect them. So, if you have access to this device, you can download data manually and process them on your computer.

### Manual data transfer (Android)
Manual data transfer from an Android device can be done by connecting your device to a computer and copying data files to/from the device. Once your Android phone or tablet is recognised by the operating system after connecting it using USB cable, you can use file browser to copy files.
Expand All @@ -46,47 +49,38 @@ You can find the path to your <MainPlatformName /> project folder in the [Diagno

This folder is accessible only from a computer, so you might not see it in your mobile device.

### Manual data transfer (between iOS and Mac)
### Manual data transfer (iOS)
The <MobileAppNameShort /> supports iTunes file sharing. Note that iTunes doesn't allow you to browse or edit data from the app data folder, only allows you to delete or copy the data folder to another location.

You can access your data by following these steps:
Manual data transfer from an iOS device can be done by [connecting your iOS device](https://support.apple.com/en-gb/guide/iphone/iph42d9b3178/18.0/ios/18.0) to a Mac or a Windows computer. On Windows, data can be copied using [iTunes](#using-itunes-macos-windows). On Macs, you can use [iTunes](#using-itunes-macos-windows) or [Finder](#using-finder-macos), depending on your macOS version.

1. Plug iOS device to a computer

2. Open `Finder` file browser
#### Using iTunes (MacOS, Windows)
Detailed steps for general data transfer using `iTunes` can be found on [Apple Support](https://support.apple.com/en-us/120403).

3. Go to Locations and select your `<device_name>`
![Plugged iOS device Locations iTunes](./itunes.jpg "iTunes iOS device plugged to a computer")

4. Click on the tab named `files`

5. Select `Input` app from a list to see a data folder
![Mergin Maps mobile app files accessed through iTunes](./itunes2.jpg "Mergin Maps mobile app files accessed through iTunes")
1. Connect the iOS device to your computer via USB cable
2. Open iTunes and click on the smartphone icon in the toolbar
![iTunes phone icon](./ios_itunes.jpg "iTunes phone icon")

6. Drag-and-drop the `INPUT` folder to another location to see the content
3. Navigate to **File Sharing** in the left panel. As the <MobileAppName /> supports file sharing, it will be listed here.

### Manual data transfer (between iOS and Windows)
Here are the steps to transfer the data from iPhone/iPad to a Windows PC.
4. In **Apps**, select **<MainPlatformName />**. In <MainPlatformName /> Documents, there will be a folder named `INPUT` that contains data from the <MobileAppNameShort />.

1. Make sure you have installed [iTunes](https://support.apple.com/en-us/HT210384)
8. Press **Save...** or drag-and-drop the `INPUT` folder to a location on your computer to copy the data.
![iTunes save Mergin Maps mobile app files](./ios_itunes_merginmaps.jpg "iTunes save Mergin Maps mobile app files")

2. Sign into iTunes
#### Using Finder (MacOS)
Detailed steps for general data transfer using `Finder` can be found on [Apple Support](https://support.apple.com/en-us/119585).

3. [Connect your iOS device to the PC](https://support.apple.com/en-gb/guide/iphone/iph42d9b3178/15.0/ios/15.0) and unlock the screen
You can access your data using `Finder`:

4. In iTunes, click on the phone icon in the toolbar
![iTunes phone icon](./ios_win_itunes.jpg "iTunes phone icon")

5. From the left panel, select **File Sharing**

6. Select **Input** in Apps tab

7. Under Input Documents, select **INPUT** folder

8. Press **Save...**
![iTunes save Mergin Maps mobile app files](./ios_win_itunes_input.jpg "iTunes save Mergin Maps mobile app files")
1. Connect the iOS device to your computer via USB cable
2. Open `Finder` file browser
3. In **Locations**, select your device and click on the **Files** tab. As the <MobileAppName /> supports file sharing, it will be listed here.
4. Select **<MainPlatformName />** from the list. There will be a folder named `INPUT` that contains data from the <MobileAppNameShort />.

9. Select a path to save the folder on your computer.
Drag-and-drop the `INPUT` folder to a location on your computer to copy the data.

![Mergin Maps mobile app files accessed through iTunes](./itunes2.jpg "Mergin Maps mobile app files accessed through iTunes")

## Next steps
If you were not able to solve your problem, you can contact the [support](../../misc/troubleshoot/#support) or get [diagnostic logs](../../misc/troubleshoot/#diagnostic-logs) to inspect the issues thoroughly.
Expand Down
Binary file added src/manage/missing-data/ios_itunes.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 removed src/manage/missing-data/ios_win_itunes.jpg
Binary file not shown.
Binary file removed src/manage/missing-data/ios_win_itunes_input.jpg
Binary file not shown.
Binary file removed src/manage/missing-data/ios_win_itunes_input.xcf
Binary file not shown.
Binary file removed src/manage/missing-data/itunes.jpg
Binary file not shown.
Binary file removed src/manage/missing-data/itunes.xcf
Binary file not shown.
Binary file modified src/manage/missing-data/itunes2.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 modified src/manage/missing-data/itunes2.xcf
Binary file not shown.
Loading