/
Install and set up the Field book app

Install and set up the Field book app

Search here

Domain

Core Breeding

Tool

Field Book

User Type

Member, Non-member

Role

Team Member, Data Collector

Table of Contents

Install Field Book

To get started, download and install the application on the Android device using the Google Play Store

Via Google Play Store:

  1. Open the Google Play Store and search for Field Book.

  2. Look for the Field Book app with this logo image-20240816-045857.png.

  3. Click Install and then Open.

  4. Follow the initial setup instructions on how to set up BrAPI.

Define and set up local storage for Field Book

Make sure the device is connected through wifi or mobile data while setting up, importing occurrences, and exporting/syncing trait data.

  1. Click the DEFINE button.

  2. Create a new folder for the data and name it as preferred, then click Ok. Once satisfied, click USE THIS FOLDER.

  3. If the device prompts users to allow the setting, click Allow.

    1. If the user previously used a folder with the Field Book app, click SKIP to avoid migrating old files.

    2. For any location requests, select While using the app.

  4. When asked to load sample data, click No.

  5. If prompted to enable the tutorial, click No.

Some visuals for setting up folders may vary depending on the mobile device.

Define Folder.png

Initial Field Book set-up instructions

For initial settings that require URLs, please consult the EBS experts or administrators.

  1. Go to Settings.

  2. Click BrAPI.

  3. Check the checkbox to Enable BrAPI. More settings will be displayed after enabling the option.

FB EBS1.jpg

  1. In the Auth Settings, select OIDC Flow and then click OAuth2 Implicit Grant.

  2. Set up the EBS environment:

    • Click the OIDC Discovery URL and update the current URL with the OIDC configuration.

For demo purposes, use this URL: https://cbbrapi-demo.ebsproject.org/.well-known/openid-configuration, then click OK.

BrAPI settings1 (2).png

  1. Under Configuration:

    • Click Base URL and update it with the environment Base URL.

For demo purposes, use this link: https://cbbrapi-demo.ebsproject.org, then click AUTHORIZE.

  1. Enter the EBS login credentials or use the work email registered with EBS.

  2. A message will prompt, asking, “Make this BrAPI server the default?” Check the box to enable Import and Export Source, then click Save.

image-20240818-134606.png

  1. Click Display Name and enter the preferred group name, then click OK.

  2. Once completed, click Back.

BrAPI Display name.png

Optional Field Book settings

Set up name of data collector

  1. Go to Settings then Profile.

  2. Click on Person.

  3. Enter the preferred name or team name, then click Save.

  4. Check the checkbox for Unique ID.

  5. Once completed, click Back.

Set Profile (2).png

Enable the datagrid view for collected data

  1. Go to Settings.

  2. Click on General.

  3. Check Datagrid.

  4. Once completed, click Back.

Activate Data Grid .png

Enable camera scan for QR codes

  1. Go to Settings.

  2. Click on General.

  3. Click on Move to unique identifier, then Direct Camera Scan.

  4. Once completed, click Back.

Activate Scanner.png

Great! Here are the next steps.

Import occurrences from EBS to Field Book via BrAPI.

Import occurrences to Field book

Collect data using Field Book.

Manage traits and collect data using Field book