Field Book is an open source android application developed as part of the broader PhenoApps initiative. It is used for data collection. KSU Fieldbook connects to BMS using BrAPI.

It can be downloaded at http://phenoapps.org/apps/ (Google Play store)

Instructions

  1. Open the Fieldbook Application  and click Settings.

  2. Under Settings, select BrAPI.

  3. Under BrAPI, select BrAPI Version V1.

  4. Under Advanced Auth Settings, select OIDC Flow then Original Field Book Custom

  5. Select “Base URL”. Enter the BrAPI Base URL (i.e. https://<institute’s BMS address>/bmsapi/<crop name> ). In this tutorial use : https://www.bms-uat-test.net/bmsapi/wheat.  In this example, we are connecting to use wheat crop. 

  6. It will open the Authorization page.  Enter the BMS login Name and Password

  7. Click Authorize.

  8. To get the study instances, exit Breeding API, Settings then click FIELDS.

  9. To add environment instance into Fieldbook. Click on the + and select BrAPI

  10. Select an environment from the List.

  11. Click Preview Field. This allows users to check the field before saving.

  12. Click on Traits to select the traits that will be measured. Please take note that traits from other fields/environments will also be in the list of traits.

  13. To start entering observed values, click “COLLECT”.

  14. Collected observation values can be exported to BMS by clicking Export.

  15. Data can be exported using Local storage or via BrAPI.

  16. The number of new or modified observations will be shown. In this example, 4 New Observations have been collected. Click Export.

  17. “BrAPI Export Successful” message shows up if the export is successful.

ADDITIONAL Settings:

Alternative workflow: OIDC OAuth 2

Important: Android supported links

Make sure the Android setting Open supported links is set to Open in this app instead of “Ask every time”, for the link fieldbook.phenoapps.org

Related articles

How to select a phone or tablet for KSU Fieldbook App