Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 28 additions & 1 deletion docs/user/using-the-capture-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -395,6 +395,8 @@ You now have two options:
> - The event is completed and the program stage has **Block entry form after completed** enabled.
>
> Users with the **Edit expired data** authority can still edit events affected by the last two cases.
>
> Reopening a completed event also requires the **Uncomplete events** authority (`F_UNCOMPLETE_EVENT`). Without it, the **Complete event** checkbox is disabled on completed events and shows the tooltip *You do not have access to uncomplete this event*.


## Delete an event { #capture_delete_event }
Expand Down Expand Up @@ -676,10 +678,16 @@ The Capture app supports the working lists in tracker programs, and opening a tr

![](resources/images/search-by-attributes-on-scope-program-overview-0.png)

To enhance search performance, you can configure the **preferredSearchOperator** or **blockedSearchOperators** metadata in Maintenance. Tracked entity attributes with the following value types apply these settings: TEXT, LONG_TEXT, EMAIL, PHONE_NUMBER and PERCENTAGE. If preferredSearchOperator is not defined, the search falls back to the first available operator in [LIKE, SW, EQ] that is not listed in blockedSearchOperators. Attributes with other value types ignore the preferredSearchOperator. Helper text messages are displayed below the attribute search fields to guide the user.
To improve search performance, an administrator can control which operators an attribute is searched with. In the Metadata Management app, open the tracked entity attribute and go to the **Search performance** section, which requires DHIS2 server version 2.43 or higher. **Preferred search operator** is the operator the app tries first, and can be set to *EQ | Equals*, *SW | Starts with*, *EW | Ends with* or *LIKE | Contains*. **Blocked search operators** are the operators that must not be used, and a search that would use a blocked operator returns no results.

These settings only apply to attributes with the value types text, long text, email and phone number. Attributes with other value types are searched with a fixed operator and ignore the preferred search operator. Unique attributes and attributes with an option set are always matched with *equals*. If no preferred operator is set, the search uses the first of *contains*, *starts with* and *equals* that is not blocked. Helper text below each attribute search field tells the user how that field will be matched.

![](resources/images/search-by-attributes-on-scope-program-preferredSearchOperator.png)

The same section has **Minimum characters required to search**, the number of characters the user must enter before the app searches on that attribute, where 0 means no minimum. The minimum applies to the attribute's filter in working lists as well, which shows *Please enter at least N characters to filter* until enough characters have been entered.

Set a minimum with care for attributes that are not text. Filters for some value types can only ever hold as many characters as the value type allows - 10 for a date (2026-09-04), 5 for a time (14:30) and 3 for a percentage (100) - so a minimum higher than that can never be reached, and the filter shows *Minimum characters to search is too high for this filter* instead.

To execute a search now:

1. Fill in the attributes you want to search with.
Expand Down Expand Up @@ -933,6 +941,25 @@ You can show data elements from a single stage in a working list. Select the "Pr

The tracker program stage list can be [filtered](#filter-the-list), [sorted](#sort-the-list), [modified](#modify-the-list-layout), [saved](#capture_view_save), [updated](#capture_view_update), [deleted](#capture_view_delete) and [shared](#capture_view_share) in the same way as other working lists. Additionally, the program stage list can be [filtered by assignee](#assignee-in-the-event-list), just like an event program list.

## Dates and calendars { #capture_dates_and_calendars }

The Capture app displays and accepts dates in the calendar configured for your DHIS2 server. If the server uses a non-Gregorian calendar, such as the Ethiopian or Nepali calendar, all date fields, date pickers, date ranges, age fields and the dates shown in lists and widgets follow that calendar. The order of day, month and year follows the server's date format setting.

The example below shows the report date picker on a server configured to use the Nepali calendar, with the Nepali month and year and the Nepali weekday names.

![](resources/images/nepali-calendar-date-picker.png)

This affects, among others:

- Enrollment, incident, report and scheduled dates in forms and widgets.
- Date and date range filters in working lists, and the dates shown in list columns.
- Age fields, where entering a date of birth calculates the age in the configured calendar, and entering an age calculates the date of birth.
- Validation that depends on dates, such as a program's expiry days and complete events expiry days.

Dates are always stored on the server in the ISO 8601 (Gregorian) calendar and converted for display. A date entered as 2017-04-13 in the Ethiopian calendar is stored as the corresponding Gregorian date, so downloaded lists, the API and other DHIS2 apps that do not apply the calendar setting may show a different, equivalent date.

The calendar is a server-wide setting and cannot be changed per user or per program. Contact your system administrator if dates appear in an unexpected calendar.

## Implementer / administrator info { #implementer_info }

### Metadata caching { #metadata_caching }
Expand Down
Loading