Skip to content

Commit 9885747

Browse files
authored
Configure Survey Layer section - mobile app redesign (#495)
* layer-folder cleanup REDIRECTS * update pics mobile qgis forms widgets * redesign form config * form config default values, constraints * drill down forms * form config * attributes form layout - new prj update
1 parent d21c28f commit 9885747

File tree

271 files changed

+643
-560
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

271 files changed

+643
-560
lines changed

REDIRECTS

Lines changed: 27 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ https://help.inputapp.io/howto/data_sync https://merginmaps.com/docs/manage/plug
5858
https://help.inputapp.io/howto/datum_shift https://merginmaps.com/docs/gis/projections/
5959
https://help.inputapp.io/howto/enable_browsing https://merginmaps.com/docs/gis/search_data/
6060
https://help.inputapp.io/howto/enable_digitizing https://merginmaps.com/docs/gis/enable_digitising/
61-
https://help.inputapp.io/howto/exif_metadata https://merginmaps.com/docs/layer/exif_metadata/
61+
https://help.inputapp.io/howto/exif_metadata https://merginmaps.com/docs/layer/exif/
6262
https://help.inputapp.io/howto/external_gps https://merginmaps.com/docs/field/external_gps/
6363
https://help.inputapp.io/howto/gps_accuracy https://merginmaps.com/docs/field/gps_accuracy/
6464
https://help.inputapp.io/howto/package_qgis_project https://merginmaps.com/docs/manage/create-project/
@@ -74,23 +74,23 @@ https://help.inputapp.io/howto/selective_sync#get-started N/A See redirect for U
7474
https://help.inputapp.io/howto/settingup_background_map https://merginmaps.com/docs/gis/settingup_background_map/
7575
https://help.inputapp.io/howto/settingup_background_map_rastertile https://merginmaps.com/docs/gis/settingup_background_map/
7676
https://help.inputapp.io/howto/settingup_background_map_vectortile https://merginmaps.com/docs/gis/settingup_background_map/
77-
https://help.inputapp.io/howto/settingup_forms https://merginmaps.com/docs/layer/settingup_forms/
78-
https://help.inputapp.io/howto/settingup_forms_cascade https://merginmaps.com/docs/layer/settingup_forms/
79-
https://help.inputapp.io/howto/settingup_forms_checkbox https://merginmaps.com/docs/layer/settingup_forms/
80-
https://help.inputapp.io/howto/settingup_forms_constraints https://merginmaps.com/docs/layer/settingup_forms/
81-
https://help.inputapp.io/howto/settingup_forms_datetime https://merginmaps.com/docs/layer/settingup_forms/
82-
https://help.inputapp.io/howto/settingup_forms_defaults https://merginmaps.com/docs/layer/settingup_forms/
83-
https://help.inputapp.io/howto/settingup_forms_layout https://merginmaps.com/docs/layer/settingup_forms/
84-
https://help.inputapp.io/howto/settingup_forms_number https://merginmaps.com/docs/layer/settingup_forms/
85-
https://help.inputapp.io/howto/settingup_forms_one-to-many https://merginmaps.com/docs/layer/settingup_forms/
86-
https://help.inputapp.io/howto/settingup_forms_photos https://merginmaps.com/docs/layer/settingup_forms/
87-
https://help.inputapp.io/howto/settingup_forms_qrcode https://merginmaps.com/docs/layer/settingup_forms/
88-
https://help.inputapp.io/howto/settingup_forms_slider https://merginmaps.com/docs/layer/settingup_forms/
89-
https://help.inputapp.io/howto/settingup_forms_text https://merginmaps.com/docs/layer/settingup_forms/
90-
https://help.inputapp.io/howto/settingup_forms_valuemap https://merginmaps.com/docs/layer/settingup_forms/
91-
https://help.inputapp.io/howto/settingup_forms_valuerelation https://merginmaps.com/docs/layer/settingup_forms/
77+
https://help.inputapp.io/howto/settingup_forms https://merginmaps.com/docs/layer/form-widgets/
78+
https://help.inputapp.io/howto/settingup_forms_cascade https://merginmaps.com/docs/layer/form-configuration/
79+
https://help.inputapp.io/howto/settingup_forms_checkbox https://merginmaps.com/docs/layer/form-widgets/
80+
https://help.inputapp.io/howto/settingup_forms_constraints https://merginmaps.com/docs/layer/form-configuration/
81+
https://help.inputapp.io/howto/settingup_forms_datetime https://merginmaps.com/docs/layer/form-widgets/
82+
https://help.inputapp.io/howto/settingup_forms_defaults https://merginmaps.com/docs/layer/form-configuration/
83+
https://help.inputapp.io/howto/settingup_forms_layout https://merginmaps.com/docs/layer/form-layout/
84+
https://help.inputapp.io/howto/settingup_forms_number https://merginmaps.com/docs/layer/form-widgets/
85+
https://help.inputapp.io/howto/settingup_forms_one-to-many https://merginmaps.com/docs/layer/one-to-n-relations/
86+
https://help.inputapp.io/howto/settingup_forms_photos https://merginmaps.com/docs/layer/photos/
87+
https://help.inputapp.io/howto/settingup_forms_qrcode https://merginmaps.com/docs/layer/form-widgets/
88+
https://help.inputapp.io/howto/settingup_forms_slider https://merginmaps.com/docs/layer/form-widgets/
89+
https://help.inputapp.io/howto/settingup_forms_text https://merginmaps.com/docs/layer/form-widgets/
90+
https://help.inputapp.io/howto/settingup_forms_valuemap https://merginmaps.com/docs/layer/form-widgets/
91+
https://help.inputapp.io/howto/settingup_forms_valuerelation https://merginmaps.com/docs/layer/form-widgets/
9292
https://help.inputapp.io/howto/setup_themes https://merginmaps.com/docs/gis/setup_themes/
93-
https://help.inputapp.io/howto/working_with_nonspatial_data https://merginmaps.com/docs/layer/working_with_nonspatial_data/
93+
https://help.inputapp.io/howto/working_with_nonspatial_data https://merginmaps.com/docs/layer/non-spatial-data/
9494
https://help.inputapp.io/input_ui https://merginmaps.com/docs/field/mobile-app-ui/
9595
https://help.inputapp.io/licensing https://merginmaps.com/docs/misc/licensing/
9696
https://help.inputapp.io/privacy N/A -- handled by https://merginmaps.com/privacy-policy/
@@ -127,7 +127,7 @@ https://merginmaps.com/docs/howto/create-project/ https://merginmaps.com/docs/ma
127127
https://merginmaps.com/docs/howto/customapp/ https://merginmaps.com/docs/dev/customapp/
128128
https://merginmaps.com/docs/howto/data_sync/ https://merginmaps.com/docs/manage/plugin/
129129
https://merginmaps.com/docs/howto/dbsync/ https://merginmaps.com/docs/dev/dbsync/
130-
https://merginmaps.com/docs/howto/exif_metadata/ https://merginmaps.com/docs/layer/exif_metadata/
130+
https://merginmaps.com/docs/howto/exif_metadata/ https://merginmaps.com/docs/layer/exif/
131131
https://merginmaps.com/docs/howto/external_gps/ https://merginmaps.com/docs/field/external_gps/
132132
https://merginmaps.com/docs/howto/gps_accuracy/ https://merginmaps.com/docs/field/gps_accuracy/
133133
https://merginmaps.com/docs/howto/input_features/ https://merginmaps.com/docs/field/mobile-features/
@@ -160,14 +160,19 @@ https://merginmaps.com/docs/howto/project/features/ https://merginmaps.com/docs/
160160
https://merginmaps.com/docs/howto/project/search_data/ https://merginmaps.com/docs/gis/search_data/
161161
https://merginmaps.com/docs/howto/project/selective_sync/ https://merginmaps.com/docs/manage/selective_sync/
162162
https://merginmaps.com/docs/howto/project/settingup_background_map/ https://merginmaps.com/docs/gis/settingup_background_map/
163-
https://merginmaps.com/docs/howto/project/settingup_forms/ https://merginmaps.com/docs/layer/settingup_forms/
164-
https://merginmaps.com/docs/howto/project/settingup_forms_photo/ https://merginmaps.com/docs/layer/settingup_forms_photo/
165-
https://merginmaps.com/docs/howto/project/settingup_forms_settings/ https://merginmaps.com/docs/layer/settingup_forms_settings/
163+
https://merginmaps.com/docs/howto/project/settingup_forms/ https://merginmaps.com/docs/layer/form-widgets/
164+
https://merginmaps.com/docs/howto/project/settingup_forms_photo/ https://merginmaps.com/docs/layer/photos/
165+
https://merginmaps.com/docs/howto/project/settingup_forms_settings/ https://merginmaps.com/docs/layer/form-configuration/
166166
https://merginmaps.com/docs/howto/project/setup_themes/ https://merginmaps.com/docs/gis/setup_themes/
167-
https://merginmaps.com/docs/howto/project/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/working_with_nonspatial_data/
167+
https://merginmaps.com/docs/howto/project/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/non-spatial-data/
168168
https://merginmaps.com/docs/howto/quick-start/ https://merginmaps.com/docs/tutorials/capturing-first-data/
169169
https://merginmaps.com/docs/howto/reuse_last_values/ https://merginmaps.com/docs/field/reuse-last-values/
170170
https://merginmaps.com/docs/howto/sign-up-to-mergin-maps/ https://merginmaps.com/docs/setup/sign-up-to-mergin-maps/
171+
https://merginmaps.com/docs/layer/exif_metadata/ https://merginmaps.com/docs/layer/exif/
172+
https://merginmaps.com/docs/layer/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/non-spatial-data/
173+
https://merginmaps.com/docs/layer/settingup_forms/ https://merginmaps.com/docs/layer/form-widgets/
174+
https://merginmaps.com/docs/layer/settingup_forms_photo/ https://merginmaps.com/docs/layer/photos/
175+
https://merginmaps.com/docs/layer/settingup_forms_settings/ https://merginmaps.com/docs/layer/form-configuration/
171176
https://merginmaps.com/docs/manage/data_sync/ https://merginmaps.com/docs/manage/plugin/
172177
https://merginmaps.com/docs/manage/plugin-sync-project/ https://merginmaps.com/docs/manage/plugin/
173178
https://merginmaps.com/docs/misc/privacy/ N/A -- handled by https://merginmaps.com/privacy-policy/

src/.vuepress/sidebar/en.js

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -71,15 +71,15 @@ module.exports = {
7171
sidebarDepth: 0, // optional, defaults to 1
7272
children: [
7373
'/layer/best-practice/',
74-
'/layer/settingup_forms',
75-
'/layer/settingup_forms_settings',
74+
'/layer/form-widgets/',
75+
'/layer/form-configuration/',
7676
'/layer/form-layout/',
77-
'/layer/exif_metadata',
78-
'/layer/settingup_forms_photo',
77+
'/layer/photos/',
7978
'/layer/attach-multiple-photos-to-features/',
8079
'/layer/one-to-n-relations/',
80+
'/layer/exif/',
8181
'/layer/external-link/',
82-
'/layer/working_with_nonspatial_data',
82+
'/layer/non-spatial-data/',
8383
'/layer/position_variables',
8484
'/layer/plugin-variables'
8585
]

src/field/external_gps/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ If GPS antenna height is set to a non-zero value, it is also displayed next to t
2929
![GPS antenna height setup in Mergin Maps mobile app](./mobile-app-gps-antenna-height.jpg "GPS antenna height setup in Mergin Maps mobile app")
3030

3131
:::tip
32-
GPS antenna height can be recorded during the survey by using the [extra position variable](../../layer/position_variables/) `@position_gps_antenna_height` as a [default value](../../layer/settingup_forms_settings/#default-values).
32+
GPS antenna height can be recorded during the survey by using the [extra position variable](../../layer/position_variables/) `@position_gps_antenna_height` as a [default value](../../layer/form-configuration/#default-values).
3333
:::
3434

3535
## External GPS on Android

src/field/mobile-features/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Surveyed features are added to the active layer, which is shown just above the b
3333
Once the geometry of a feature is recorded, a form will open and you will be able to record the values of attributes.
3434

3535
:::tip
36-
Attribute forms can be set up in QGIS. For more details, see [Setting Up Form Widgets](../../layer/settingup_forms/) and [Advanced Form Configuration](../../layer/settingup_forms_settings/).
36+
Attribute forms can be set up in QGIS. For more details, see [Setting Up Form Widgets](../../layer/form-widgets/) and [Advanced Form Configuration](../../layer/form-configuration/).
3737
:::
3838

3939
### Capture points
@@ -68,7 +68,7 @@ The recording interval can be defined also in metres as distance travelled.
6868
:::
6969

7070
### Add non-spatial features
71-
[Non-spatial features](../../layer/working_with_nonspatial_data/) can also be added using <MobileAppName />. If you are using a non-spatial table for [value relations](../../layer/settingup_forms/#value-relation) you can add and edit values in the app.
71+
[Non-spatial features](../../layer/non-spatial-data/) can also be added using <MobileAppName />. If you are using a non-spatial table for [value relations](../../layer/form-widgets/#value-relation) you can add and edit values in the app.
7272

7373
1. Tap the **More** button and navigate to **Layers**
7474
![Mergin Maps mobile app Layers panel](./input-layers.jpg "Mergin Maps mobile app Layers panel")

src/field/tracking/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Tracking needs to be enabled in QGIS when [preparing your <MainPlatformName /> p
2121

2222
4. Don't forget to save and synchronise your project!
2323

24-
Enabled tracking means that a new line layer for tracking will be created in your <MainPlatformName /> project called `tracking_layer.gpkg`. This layer is created with a set of fields with set up [default values](../../layer/settingup_forms_settings/#default-values):
24+
Enabled tracking means that a new line layer for tracking will be created in your <MainPlatformName /> project called `tracking_layer.gpkg`. This layer is created with a set of fields with set up [default values](../../layer/form-configuration/#default-values):
2525

2626

2727
| Field name | Data Type | Default variable | Description |
@@ -31,7 +31,7 @@ Enabled tracking means that a new line layer for tracking will be created in you
3131
| `total_distance` | Real | `$length` | Tracked distance |
3232
| `tracked_by` | String | `@mergin_username` | Name of the current <MainPlatformNameLink /> user |
3333

34-
You can add new fields as needed, however, they should be set up with automatically generated [default values](../../layer/settingup_forms_settings/#default-values) as <MobileAppName /> will not open the form for manual inputs. You may use some of the QGIS functions, [extra position variables](../../layer/position_variables/) or [extra QGIS variables](../../layer/plugin-variables/).
34+
You can add new fields as needed, however, they should be set up with automatically generated [default values](../../layer/form-configuration/#default-values) as <MobileAppName /> will not open the form for manual inputs. You may use some of the QGIS functions, [extra position variables](../../layer/position_variables/) or [extra QGIS variables](../../layer/plugin-variables/).
3535

3636
## Using position tracking in Mergin Maps mobile app
3737

src/gis/features.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Various online and offline maps can be used as background layers for navigation
2323
- Define the <QGISHelp ver="3.22" link="user_manual/introduction/qgis_configuration.html?highlight=properties#data-sources-properties" text="layers capabilities" /> in the **Data Sources** in Project Properties.
2424
- [Identifiable](./search_data/#setting-identifiable-layers-in-qgis-project) layers can be queried in <MobileAppName />. If you want to be able to search for attribute values in a layer, it needs to be identifiable and searchable.
2525
- **read-only** layers cannot be modified. If a vector layer is not intended to be used as a survey layer, set it as read-only.
26-
- [non-spatial](../layer/working_with_nonspatial_data/) layers need to be set as searchable to enable browsing, searching, or editing.
26+
- [non-spatial](../layer/non-spatial-data/) layers need to be set as searchable to enable browsing, searching, or editing.
2727

2828
![QGIS Layer Capabilities](./qgis_project_properties.jpg "QGIS Layer Capabilities")
2929

@@ -53,7 +53,7 @@ To set the project extent:
5353
<SinceBadge type="Plugin" version="2022.3.2" /><SinceBadge type="App" version="1.5.1" />
5454
The quality of photographs and pictures that are saved in the <MainPlatformName /> project can be set up in the **<MainPlatformName />** tab in **Project properties**. When pictures are added using <MobileAppName /> (uploaded or taken with the camera), they will be resized accordingly.
5555

56-
By default, the quality is set to *Original* - the original pictures are stored. If you want to resize the pictures, you can choose from *High*, *Medium*, or *Low* quality. The [EXIF metadata](../layer/exif_metadata/) of the original files are kept.
56+
By default, the quality is set to *Original* - the original pictures are stored. If you want to resize the pictures, you can choose from *High*, *Medium*, or *Low* quality. The [EXIF metadata](../layer/exif/) of the original files are kept.
5757

5858
Don't forget to save and sync your project!
5959

@@ -105,7 +105,7 @@ Vector layers can be used as survey layers in <MobileAppName />. You can apply s
105105
The same symbology as defined in the QGIS project will be used in <MobileAppName />. However, <MobileAppName /> does not include all the SVG markers that are available within QGIS. Therefore, if you are using SVG markers for your layer styling, ensure those are copied to the project folder.
106106

107107
### Forms
108-
During the field survey, it is often necessary to fill out some attributes in the form to record the properties of surveyed features. Forms can make the survey easier, consistent and more effective. Detailed description of form widgets and form configuration can be found in [Setting Up Form Widgets](../layer/settingup_forms/) and [Advanced Form Configuration](../layer/settingup_forms_settings/)
108+
During the field survey, it is often necessary to fill out some attributes in the form to record the properties of surveyed features. Forms can make the survey easier, consistent and more effective. Detailed description of form widgets and form configuration can be found in [Setting Up Form Widgets](../layer/form-widgets/) and [Advanced Form Configuration](../layer/form-configuration/).
109109

110110
### Settings for Mergin Maps mobile app preview panel
111111
What appears in the <MobileAppName /> preview panel can be defined in the **Display** tab in **Layer Properties**:

src/gis/photo-names/index.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
# How to Set Photo Names Format
2-
<SinceBadge type="Plugin" version="2023.2.0" /> <SinceBadge type="App" version="v2.2.0" />
3-
2+
<SinceBadge type="Plugin" version="2023.2.0" />
43
[[toc]]
54

65
Names of the photos that are captured in the field using <MobileAppName /> can be customised. The name format can be set in QGIS with <QGISPluginName />.
76

8-
To use this option, make sure that the [photo widget](../../layer/settingup_forms_photo/#attachment-widget-in-qgis) of the fields you use for taking pictures is set up correctly, i.e. using the attachment widget, storing relative paths and, if needed, with a [custom folder](../../layer/settingup_forms_photo/#how-to-set-up-a-custom-folder-for-storing-photos) for storing photos.
7+
To use this option, make sure that the [photo widget](../../layer/photos/) of the fields you use for taking pictures is set up correctly, i.e. using the attachment widget, storing relative paths and, if needed, with a [custom folder](../../layer/photos/#how-to-set-up-a-custom-folder-for-storing-photos) for storing photos.
98

109
To set up custom photo names:
1110
1. Open your <MainPlatformNameLink /> project in QGIS and navigate to **Project Properties**
@@ -29,7 +28,7 @@ To set up custom photo names:
2928

3029
4. Set up the photo name format for other fields and layers.
3130

32-
The **Preview** in **Mergin Maps** tab includes the [custom folder for photos](../../layer/settingup_forms_photo/#how-to-set-up-a-custom-folder-for-storing-photos), if you have set it up. Otherwise you will see only the sample name of a photo.
31+
The **Preview** in **Mergin Maps** tab includes the [custom folder for photos](../../layer/photos/#how-to-set-up-a-custom-folder-for-storing-photos), if you have set it up. Otherwise you will see only the sample name of a photo.
3332

3433
![Mergin Maps QGIS Plugin photo name setup with custom folder](./plugin-photo-name-format-folder.jpg "Mergin Maps QGIS Plugin photo name setup with custom folder")
3534
![Mergin Maps QGIS Plugin Custom photo name setup without custom folder](./plugin-photo-name-format.jpg "Mergin Maps QGIS Plugin Custom photo name setup without custom folder")
@@ -43,9 +42,9 @@ Therefore, we recommend using combinations of variables that will ensure that th
4342

4443
:white_check_mark: The file extension (`.jpg`) is added automatically.
4544

46-
:white_check_mark: When using a field value in the expression, make sure that it is a field that will be filled out during the survey, e.g. by using [constraints](../../layer/settingup_forms_settings/#constraints). If the field is empty, the expression won't work!
45+
:white_check_mark: When using a field value in the expression, make sure that it is a field that will be filled out during the survey, e.g. by using [constraints](../../layer/form-configuration/#constraints). If the field is empty, the expression won't work!
4746

48-
:white_check_mark: If you want to use a [numeric field](../../layer/settingup_forms/#numbers) or other non-text fields in your expression, you need to convert it to a string first using the `to_string()` function
47+
:white_check_mark: If you want to use a [numeric field](../../layer/form-widgets/#numbers) or other non-text fields in your expression, you need to convert it to a string first using the `to_string()` function
4948

5049
:no_entry_sign: The expression is evaluated with the **current** field values. The name of the photo will stay the same even if you change the value of the field later.
5150

0 commit comments

Comments
 (0)