Mobile Forms

CTS makes heavy use of form submissions from mobile devices. One requirement for these mobile devices is that they must support form submissions while the phone has no connectivity. To fulfill this requirement CTS utilizes Ona and ODK Collect.

Please familiarize yourself with the ODK Collect documentation before proceeding.

Configure ODK Collect

In order to access the required CTS Forms, you will need to configure ODK Collect on the mobile device.

  1. Open ODK Collect on the device
  2. Press the Menu button on the device
  3. Select General Settings
  4. Update the URL to https://ona.rescue.org/[username]
  5. Press the Back button on the device
  6. Press Get Blank Form in ODK Collect
  7. Select all forms
  8. Press Get Selected

Submit Form Data

Once a device has forms on it, a user can open ODK Collect and fill out a blank instance of a form.

  1. Select Fill Blank Form
  2. Choose a form
  3. Fill out the form
  4. Mark the form as finalized
  5. Press Save Form and Exit

Upload Form Data

ODK Collect stores completed form submissions on the device. ODK Collect can be configured to automatically upload stored form submissions when the device is conected to wifi.

If automatic upload is not configured, you must manually upload the completed forms.

  1. Select Send Finalized Form
  2. Select the form instance(s) to upload
  3. Press Send Selected
  4. You will be informed of upload successes and failures

User Device Capture Form

The User Device Capture Form is a very simple form. It has one form input that requires scanning a QR code associated with a CTS User. The QR code can be found by navigating to the list of Users and clicking the QR code icon. This will open the unique user QR code in a new browser tab/window.

The web application polls Ona for new form submissions and updates a user’s deviceid as needed.

Package Delivery Form

The Package Delivery Form allows CTS and Partner personnel to update information related to a shipment and its packages during the lifecycle of the shipment. The Package Delivery From is much more complex than the User Device Capture Form:

  • Governate – Select the current administrative division
  • District – Select the current district
  • Sub-District – Select the current sub-district
  • Community – Supply the current community
  • P-code – If known, supply the current GPS precision code
  • Current Location – Select the Shipment’s current location
  • Record Current Location – Record the current GPS coordinates
  • Number of Packages – Supply the number of packages to scan
  • Package Information – Scan the QR code for each package
  • Shipment Complete – Mark if the Shipment is complete
  • Shipment Inomplete Reason – Supply the reason the Shipment is incomplete

Voucher Tracking Form

The Voucher Tracking form allows IRC personnel to activate a voucher which is to be given to a recipient. This is similar to the Package Delivery Form in that it collects location information. Unlike a Package Delivery Form, each Voucher Tracking Form is meant to track only one package, which happens to be a single voucher. It also collects information about the beneficiary, approving party, voucher value, and issue/expiration dates.