You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/layer/checkbox/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ You might want to use the checkbox with custom values, such as Yes/No or On/Off.
39
39
40
40

41
41
42
-
Similarly, you could set up checkbox for fields with integer data types and use numerical values, e.g. `0` and `1`, for the *Checked* and for the *Unchecked* state.
42
+
Similarly, you could set up the checkbox widget for fields with integer data types and use numerical values, e.g. `0` and `1`, for the *Checked* and for the *Unchecked* state.
43
43
44
44
In the <MobileAppNameShort />, the checkbox can be easily toggled on/off.
Copy file name to clipboardExpand all lines: src/layer/conditional-visibility/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ You can explore this functionality in <MerginMapsProject id="documentation/form_
11
11
12
12
Here we will use a line layer named `roads and paths`. It is designed for surveying both roads and paths and most of the fields are relevant for every type of feature in this layer. However, there are some attributes that are specific for roads (e.g. the number of lanes) or for paths (e.g. the visibility of the path).
13
13
14
-
The form uses the value of the `type` field to display the relevant set of attributes. The `type` field is set up as [value map](../value-select/#value-map) with defined values `road` and `path`.
14
+
The form uses the value of the `type` field to display the relevant set of attributes. The `type` field is set up as a [value map](../value-select/#value-map) with defined values `road` and `path`.
15
15
16
16

Copy file name to clipboardExpand all lines: src/layer/default-values/index.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ There are some commonly used default values that can be useful in your field sur
28
28
29
29
- It is convenient to know when a feature was created and when it was last updated. Use fields with **Date** or **Date&Time** data types with the `now()` function to record this information. You can change the formatting using the [Date/Time](../date-time/) widget.
30
30
31
-
- The name of the <MainPlatformName /> user who created or modified the feature can be recorded using the `@mergin_username` variable. These fields should use **Text (string)** data type.
31
+
- The name of the <MainPlatformName /> user who created or modified the feature can be recorded using the `@mm_username` variable. These fields should use **Text (string)** data type.
32
32
There are also other [project and user variables](../variables/#project-and-user-variables) related to your <MainPlatformName /> account or service that can be used as default values.
33
33
34
34
- The coordinates of a point feature can be recorded as well using the `$x` and `$y` function in QGIS. To record the coordinate accurately, these fields should have the **Decimal number (real)** data type. If the coordinates are in metres, values can be rounded to, say, 2-3 decimal places. When working with geographic coordinates that use degrees, you may want to round the coordinates to 8 decimal places. Use the *apply default value on update* option so that you have correct values when the position of the point feature changes.
|`@now`|`2024-06-30 10:00:00`|**no**| The timestamp of when the feature was created. |
46
46
|`@now`|`2024-06-30 10:30:00`|**yes**| The timestamp of when the feature was last **updated**. |
47
-
|`@mergin_username`|`sarah`|**no**| Name of the user who created this feature.|
48
-
|`@mergin_username`|`jack`|**yes**| Name of the user who **updated** this feature last.|
47
+
|`@mm_username`|`sarah`|**no**| Name of the user who created this feature.|
48
+
|`@mm_username`|`jack`|**yes**| Name of the user who **updated** this feature last.|
49
49
|`round($x,2)`|`1898789.92`|**yes**| The X coordinate of a point feature, rounded to 2 decimal places.|
50
50
|`$length`|`123.45`|**yes**| The length of a line feature.|
51
51
|`$area`|`1234.56`|**yes**| The area of a polygon feature.|
@@ -55,14 +55,14 @@ Here are some examples:
55
55
Let's set up an attributes to record the <MainPlatformName /> username of the surveyor who *created* a feature:
56
56
1. Right-click on a layer, select **Properties** and go to the **Attributes form** tab.
57
57
2. In the list of **Available Widgets** select the text field you want to use (here: `inserted_by`)
58
-
3. In the **Defaults** tab, define the **Default value** as `@mergin_username`.
58
+
3. In the **Defaults** tab, define the **Default value** as `@mm_username`.
59
59
Do not check the **Apply default value on update** option :white_large_square:.
60
60
61
61

62
62
63
63
To save the <MainPlatformName /> username of the surveyor who *modified* this feature, the steps are similar:
64
64
1. In the list of **Available Widgets** select the text field you want to use (here: `updated_by`)
65
-
2. In the **Defaults** tab, define the **Default value** as `@mergin_username`.
65
+
2. In the **Defaults** tab, define the **Default value** as `@mm_username`.
66
66
Check the **Apply default value on update** option :heavy_check_mark:. The field will be updated anytime the feature is modified, saving the name of the surveyor who made the changes.
67
67
68
68

Copy file name to clipboardExpand all lines: src/layer/info-widgets/index.md
+1-3Lines changed: 1 addition & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,13 @@ description: HTML and Text widgets are not connected to a specific field of the
7
7
8
8
<QGISHelpver="latest"link="/user_manual/working_with_vector/vector_properties.html#other-widgets"text="QGIS" /> also offers widgets that can be added to the form to display values or text, but are not connected to a specific field of the layer, such as the Text or HTML widget. These widgets are also supported by <MainPlatformName />.
9
9
10
-
HTML and Text widgets can be used, e.g., to [display instructions](../display-instructions/) in the form. The HTML widget supports various [HTML tags](https://doc.qt.io/qt-6/richtext-html-subset.html#supported-tags), so it can also be used, for instance, to display [online images](../embed-image/) or [open local files](../open-file/).
10
+
HTML and Text widgets can be used, e.g., to [display instructions](../display-instructions/) in the form. They can include [expressions and field values](#using-expressions-in-text-and-html-widgets) as well. The HTML widget supports various [HTML tags](https://doc.qt.io/qt-6/richtext-html-subset.html#supported-tags), so it can also be used, for instance, to display [online images](../embed-image/) or [open local files](../open-file/).
11
11
12
12
|<divstyle="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
13
13
|:---:|:---:|
14
14
Text |  |
15
15
HTML Widget |  |
16
16
17
-
The **Text** and **HTML widgets** provide an option to display instructions or tips for surveyors in your attributes forms. They can include [expressions and field values](#using-expressions-in-text-and-html-widgets) as well.
18
-
19
17
These widgets can be found in **Available Widgets** in the **Other Widgets** section when using the [Drag and Drop Designer](../form-layout/#qgis-drag-and-drop-designer). Simply add them to the form layout and double click to configure them as needed.
20
18
21
19

Copy file name to clipboardExpand all lines: src/layer/qr-code/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: A field in the form can be set up for QR code scanning. Scan QR cod
4
4
5
5
# QR code
6
6
7
-
You can scan QR codes with your mobile device to fill in a field in the form. The field data type should match the desired input, so if you want to scan say a link, you need a field with `Text (string)` data type.
7
+
You can scan QR codes with your mobile device to fill in a field in the form. The field data type should match the desired input: if you want to scan, say, a link, you need a field with `Text (string)` data type.
8
8
9
9
|<divstyle="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
Copy file name to clipboardExpand all lines: src/layer/use-cases/index.md
+6-1Lines changed: 6 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,4 +6,9 @@ description: Our step-by-step guides provide detailed descriptions accompanied b
6
6
7
7
Here you can find some common use cases that can help you deal with specific scenarios.
8
8
9
-
Our step-by-step guides provide detailed descriptions accompanied by public <MainPlatformNameLink /> projects you can clone and explore in more detail.
9
+
Our step-by-step guides provide detailed descriptions accompanied by public <MainPlatformNameLink /> projects you can clone and explore in more detail:
10
+
-[How to Open a File](../open-file/) from within the form using the HTML widget or default values
11
+
-[How to Use Hyperlinks](../external-link/) in the form
12
+
-[How to Open a Link to a Navigation App](../link-to-navigation/) from within the form
13
+
-[How to Link Multiple Records to One Feature](../one-to-n-relations/)
14
+
-[How to Embed an Image](../embed-image/) in the form
Copy file name to clipboardExpand all lines: src/layer/variables/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -50,7 +50,7 @@ Following variables are supported:
50
50
-`@position_magnetic_variation` - The angle between the horizontal component of the magnetic field and true north, in degrees. Also known as magnetic declination. A positive value indicates a clockwise direction from true north and a negative value indicates a counter-clockwise direction.
51
51
-`@position_horizontal_accuracy` - The accuracy of the provided latitude-longitude value, in meters.
52
52
-`@position_vertical_accuracy` - The accuracy of the provided altitude value, in meters.
53
-
-`@position_from_gps` - True, if recorder/edited feature's geometry correspond with current user's position (Position marker has the same location as the crosshairs marker).
53
+
-`@position_from_gps` - True, if recorded/edited feature's geometry corresponds with current user's position (Position marker has the same location as the crosshairs marker).
54
54
-`@position_satellites_visible` - Number of visible satellites.
55
55
-`@position_satellites_used` - Number of satellites used to calculate the position.
0 commit comments