3.2 updates

content/capture-app/android-specific-features.md

@@ -57,7 +57,7 @@ If the user forgets the PIN number, log in by entering the credentials is also a
 
 ![](resources/images/capture-app-image65.png){width=25%}
 
-## Biometrics login (Improved 3.1.0) { #capture_app_generic_biometrics_login }
+## Biometrics login { #capture_app_generic_biometrics_login }
 
 User is able to use the fingerprint scanner or face id if the feature is activated in the device. This will only be available if there is only one account (not supported for multple accounts)
 
@@ -297,7 +297,7 @@ The user can now enter aggregate data for an organisation Unit, a period and a s
 ![](resources/images/capture-app-image92.png){ width=25%}
 
 
-## Home (Improved 3.1.0) {#capture_app_home}
+## Home {#capture_app_home}
 
 The home screen of the DHIS2 Android App shows the list of programs and data sets available for the user. The first thing the user does when collecting data in this case is to select the program or data set to work with.
 

content/capture-app/datasets-features.md

@@ -1,73 +1,80 @@
 # Data sets { #capture_app_datsets }
 
-### Data Entry {#capture_app_data_sets_data_entry}
+### Data Entry (Improved 3.2.0) {#capture_app_data_sets_data_entry}
 
-While entering data the new text input dialog opens an input field above the keyboard which shows the Data Element name, and category options of the field being selected, ensuring the user does not lose context when navigating the tables.
+From 3.2.0, to improve usability and align with user expectations, the DHIS2 Android Capture App has undergone a comprehensive redesign of the data entry table and input dialog for Data Sets.
 
-![](resources/images/capture-app-image213.png){ width=25%}
+**Key Enhancements:**
 
-![](resources/images/capture-app-image214.png){ width=25%}
+* Modernized Table Layout: The data entry table now features a cleaner and more intuitive design, facilitating easier data input and review.
+* Enhanced Input Dialog: The input dialog has been revamped to provide a more user-friendly interface, streamlining the data entry process.
 
+![](resources/images/capture-app-image318.png){ width=25%}
+![](resources/images/capture-app-image319.png){ width=25%}
+
+#### Capturing Coordinates (New 3.2.0) {#capture_app_data_sets_data_entry_capture_coordinates}
+
+To enhance the process of capturing coordinates and align to the behavior in tracker programs, a search bar has been implemented. This feature allows users to input textual information, such as street names or numbers, to facilitate the identification of specific locations.
+
+![](resources/images/capture-app-image316.png){ width=25%}
+![](resources/images/capture-app-image314.png){ width=25%}
+![](resources/images/capture-app-image315.png){ width=25%}
 
 ### Navigation Bar { #capture_app_data_sets_navigation_bar }
 
 Use the navigation bar located at the bottom of the data set to switch between the data entry form and the overview screen.
 
 ![](resources/images/capture-app-image139.png){ width=25%}
 
-### Overview Screen { #capture_app_data_sets_overview_screen }
+### Overview Screen (Removed 3.2.0) { #capture_app_data_sets_overview_screen }
 
-The new overview tab contains the following details:
+the Overview screen for Data Sets has been removed from the Android Capture App in version 3.2.0. Users are now taken directly to the data entry screen after selecting a Data Set.
 
-- Data set name
-- Last Update
-- Open/Close Status
-- Period
-- Org Unit
-- Category option combo
-- Refresh button (To trigger a granular synchronization)
+All relevant metadata is now either pre-selected or directly accessible within the data entry screen.
 
-![](resources/images/capture-app-image122.png){ width=25%}
-
-### Saving a data set { #capture_app_data_sets_saving }
+### Saving a data set (Improved 3.2.0) { #capture_app_data_sets_saving }
 
 Validation rules and completion of data sets are integrated in the save button actions:
 
 - When a Data set is configured to *complete only if validation passess*. If the validation is successful, a dialog asking to mark as complete will show up. The App will allow completion only if all mandatory fields have value.
-
-![](resources/images/capture-app-image131.png){ width=25%}
 
 - if it is not successful, then an error dialog should show and the dataset will not be marked as complete. The description and instructions of the validation rule will be displayed to help the user identify the error.
 
-![](resources/images/capture-app-image128.png){ width=25%}
+![](resources/images/capture-app-image129.png){ width=25%}
 
 - On a dataset that does not have setup "Complete allowed only if validation passes". When clicking on the save button; if the data set has validation rules associated to it, then the app will ask the user to run the validation rules.
-
-![](resources/images/capture-app-image130.png){ width=25%}
 
 - If the validation is not successful, an error dialog should show but with the possibility to complete the data set anyway. The description and instructions of the validation rule will be displayed to help the user identify the error.
 
-![](resources/images/capture-app-image129.png){ width=25%}
+![](resources/images/capture-app-image128.png){ width=25%}
 
 - If the data set does not have validation rules, the data set will be marked as complete if all mandatory fields have value.
 
-### Increase Row and column Headers { #capture_app_data_sets_row }
+### Increase Row and column Headers (Improved 3.2.0) { #capture_app_data_sets_row }
 
 Users are now allowed to resize the row headers and columns in datasets, making it easier to view and work with larger tables.
 
 To resize any column, tap on its header and then drag and drop until the desired size. A maximum and minimum size limit is given for the columns that can be resized to ensure a good layout.
 
 If the column have multiple headers, the resizing will be available only for the child header (lowest level). Users can also resize all collumns at once by clicking on the top left of the table.
 
-![](resources/images/capture-app-image215.png){ width=25%}
+![](resources/images/capture-app-image329.png){ width=25%}
 
-![](resources/images/capture-app-image216.png){ width=25%}
 
-### Indicators { #capture_app_data_sets_indicators }
+From 3.2.0 the Data Sets table includes a Reset button to complement the increment and decrement input controls in columns.It appears only while resizing is active and lets users quickly revert any resized columns to their original (default) width.
+
+The button is contextual and will:
+
+* Disappear once the user navigates to a different section.
+* Be hidden when an input dialog is opened.
+
+![](resources/images/capture-app-image335.png){ width=25%}
+
+### Indicators (Improved 3.2.0) { #capture_app_data_sets_indicators }
 
 Indicators are now available in default and section forms and are displayed at the bottom of the data entry form.
 
-![](resources/images/capture-app-image140.png){ width=25%}
+![](resources/images/capture-app-image318.png){ width=25%}
 
 ### Cards design { #capture_app_datsets_cards_design }
 
@@ -81,6 +88,57 @@ The new design of cards offers a cleaner and more intuitive layout replacing the
 
 ![](resources/images/capture-app-image237.png){ width=25%}
 
+### Configurable forms/ Pivot options (New 3.2.0) { #capture_app_datsets_pivot_options }
+
+This new feature supports a variety of layout and display configurations, allowing data sets to better reflect national paper tools, simplify workflows, and reduce user errors. It requires a configuration in the maintenance app whithin a DHIS2 Web version: 2.41+.
+
+The following configurations are supported:
+
+#### 1. Disable Automatic Grouping of Data Elements
+
+Ensures data elements retain their defined order, even if they share category combination and prevents the default behavior where data elements are grouped by category combination and sorted alphabetically.
+
+**Enabling grouping (default)**
+
+![](resources/images/capture-app-image332.png){ width=25%}
+
+**Disabling grouping**
+
+![](resources/images/capture-app-image333.png){ width=25%}
+
+#### 2. Transpose (Pivot) Layout Options
+
+Controls how data elements and category options are arranged in tables:
+
+|Mode | Description|
+|---|---|
+|Default | Data elements as rows, categories as columns (standard layout)|
+|Full Pivot | Categories as rows, data elements as columns|
+|Move Specific Category to Row | Shift only one category to rows for partial transposition|
+
+**Full Pivot**
+
+![](resources/images/capture-app-image330.png){ width=25%}
+
+**Specific category to row**
+
+![](resources/images/capture-app-image334.png){ width=25%}
+
+
+#### 3. Content Before and After Sections
+
+Adds  instructional text or HTML content above and below each section and supports simple styling: < a >, < u >, < b/strong >, and < em >.
+
+![](resources/images/capture-app-image320.png){ width=25%}
+![](resources/images/capture-app-image321.png){ width=25%}
+
+#### 4. Render Sections as Tabs (vertical layout)
+
+When the feature is enabled in the section configuration, the form displays a left panel listing all the sections as vertical tabs.This panel is only shown in landscape orientation. In portrait mode, the traditional tab bar remains.
+
+![](resources/images/capture-app-image328.png){ width=25%}
+
+
 ## Supported features overview { #capture_app_datsets_supported_features }
 
 

content/capture-app/programs-features.md

@@ -79,7 +79,7 @@ To re-open an event, the app now displays a "Re-open form" button in the Details
 ![](resources/images/capture-app-image202.png){ width=25%}
 
 
-#### Discard changes (Improved 3.1.0) { #capture_app_programs_common_features_discard_changes }
+#### Discard changes { #capture_app_programs_common_features_discard_changes }
 
 Tapping the back arrow in an enrollment or event form now provide two options:
 
@@ -200,7 +200,7 @@ If the TEI or event has coordinates a navigation icon will be displayed at the t
 ![](resources/images/capture-app-image150.png){ width=25%}
 ![](resources/images/capture-app-image151.jpg){ width=25%}
 
-#### Maps Accuracy (New 3.1.0) { #capture_app_programs_common_features_map_accuracy }
+#### Maps Accuracy { #capture_app_programs_common_features_map_accuracy }
 
 From 3.1.0, the capture coordinates process now includes a feature that displays the precision of the captured location. This allows users to see how accurate their location data is in real-time.
 
@@ -217,7 +217,7 @@ The coordinate can be captured even if the accuracy is low, but this behavior ca
 ![](resources/images/capture-app-image296.png){ width=25%}
 
 
-#### Maps Search (New 3.1.0) { #capture_app_programs_common_features_map_search }
+#### Maps Search { #capture_app_programs_common_features_map_search }
 
 A new search functionality has been added, allowing users to look up specific locations by name or address. Once the user tap on the search bar, the keyboard will open and the user can enter any street or location name. The user can select any of the locations of the list or tap on the "select in map" to display all the locations in the map (blue pins). 
 
@@ -228,7 +228,7 @@ When a place is selected, the location will be displayed as a card below the map
 
 The list of pins is based/limited on the current location. But once the search is done, if the user moves to a different area, the search can be done within the new area by tapping on the "search on this area" button.
 
-#### Maps Manual Capture (New 3.1.0) { #capture_app_programs_common_features_map_manual }
+#### Maps Manual Capture { #capture_app_programs_common_features_map_manual }
 
 By dragging the map the user can choose the pin location manually. At the bottom of the map, the label "selected location" will be displayed with the respective coordinates.
 
@@ -301,7 +301,7 @@ This feature enables users to take action on phone numbers and email addresses d
 
 ![](resources/images/capture-app-image230.png){ width=25%}
 
-### Customized Tracker Terminology (Improved 3.1.0) { #capture_app_programs_common_features_customized_terminology }
+### Customized Tracker Terminology { #capture_app_programs_common_features_customized_terminology }
 
 In order to facilitate the terminology used in DHIS2, it has been decided to gradually enable the possibility to customize certain terms to each particular use case. In 3.0, the terms "event" (used in a program stage context) and "enrollment" are customizable.
 
@@ -317,9 +317,9 @@ To customize the terms, the admin can go to the Maintenance and when creating or
 
 In 3.1, the term "event" (program context) is now customizable.
 
-### Relationships (Improved 3.1.0) { #capture_app_programs_common_features_relationships }
+### Relationships { #capture_app_programs_common_features_relationships }
 
-The relationship tab has been modified to display sections once the tab is open. Each section represents a different relationship type and the + icon will be available only if the user has capture access to the relationship type. 
+The relationship tab displays sections once the tab is open. Each section represents a different relationship type and the + icon will be available only if the user has capture access to the relationship type. 
 
 The name of the section will be the "relationship name seen from the initiating or receiving entity" depending on the configuration of the relationship.
 
@@ -459,7 +459,7 @@ To complete or deactivate an enrollment, click on three dot menu in the uppper r
 
 ![](resources/images/capture-app-image76.jpg){ width=25%}
 
-### Search Flow (Improved 3.1.0) { #capture_app_programs_search }
+### Search Flow { #capture_app_programs_search }
 
 #### Configurable TEI Search { #capture_app_programs_configurable_search }
 
@@ -475,7 +475,7 @@ If the feature is enabled, the Android App will display a "create new" button af
 
 ![](resources/images/capture-app-image281.png){ width=25%}
 
-#### Search by unique QR/bar Codes (Improved 3.1.0) { #capture_app_programs_unique_qrBar_search }
+#### Search by unique QR/bar Codes { #capture_app_programs_unique_qrBar_search }
 
 In 3.0, the search form has been improved to provide a cleaner look and a more intuitive user experience. The buttons have been made more explicit for differencing search from creation. In addition the flow for searching TEIs using attributes rendered as bar / QR codes has been made more agile. If there is only one result and the attribute is unique, the app will open the TEI Dashboard directly. If there are multiple results, the app will display all the cards on the TEI list (this is equal to the current workflow), and if there are no results, the app will display the create button and allow the user to “search outside the program” if the configuration allows it.
 
@@ -603,7 +603,7 @@ When users add events (tapping on the + icon) in a tracker program, the DHIS2 An
 
 ![](resources/images/capture-app-image233.png){ width=50%}
 
-### Transfers (Improved 3.1.0) { #capture_app_programs_transfers }
+### Transfers { #capture_app_programs_transfers }
 
 Significant enhancements to the transfer flow, aimed at making the process more user-friendly and transparent. The transfer button has been moved to a more accessible location within the three dot menu in the TEI Dashboard, ensuring that users can easily find and initiate transfers without unnecessary navigation. 
 
@@ -624,15 +624,15 @@ For more information on how to configure the TEI header, click [here.](https://d
 ![](resources/images/capture-app-image249.png){ width=50%}
 ![](resources/images/capture-app-image250.png){ width=50%}
 
-### Scheduling (Improved 3.1.0)  { #capture_app_programs_scheduling }
+### Scheduling { #capture_app_programs_scheduling }
 
 #### Schedule after completion { #capture_app_programs_common_features_schedule_after_completion }
 
 In 3.0, the schedule dialog after completion has been redisigned to facilitate the creation of the event.
 
 ![](resources/images/capture-app-image270.png){ width=25%}
 
-#### Schedule events dialog (New 3.1.0)
+#### Schedule events dialog
 
 As a continuation of the new schedule dialog introduced in the version 3.0, a new  intuitive and user-friendly schedule dialog has been implemented to enhance the overall user experience, making it easier to book, reschedule, or cancel events.
 
@@ -645,6 +645,28 @@ Once an event has been scheduled, when the user taps on it, the app will display
 ![](resources/images/capture-app-image293.png){ width=25%}
 ![](resources/images/capture-app-image294.png){ width=25%}
 
+### Dashboard quick actions (New 3.2.0)  { #capture_app_quick_actions }
+
+The Quick Actions bar is a new feature in the DHIS2 Android Capture App that enables users to access frequently used actions directly from the Tracked Entity Instance (TEI) Dashboard. These actions are displayed as customizable chips, streamlining workflows and reducing the number of taps needed to perform routine tasks.
+
+Each action is displayed as a chip in the TEI Dashboard. By default, all chips are unselected, and the Quick Actions bar is not displayed in the app. When tapped, the chip performs a predefined function. The available actions include:
+
+1. Mark for follow-up
+2. Transfer
+3. Complete
+4. Cancel
+5. More enrollments
+
+The chips cannot be reordered. The order of appearance is as the list above.
+
+![](resources/images/capture-app-image325.png){ width=25%}
+![](resources/images/capture-app-image326.png){ width=25%}
+
+### Limitations and considerations { #capture_app_quick_actions_limitations }
+
+* Quick Actions are available only when configured via Android Settings WebApp (v2.4.2)
+* Each program must be configured individually.
+* Feature parity is maintained: actions remain available in the TEI Dashboard 3-dot menu even when Quick Actions are disabled.
 
 ## Supported features Overview { #capture_app_programs_supported_features }
 

content/capture-app/visual-configurations.md

@@ -101,7 +101,7 @@ There are many more restrictions which apply to Android Analytics regarding the
 > 
 > 
 
-### Event Visualizations (Improved 3.1.0) { #capture_app_visual_event_visualizations }
+### Event Visualizations { #capture_app_visual_event_visualizations }
 
 The DHIS2 Android App can now render analytics that have been created in the line listing app.Analytics to be displayed require to be configured using the Android Settings WebApp where administrators will be able to decide the tables to be displayed for end users.
 
@@ -179,7 +179,7 @@ You can set the generic theme of the app by configuring the them in our server:
 >
 >![](resources/images/capture-app-image23.png){ width=25%}
 
-## Icon library for metadata (Improved 3.1.0) { #capture_app_visual_icon_lib }
+## Icon library for metadata { #capture_app_visual_icon_lib }
 
 There are currently 134 icons available that you can choose from. You can search by name in the icon picker widget. Icons are available in positive, negative and outlined shapes.
 
@@ -351,7 +351,7 @@ This feature enhances the functionality of the app when it is used offline, ensu
 
 The Android App enables users to view long text in fields that are limited in size, such as a stage names or datasets headers.
 
-### Legends (Improved 3.1.0) { #capture_app_visual_legends_descriptions}
+### Legends { #capture_app_visual_legends_descriptions}
 
 The Android App displays the full description of the legend when tapping on the information icon once a legend is active. These feature is available only in event and registration forms.
 
@@ -366,7 +366,7 @@ The new input fields are now displayed by default in the Android app and admin u
 
 ![](resources/images/capture-app-image289.png){ width=25%}
 
-### Menus and Navigation bar (Improved 3.1.0) { #capture_app_visual_menu_bars_update}
+### Menus and Navigation bar { #capture_app_visual_menu_bars_update}
 
 A revamped of the menus and navigation bar has been made to be more user-friendly and accessible. It includes a cleaner, more modern look that improves readability and usability. These updates are designed to provide a more efficient and enjoyable user experience.