Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On the "Settings" page (accessed by clicking the gear icon Image Removed and selecting the Advanced Settings tab) in the app builder, you will see a variety of advanced settings. Many of them are only accessible through clicking the list icon button to the right of the "saved"/"save" button at the top of the page. CommCare supports a number of Advanced Application Settings that may improve your workflows. In the App Builder, click the gear icon Image Added and select the “Advanced Settings” tab. Each setting configures the mobile application in a different way. After you update settings for your app, you have to make a new version, for the settings to take effect.  Please note that with  With the exception of "Android Settings / Web Apps Logo", only "Basic" settings apply to Web Apps.

Table of Contents
minLevel1
maxLevel2
outlinefalse
style

...

none
typelist
printabletrue

CommCare Ad-Ons

In addition to the Advanced Application Settings, check out CommCare Add-Ons for other advanced features that you can use in CommCare.

Data and Sharing (Basic)

Case Sharing - whether

Whether to enable the sharing of cases between groups of users.  More InfoLearn more at Case Sharing.

Web App - whether

Whether to enable the web-based version of the application.  More InfoLearn more at Web Apps.

Build Settings

CommCare Version

...

The minimum CommCare version mobile users are required to have on their devices to be able to install the application. This is also true for application updates, user’s won’t be able to update any apps if the app update targets a higher CommCare version then what is already installed on their mobile device; they will need to update CommCare via the Google Play store first in order to update the app. The setting is especially useful when your application starts using a recently released CommCare feature and you want your users to be able to use said feature.  This setting can also act as a great forcing function for users to update CommCare to the latest version.

Auto Update Frequency

...

How frequently the app should check for updates made to the applications.  It will look for the latest released version of your application.

Unsent Form Limit

...

The number of unsent forms you can have on the phone before highlighting the number of unsent forms in red warning text 

Multimedia Validation

...

Whether to require that all multimedia files be present on the phone before starting a newly-installed application.  Note that this validation will not run if the application remotely updates. More info

Auto-Sync Frequency

...

How often the application should automatically sync with the server.

Unsynced Time Limit

...

How long the application can go without syncing with the server before highlighting the sync message in red warning text 

Java Phone General Settings

Send Data Over HTTP - Choose whether to send data securely over HTTPS or not (applies to Java phones only)

Java Phone Platform - The kind of Java phone you want to run the application on.  For QWERTY keyboard phones, choose generic.

Admin Password - The password for the admin login feature.  Please note the "Password Format" setting and ensure your chosen admin password matches this format.

Password Format - Whether to allow alphanumeric passwords on the phone vs. numeric only. 

Allow User Registration from Phone - Whether you want to be able to register a user from the mobile application with a custom form vs. CommCareHQ only 

Send Data - Whether to send data from the application to CommCareHQ.  This is highly recommended.  Please note that turning off this settings will result in no data collection

Sync Mode - Whether the application can receive information from the server ("Two-way Sync") or only send information to the server ("Push Only").  Enabling Case Sharing will automatically enable Two-way Sync. If set to "Push Only", the Auto-Sync Frequency and Unsynced Time Limit settings will have no effect.

Java Phone User Interface Settings

CommCare Sense - Enable the special CommCare Mobile user interface for low-literate users.  More Info

Extra Key Action - What the 'Extra Key' (# on Nokia Phones) does when pressed. Language cycles through any available translations. Audio plays the question's audio if available. NOTE: If audio is selected, a question's audio will not be played by default when the question is displayed."

Item Selection Mode - Whether to select menu items using the normal scroll interface, or by pressing the number key that corresponds to that menu entry.  Numeric input is recommended for users with low phone literacy, and is enabled automatically by CommCare Sense mode.

Send Forms Mode - Whether completed forms are sent automatically or require the user to choose to when to send the forms. If automatic is enabled, forms will attempt to send on their own without intervention from the user. If manual is enabled, the user must manually decide when to attempt to send forms.  CommCare Sense automatically sets this to "automatic".

Text Input - Whether to allow only the default Roman character input, or to accept international characters.  Note that the latter will depend on what input languages are available on the phone. For full keyboard phones (QWERTY style), select Native (international) or else CommCare will default to T9 keyboard input.

Form Entry Style - Multiple Questions per Screen displays a running list of questions on the screen at the same time. One Question per Screen displays each question independently. 

User Login Mode - Whether to require the user to enter their password every time they open the application.  Normal mode requires password entry.  Auto login only requires a password the first time the user logs in, then automatically logs them in every time they open the application after that.

Login Buttons - Allows you to replace the "login" and "demo" buttons with icons

Android Settings

Days for Review

...

For how long completed forms remain in the Saved menu before they are erased from the phone.

Saved Forms

...

Enable / Disable the setting for saved forms. Once a form has been completed CommCare, it is then saved on the device in an encrypted format so it can be reviewed in a read only format in the future.

Incomplete Forms

...

Incomplete Forms

Enable / Disable the settings for incomplete forms, which are forms that have been started but not finished.

...

Note: If a project space uses Web Apps, enabling Incomplete Forms for any application will also enable it for Web Apps.

Auto-resize Images

...

Several different options for how CommCare resizes images to fit on the device screen

Auto Capture Location

...

Application will automatically capture GPS coordinates in forms without the user having to do anything. More info here: https://dimagi.atlassian.net/wiki/spaces/commcarepublic/pages/2143944766/Geospatial+Features+-+GPS+Maps+and+Distances#Automatic-GPS-Capture

Login Duration

...

Length of time after which you will be logged out automatically

Multiexcerpt include macro
macro_uuid9078ada9-7c16-4fe4-af1c-4ddd91c1ebe9
nameSoftware Plan - Advanced
templateDataeJyLjgUAARUAuQ==
page[Internal] CommCare Public ManagementCommCare Help Site Design Guidance
addpanelfalse

Home Screen & Logo Settings

...

...

...

Fuzzy Search

Fuzzy search is an improved case list search tool. It can help find cases based on the values of properties that are close to, but do not exactly match the search terms. For example, if you are searching for Christy, you could type Chrsty, or Kristy, or Christine and still find Christy. 

When a field in the Case List is included in the list of Sort Fields in the case list in CommCare HQ, fuzzy matching is enabled.  For more information on setting up fields to sort by see Case List and Case Detail Configuration.

You should expect that in CommCare mobile when you have a field that is applicable for fuzzy matching that after you type more than 3 characters CommCare should identify words that are very close to whatever is typed into the search box. Exact matches are shown in green, while fuzzy matches are in yellow.

...

How to Configure Fuzzy Search

It is active by default and can be turned off by going to Application Settings → Advanced Settings → Android Settings section. Fuzzy search is available in CommCare for Android on versions 2.15 and higher, for applications built in CommCare version 2.15 or higher.

As noted above you must include the case property you want to use fuzzy search for in your Case List and Case Detail Configuration.

Notes:

  • This feature works for multiple languages, including those in non-Roman scripts like Hindi.

  • The fuzzy search match algorithm incorporates industry standard methods such as Levenshtein distance and diacritic normalization