Resources

Mobile app user manual

Log in, grant permissions, read the dashboard and navigation bar, add registrations with NID capture, work through follow-ups, track microplanning areas, and check status and settings.

Introduction

The ComMicPlan mobile app (CMPCollect) is the field companion to the web platform. Data collectors log in, download assigned forms, register respondents, follow up on scheduled visits, track their assigned microplanning area, and monitor submission status, all from the phone.

  1. 1Log in and grant device permissions
  2. 2Read the app bar and bottom navigation bar
  3. 3Review the dashboard: downloads, quick actions, recent activity
  4. 4Add a registration and capture identity documents
  5. 5Work through the Follow-up list
  6. 6Track movement inside the assigned Microplanning area
  7. 7Check submission Status and adjust Settings
Screenshots in this tutorial come directly from the CMPCollect app and are annotated to highlight the control being described.
Getting started

Log in

Log in with your Username and Password. After a successful login, the app redirects to the Dashboard, which provides access to profile management, notifications, connection status, microplanning path tracking, form downloads, quick actions, and recent activity.

Login screen
CMPCollect login screen with username and password fields
Credentials entered
CMPCollect login screen with credentials entered
Dashboard after login
Dashboard shown immediately after login
Getting started

Grant device permissions

After the first login, ComMicPlan requests access to the microphone, location, and camera. These permissions are required for audio recording, location-based and microplanning features, and photo or video capture. Grant them one by one as they appear.

Select While using the app for all three permission prompts during normal field data collection.
Permission

Microphone permission

The microphone is needed when a form or field activity includes an audio recording question. Without it, audio-related questions may not work.

Microphone permission prompt
Allow ComMicPlan to record audio permission prompt
Permission

Location permission

Location access supports ComMicPlan's GIS and microplanning features, including collecting geographic coordinates and recording the user's path when Microplanning Path Tracking is enabled. If location is denied, location-dependent features may not work correctly.

Location permission prompt
Allow ComMicPlan to access this device's location permission prompt
Permission

Camera permission

The camera is used for photo and video questions in a form submission, capturing document images such as the NID card, and collecting photographic evidence during field activities.

Camera permission prompt
Allow ComMicPlan to take pictures and record video permission prompt
If any permission is set to Don't allow, the related functionality may not work — for example, denying camera access disables camera-based questions, and denying location access affects location and microplanning features.
Dashboard

Profile and logout

The Profile icon sits at the top-left of the Dashboard app bar. Tap it to open a menu with the Logout option, then tap Logout to securely sign out of the app.

Profile icon
Profile icon in the Dashboard app bar
Profile menu with Logout
Profile menu with the Logout button
Dashboard

Notifications

Tap the Notification (bell) icon in the app bar to check the notifications available in the system, such as newly assigned forms or registrations synced from the server. Tap a notification to expand its full detail.

Notification icon
Notification bell icon in the Dashboard app bar
Expanded notification
Expanded notification panel over the Dashboard
Dashboard

Connection status

A status dot next to the Notification icon shows the device's current internet connection. A green dot means the device is online and submissions can sync; a red dot means the internet connection is currently unavailable and completed forms stay pending until a connection returns.

Online (green dot)
Green connection status dot indicating the device is online
Offline (red dot)
Red connection status dot indicating the device is offline
Dashboard

Microplanning path tracking arrow

The Arrow icon next to the connection status opens Microplanning Path Tracking. A solid, colored arrow means path tracking for the ongoing microplanning activity is on; a faint outline arrow means tracking is currently off and path information will not be available until it is enabled.

Path tracking off
App bar arrow icon showing microplanning path tracking off
Path tracking on
App bar arrow icon showing microplanning path tracking on
Dashboard

Bottom navigation bar

The bottom navigation bar lets users move between the main sections of the app without returning to the Dashboard each time.

  1. 1.Home – returns to the Dashboard.
  2. 2.Follow-up – opens the Follow-up page to perform required follow-up activities.
  3. 3.Micro-plan – opens the Microplanning page to manage microplanning activities and tasks.
  4. 4.Status – shows whether submitted forms have synced successfully or have an issue.
  5. 5.Settings – opens the app's settings.
Bottom navigation bar
Bottom navigation bar with Home, Follow-up, Micro-plan, Status, and Settings tabs
Follow-up tab
Follow-up tab selected in the bottom navigation bar
Micro-plan tab
Micro-plan tab selected in the bottom navigation bar
Status tab
Status tab selected in the bottom navigation bar
Settings tab
Settings tab selected in the bottom navigation bar
Dashboard

Dashboard contents

Below the app bar, the Dashboard shows the number of forms that still need to be downloaded, two Quick Action buttons, and a Recent Activity list.

  1. 1.Forms Download Required shows how many new forms are not yet downloaded for offline use; tap Download forms and wait for the progress to reach 100% Complete.
  2. 2.Quick Actions – Add Registration opens the registration form; Initial Form opens forms that have already been downloaded.
  3. 3.Recent Activity lists the user's most recent actions; tap View All to see the complete activity list instead of only the most recent items.
Dashboard contents
Dashboard with Forms Download Required, Quick Actions, and Recent Activity
Dashboard and navigation bar
Dashboard with the bottom navigation bar visible
Quick Actions
Quick Actions with Add Registration and Initial Form buttons
Recent Activity
Recent Activity list on the Dashboard
Add a registration

Personal information and project

Add Registration creates a new registration by collecting personal information, an identity document, location, address, and notification preferences. Tap Add Registration from Quick Actions to open the Registration page.

  1. 1.First Name, Email, Phone, Age, and Gender capture the person's personal information.
  2. 2.Project is optional — select an existing project to create the registration under that project, or leave it unselected for an individual registration.
Add Registration button
Add Registration button in Dashboard Quick Actions
Registration page
Add Registration page with all form sections
Personal information
Personal Information fields on the Add Registration page
Project (optional)
Optional Project selector on the Add Registration page
Add a registration

Identity document

The Identity Document card collects a Document Type and Document Number. The Document Type dropdown offers National ID (NID), Birth Registration, and Passport. Once a type is selected, the Document Number field appears with a hint for the expected digit count — for example, Bangladesh NID accepts 10 digits (old), 13 digits (smart card), or 17 digits (birth-linked).

Document type dropdown
Document Type dropdown with National ID, Birth Registration, and Passport
National ID selected
Identity Document card with National ID selected and the Document Number field
Add a registration

Capture the NID front

Auto Fill from NID Photo lets users provide Front and Back images of the NID card and extract information automatically instead of typing it in. Each side can be captured with the device Camera or picked from the Gallery.

  1. 1.Tap Camera under Front and grant camera access if prompted.
  2. 2.Frame the front of the NID card and capture the photo.
  3. 3.Confirm the captured image is selected for the Front slot.
  4. 4.Rotate and scale the crop frame so only the card is inside it, then confirm the crop.
  5. 5.Tap Extract from NID to pull the available fields directly from the photo.
NID auto-fill section
Auto-fill from NID photo section with Front and Back slots
Camera and Gallery options
Camera and Gallery buttons for the front and back NID images
Framing the NID front
Camera open while framing the front of the NID card
Front photo captured
NID front photo captured successfully
Front image selected
Captured NID front image selected for the Front slot
Crop – rotate
Cropping the NID front photo with the rotate control
Crop – scale
Cropping the NID front photo with the scale control
Crop confirmed
NID front photo cropped and confirmed for the Front slot
Add a registration

Capture the NID back

Repeat the same capture and crop steps for the Back side of the NID card.

Back photo captured
NID back photo captured successfully
Back image selected
Captured NID back image selected for the Back slot
Crop – rotate
Cropping the NID back photo with the rotate control
Crop – scale and confirm
Cropping the NID back photo with the scale control
Add a registration

Location, address, and notifications

Below the identity document, Capture Location records the user's current GPS coordinates (optional but improves data accuracy), and Address accepts a manually typed address of up to 200 characters. At the bottom of the form, the Notifications switch controls follow-up reminders and is on by default; turning it off means the user will not receive follow-up reminder notifications for that registration.

Location and address
Location card with the Capture location button and Address field
Address field
Address field on the Add Registration page
Notifications on (default)
Send follow-up reminders switch turned on
Notifications off
Send follow-up reminders switch turned off
  1. 1Add Registration
  2. 2Personal information
  3. 3Project selection (optional)
  4. 4Identity document – type and number
  5. 5NID photo – front and back
  6. 6Extract from NID
  7. 7Capture location
  8. 8Address
  9. 9Notification settings, then submit
Follow-up

Follow-up categories

The Follow-up page lists forms that require follow-up. Open it from the Follow-up tab in the bottom navigation bar. Four tabs — Today, Tomorrow, Next Day, and Missed — filter the list by schedule. Today is selected by default. Below the tabs, the page shows the date and the number of follow-up forms scheduled for it; Missed shows follow-ups whose scheduled date has already passed without being completed.

Follow-up page
Follow-up page with the Today, Tomorrow, Next Day, and Missed tabs
Today
Follow-up page with the Today tab selected
Tomorrow
Follow-up page with the Tomorrow tab selected
Next Day
Follow-up page with the Next Day tab selected
Missed
Follow-up page with the Missed tab selected
Follow-up

Search and filter follow-ups

A Search bar finds a specific follow-up form by name; if nothing matches, the app shows “No task matches your search.” The Filter button next to it opens a sort menu with Default, Form Name (A–Z), and Form Name (Z–A), which can be combined with the search to find a form quickly.

Search and filter
Follow-up search bar and Filter button
Search results
Follow-up list filtered by a search term
Filter button
Filter button highlighted on the Follow-up page
Default order
Filter menu with Default order selected
Form Name (A–Z)
Filter menu with Form Name A to Z selected
Form Name (Z–A)
Filter menu with Form Name Z to A selected
Microplanning

Path tracking workflow

The Microplanning page shows the area assigned to the user and tracks their current location and movement inside it. While tracking is active, the app checks whether the user is within the assigned area and shows a warning — with the distance from the boundary — if they move outside it.

  1. 1Navigation Bar → Micro-plan
  2. 2View the assigned area on the map
  3. 3Start Path Tracking
  4. 4Check the current location against the assigned boundary
  5. 5Track movement in real time
  6. 6Stop Path Tracking
  7. 7Review the tracked locations and path
Assigned microplanning area
Microplanning map with the assigned area outlined
Start path tracking
Start Path Tracking button on the Microplanning page
Real-time tracking
Real-time location and movement tracked on the microplanning map
Stop path tracking
Stop Path Tracking control on the Microplanning page
Microplanning

Map controls

A control stack on the right side of the map helps users navigate while tracking.

  1. 1.+ zooms in for more detail.
  2. 2.– zooms out to see a larger area.
  3. 3.The center icon recenters the map on the current or selected location.
  4. 4.The full-screen icon expands the map for easier monitoring.
  5. 5.The path tracking icon stays active by default, indicating movement is being tracked.
Zoom in
Zoom in control highlighted on the microplanning map
Zoom out
Zoom out control highlighted on the microplanning map
Center location
Center location control highlighted on the microplanning map
Path tracking control
Path tracking control highlighted on the microplanning map
Status

Status and sync

Open the Status tab from the bottom navigation bar to see whether completed forms have synced. A Sync section reports how many forms are Pending Uploads and whether Auto Sync is on — an active internet connection is required for forms to sync, otherwise they stay pending until a connection is available.

Sync section
Status page with the Sync section showing pending uploads and Auto Sync
  1. 1.Status filter: Pending, Synced, or All.
  2. 2.Type filter: All Types, Forms, or Registration.
  3. 3.Combine both filters, for example Pending + Registration, to find specific submission records quickly.
Status filter
Status filter with Pending, Synced, and All options
Type filter
Type filter on the Status page
Type filter menu
Type filter menu with All Types, Forms, and Registration
Combined filters
Status and type filters combined to narrow the submission list
Reference

Settings

Open the Settings tab from the bottom navigation bar to manage app-related preferences. The page groups preferences into User Interface, Maps, Password Reset, Form Management, and Project Management.

Settings page
Settings page with the preference groups
Settings page (continued)
Settings page scrolled to show the remaining preference groups
Settings

User Interface

User Interface controls how the app looks and behaves, such as theme and display preferences.

User Interface
User Interface settings
User Interface options
User Interface settings options
Settings

Maps

Maps controls map-related preferences used by GIS and microplanning features, such as the base map and offline map behavior.

Maps
Maps settings
Maps options
Maps settings options
Settings

Password Reset

Password Reset lets the signed-in user change the account password from the device.

Password Reset
Password Reset settings
Password Reset form
Password Reset form with new password fields
Settings

Form Management

Form Management handles downloaded forms — reviewing which forms are available offline and refreshing or removing them.

Form Management
Form Management settings
Downloaded forms
Form Management list of downloaded forms
Settings

Project Management

Project Management shows the projects assigned to the user and controls project-related preferences on the device.

Project Management
Project Management settings
Assigned projects
Project Management list of assigned projects
Reference

Tips and best practices

  1. 1.Select While using the app for microphone, location, and camera permissions during normal field collection.
  2. 2.Download forms before heading to the field so they are available offline.
  3. 3.Keep the Notification switch enabled on a registration to receive its follow-up reminders.
  4. 4.Use Extract from NID to reduce manual typing when the card photos are clear.
  5. 5.Watch the top app bar for the out-of-area warning while path tracking is active.
  6. 6.Check the Status page after regaining connectivity to confirm Pending forms have synced.