Merge pull request #366 from opengisch/QF-3064-Code-scan-functionality

Added Code scan functionality in doc.
opengisch · Aug 25, 2023 · be64155 · be64155
2 parents cea71d6 + 423eb14
commit be64155
Show file tree

Hide file tree

Showing 8 changed files with 28 additions and 0 deletions.
diff --git a/documentation/assets/images/digitizing-with-qr-code-1-attribute-form.png b/documentation/assets/images/digitizing-with-qr-code-1-attribute-form.png
diff --git a/documentation/assets/images/digitizing-with-qr-code-2-selecting-scan-code.png b/documentation/assets/images/digitizing-with-qr-code-2-selecting-scan-code.png
diff --git a/documentation/assets/images/digitizing-with-qr-code-3-code-reader.png b/documentation/assets/images/digitizing-with-qr-code-3-code-reader.png
diff --git a/documentation/assets/images/digitizing-with-qr-code-4-it-worked.png b/documentation/assets/images/digitizing-with-qr-code-4-it-worked.png
diff --git a/documentation/assets/images/search-bar-code-reader-1-scanning.png b/documentation/assets/images/search-bar-code-reader-1-scanning.png
diff --git a/documentation/assets/images/search-bar-code-reader-2-results.png b/documentation/assets/images/search-bar-code-reader-2-results.png
diff --git a/documentation/how-to/digitize.en.md b/documentation/how-to/digitize.en.md
@@ -57,6 +57,22 @@ to edit attribute values for the newly-added feature.
     You can supress the attribute form upon feature addition via a configuration option
     for a given layer via its properties dialog in QGIS
 
+Moreover, you have the option to digitize the form using the scanning QR or Bar Code reader functionality available within the feature form's text edit widget.
+
+!![](../assets/images/digitizing-with-qr-code-1-attribute-form.png)
+
+Upon clicking the three-dot icon button, a menu will be presented offering three distinct actions: "Copy," "Paste," and "Scan Code".
+
+!![](../assets/images/digitizing-with-qr-code-2-selecting-scan-code.png)
+
+Opting for the "Scan Code" action will trigger QField's code reader, initiating the scanning process to decode the code.
+
+!![](../assets/images/digitizing-with-qr-code-3-code-reader.png)
+
+Once the codes have been successfully scanned, users can validate their choice by clicking the checkmark (✔️) OK button. This action will populate the attribute with the decoded value, streamlining the digitization process.
+
+!![](../assets/images/digitizing-with-qr-code-4-it-worked.png)
+
 #### Remember attribute values
 
 For quick collection of rather homogeneus datasets, it is crucial to not

diff --git a/documentation/how-to/search.en.md b/documentation/how-to/search.en.md
@@ -22,6 +22,18 @@ start the search.
 
 !![image](../assets/images/search-bar.png)
 
+Additionally, you have the option to employ the code scan functionality for this purpose.
+
+When click on the "Scan code" will trigger QField's code reader, initiating the scanning process to decode the code.
+
+!![image](../assets/images/search-bar-code-reader-1-scanning.png)
+
+Once you are content with the scanned information, you can simply click on the checkmark (✔️) OK button to initiate a search for that specific string(In this example, the code corresponds to a user identifier that is associated with various features in a project dataset).
+
+!![image](../assets/images/search-bar-code-reader-2-results.png)
+
+For distinct outcomes, is recommend encoding your feature UUIDs. This will allow us to promptly locate the relevant items.
+
 Matching features will show in the results list offering you two possible
 actions :