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. Note : Newer versions (5.5.xx) use V2

  4. Under Advanced Auth Settings, select OIDC Flow then Original Field Book Custom. Note : Newer versions (5.5.xx) use Auth Implicit Grant

  5. Select “Base URL”. Enter the BrAPI Base URL 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. Environments may be filtered by program or by trial

  11. Observation Level must be set to PLOT if you wish to collect data at the plot level

  12. Select an environment from the List.

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

  14. 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.

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

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

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

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

  19. “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

Troubleshooting with Instances using their own SSL certificate:

In some cases is possible that KSU FieldBook can't connect to the BMS instance and so is necessary to
verify the SSL certificate in the server and use the xxxx-ca-bundle file.
This was happening in the CIAT-Production instance where the SSL certificate was issued by SecTigo.
Attached the procedure to configure and verify the SSL certificate.

Related articles

/wiki/spaces/DT/pages/2477195339