diff --git a/src/gis/photo-names/index.md b/src/gis/photo-names/index.md index a16a1a39..fd555000 100644 --- a/src/gis/photo-names/index.md +++ b/src/gis/photo-names/index.md @@ -6,7 +6,8 @@ Names of the photos that are captured in the field using can b 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. -To set up custom photo names: +## Set up custom photo names + 1. Open your project in QGIS and navigate to **Project Properties** ![QGIS Project Properties](../qgis-project-properties.jpg "QGIS Project Properties") @@ -17,13 +18,17 @@ To set up custom photo names: 3. In the **Expression Dialog** window, enter the expression that should be used as the photo's name. Please, keep in mind [basic recommendations](#best-practice-for-photo-name-expressions) to make sure the naming works as intended. - Here we use a combination of the layer's name, username and current timestamp (other examples ale listed [below](#examples-of-photo-names-expressions)): + Here we use a combination of the layer's name, username and current timestamp (other examples are listed [below](#examples-of-photo-names-expressions)): ` @layer_name + '-' + @mm_username + '-' + format_date(now(),'yyMMddhhmmss')` Example result is displayed in the **Preview**: `hedges-sarah-230707194052` ![QGIS Expression for custom photo name](./plugin-photo-name-expression-builder.jpg "QGIS Expression for custom photo name") + :::warning Do not use special characters in photo names + Special characters in photo names can cause synchronisation issues. Therefore, it is not allowed to use characters such as `|?*"<>`. + ::: + Click **OK** to confirm the expression. 4. Set up the photo name format for other fields and layers. @@ -33,22 +38,24 @@ To set up custom photo names: ![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") ![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") -### Best practice for photo name expressions +## Best practice for photo name expressions There are some tips to keep in mind when creating the expression for your photo name: :white_check_mark: **Each photo needs to have a unique name** to avoid issues during synchronisation and ensure that photos and features are linked correctly. Therefore, we recommend using combinations of variables that will ensure that there would not be multiple photos with the same name, such as the current date and time `now()`, username `@mm_username`, layer name `@layer_name` or a field value. +:no_entry_sign: Avoid using special characters such as `|?*"<>` in the photo name. + :white_check_mark: The file extension (`.jpg`) is added automatically. :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! :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 -: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. +:warning: 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. -:no_entry_sign: The setup needs to be saved and synchronised. Only photos that are taken after synchronisation will have the name defined by the expressions. Existing photos will keep their original names. +:warning: The setup needs to be saved and synchronised. Only photos that are taken after synchronisation will have the name defined by the expressions. Existing photos will keep their original names. In general, it is useful to use some of these variables: - Current timestamp `now()` is a good starting point to ensure uniqueness of the name of the photo. @@ -64,7 +71,7 @@ In general, it is useful to use some of these variables: Depending on the layers in your project and their fields, it can help create a unique photo name when taking multiple pictures in a row. It can also help to make it easier to browse pictures in your project. -### Examples of photo names expressions +## Examples of photo names expressions Here are some example expressions that can be used or modified to fit your needs: - Expression: ` @layer_name + '-' + @mm_username + '-' + format_date(now(),'yyMMddhhmmss')` diff --git a/src/manage/dashboard-maps/index.md b/src/manage/dashboard-maps/index.md index 40c94a51..39010118 100644 --- a/src/manage/dashboard-maps/index.md +++ b/src/manage/dashboard-maps/index.md @@ -15,7 +15,7 @@ Webmaps are **not** available for . On the webmaps, you will see your survey layers or raster layers that are [packaged](../project/#packaging-qgis-project) with the project. Other layers, such as online [background maps](../../gis/settingup_background_map/#background-maps) or PostgreSQL layers are not displayed. The extent of maps is defined by the [extent set in the QGIS project](../../gis/features/#project-extent). -All maps on the use [ vector tile service](../../gis/settingup_background_map/#mergin-maps-vector-tile-service) as a background map. +All maps on the use [ vector tile service](../../gis/settingup_background_map/#online-services-1) as a background map. The content of the maps and of the **Layers** panel is refreshed after every synchronisation of the project. This means you should always see your current spatial data here.