Skip to content

Commit 984fdb9

Browse files
committed
data types + removed links in overview tables
1 parent eb3f953 commit 984fdb9

File tree

5 files changed

+13
-13
lines changed

5 files changed

+13
-13
lines changed

src/layer/checkbox/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The checkbox widget is handy when you want to set up a field that can have two v
88

99
|<div style="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
1010
|:---:|:---:|
11-
| [True/false checkbox](#true-false-checkbox-for-boolean-fields) | ![Mergin Maps mobile app numeric field form](./mobile-form-checkbox-preview.webp "Mergin Maps mobile app numeric field form") |
11+
| True/false checkbox | ![Mergin Maps mobile app numeric field form](./mobile-form-checkbox-preview.webp "Mergin Maps mobile app numeric field form") |
1212

1313

1414
:::tip Example project available
@@ -21,7 +21,7 @@ Prefer a video? Here is a short tutorial about the checkbox widget:
2121

2222
## True/false checkbox for Boolean fields
2323

24-
If you have a field with a **Boolean** data type, QGIS assigns the checkbox widget type by default. It is also possible to use it for fields with [other data types](#checkbox-with-custom-values-yes-no).
24+
If you have a field with a `Boolean` data type, QGIS assigns the checkbox widget type by default. It is also possible to use it for fields with [other data types](#checkbox-with-custom-values-yes-no).
2525

2626
1. Right-click on a layer, select **Properties** and go to the **Attributes form** tab.
2727
2. In the list of **Available Widgets** select the field you want to work with (here: `checkbox`).
@@ -31,7 +31,7 @@ If you have a field with a **Boolean** data type, QGIS assigns the checkbox widg
3131
![QGIS checkbox field form](./qgis-form-checkbox.jpg "QGIS checkbox field form")
3232

3333
## Checkbox with custom values (yes/no)
34-
You might want to use the checkbox with custom values, such as Yes/No or On/Off. This is possible for fields with **Text** (string) data type:
34+
You might want to use the checkbox with custom values, such as Yes/No or On/Off. This is possible for fields with `Text (string)` data type:
3535
1. Right-click on a layer, select **Properties** and go to the **Attributes form** tab.
3636
2. In the list of **Available Widgets** select the field you want to work with (here: `checkbox-string`).
3737
3. In the **Widget Type** tab, select the **Checkbox** widget and define values for the *Checked* and for the *Unchecked* state. Here we use `Yes` and `No`.

src/layer/date-time/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ description: Date or Date and Time widgets are used to record date and time, e.g
44

55
# Date and time
66

7-
**Date** or **Date and Time** fields can be used to record date and time. The most common use is to record when a feature was created or updated. This can be done manually or automatically by using [default values](../default-values/).
7+
Fields with `Date` or `Date and Time` data type can be used to record date and time. The most common use is to record when a feature was created or updated. This can be done manually or automatically by using [default values](../default-values/).
88

99
|<div style="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
1010
|:---:|:---:|
11-
|[Date/time](#date-time-widget) |![Mergin Maps mobile app date time field form](./mobile-form-datetime-preview.jpg "Mergin Maps mobile app date time field form") |
11+
|Date/time |![Mergin Maps mobile app date time field form](./mobile-form-datetime-preview.jpg "Mergin Maps mobile app date time field form") |
1212

1313
:::tip Example project available
1414
Various options of setting up Date and Date&Time fields are included in this public project: <MerginMapsProject id="documentation/form-widgets" />. Download or clone it to explore it in more detail.

src/layer/numbers/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ description: See how to set up Editable Range or Range Slider to record numbers
44

55
# Numbers
66

7-
Number fields can be handled by the **Range** widget. Two options are supported by the <MobileAppNameShort />: [editable range](#range) and [slider](#slider).
7+
Number fields can be handled by the **Range** widget that offers two options supported by the <MobileAppNameShort />: [editable range](#range) and [slider](#slider).
88

99
|<div style="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
1010
|:---:|:---:|
11-
| [Editable range](#range) | ![Mergin Maps mobile app numeric field form](./mobile-form-number-editable-preview.jpg "Mergin Maps mobile app numeric field form") |
12-
| [Slider](#slider) | ![Mergin Maps mobile app slider field form](./mobile-form-number-slider-preview.jpg "Mergin Maps mobile app slider field form") |
11+
| Editable range | ![Mergin Maps mobile app numeric field form](./mobile-form-number-editable-preview.jpg "Mergin Maps mobile app numeric field form") |
12+
| Slider | ![Mergin Maps mobile app slider field form](./mobile-form-number-slider-preview.jpg "Mergin Maps mobile app slider field form") |
1313

1414
:::tip Example project available
1515
This public project: <MerginMapsProject id="documentation/form-widgets" /> uses various options for entering numbers. Download or clone it to see this setup.

src/layer/qr-code/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ description: A field in the form can be set up for QR code scanning. Scan QR cod
44

55
# QR code
66

7-
You can scan QR codes with your mobile device to fill in a field in the form.
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.
88

99
|<div style="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
1010
|:---:|:---:|
11-
[QR code or barcode scanner](#qr-code-setup) | ![Mergin Maps mobile app QR code field form](./mobile-form-qrcode-preview.jpg "Mergin Maps mobile app QR code field form") |
11+
QR code or barcode scanner | ![Mergin Maps mobile app QR code field form](./mobile-form-qrcode-preview.jpg "Mergin Maps mobile app QR code field form") |
1212

1313
:::tip Example project available
1414
A QR code field is used in this public project: <MerginMapsProject id="documentation/form-widgets" />. Download or clone it to see this setup.

src/layer/value-select/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,17 @@ description: To select values from a drop-down menu in the form in Mergin Maps m
55
# Selecting Single or Multiple Values
66
[[toc]]
77

8-
Selecting values from a drop-down menu is faster than typing them in manually and it also ensures that there are no typos or spelling variations.
8+
Selecting values from a drop-down menu is faster than typing them in manually and it also ensures that there are no typos or spelling variations. Additionally, it is possible to create [drill-down (cascade) forms](#drill-down-forms), where a value selected in one field can affect the options available in another field.
99

1010
|<div style="width:150px"> Widget </div> |Preview in the <MobileAppNameShort />|
1111
|:---:|:---:|
1212
|[Drop-down menu with predefined values](#value-map) |![Mergin Maps mobile app value map field form](./mobile-form-valuemap-preview.jpg "Mergin Maps mobile app value map field form") |
1313
|[Drop-down menu with values from another table, allowed multiple selection](#value-relation) |![Mergin Maps mobile app value relation field form](./mobile-form-value-relation-preview.jpg "Mergin Maps mobile app value relation field form") |
1414

15-
To select values from a drop-down menu in the form, you can use the [Value Map](#value-map) or [Value Relation](#value-relation) widgets in QGIS. Additionally, it is possible to create [drill-down (cascade) forms](#drill-down-forms), where a value selected in one field can affect the options available in another field.
15+
To select values from a drop-down menu in the form, you can use the Value Map or Value Relation widgets in QGIS. The field data type depends on the values that should be stored in the field, usually `Text (string)` or `Integer`. To [allow multiple selection](#value-relation), the field needs to be of `Text (string)` data type).
1616

1717
The **Value Relation** widget is a bit more complex as it uses another layer (usually a non-spatial table) as a source of values. However, it provides some benefits when compared to the simpler **Value Map** setup, such as:
18-
- Option to select multiple values from the list (in this case, the field needs to be of `text` data type).
18+
- Option to select multiple values from the list
1919
- The table used for the drop-down menu can be edited in the <MobileAppNameShort />. For example, if there is a value missing, you can [create it](../../field/mobile-features/#add-or-edit-non-spatial-features) during the field survey and use it immediately. The *Value Map* options can be managed only through QGIS.
2020
- Searching the values: if you have a large list of values, it will become cumbersome to find the right value. With the *Value Relation* widget, you have the option to search for values in the list in the <MobileAppNameShort />.
2121

0 commit comments

Comments
 (0)