v27 BMS and Fieldbook app v5.6.22 data transfer via BrAPI using OIDC OAuth 2 (v27 BMS 使用 OIDC OAuth 2 通过 BrAPI 与 Fieldbook （v5.6.22） 连接)
BMS version 27 has been thoroughly tested and confirmed as compatible with the specific Fieldbook version indicated on this page title. The use of other/newer Fieldbook versions downloaded from Github is at your own risk.
BMS 版本 27 已经过全面测试，并确认与本页标题中指示的特定 Fieldbook 版本兼容。使用从Github下载的其他/较新的 Fieldbook 版本需要您自行承担风险。
About Fieldbook app (关于 Fieldbook 应用程序)
Fieldbook is an application that can be installed on Android tablets and phones. It was developed to work primarily on a tablet, but its performance on phones is very good.
Fieldbook App connects to BMS using BrAPI or export/import of Studybook files.
Fieldbook 是一款可安装在 Android 平板电脑和手机上的应用程序。它主要针对平板电脑开发，但在手机上的表现也非常出色。
田间笔记本（Fieldbook App） 可以通过BrAPI或导出/导入 Studybook 文件与BMS。
Citation : Rife, T.W.and J.A.Poland (2014) Field Book: An Open Source Application for Field Data Collection on Android. Crop Sci.54(4): 1624 – 1627.
引用：Rife, TWand JAPoland (2014) Field Book：一款用于 安卓系统 上的田间数据收集的开源应用程序。Crop Sci。54(4): 1624 – 1627。
Instructions (指南)
Open the Fieldbook Application and go to Settings.
打开 Fieldbook 应用程序并转到“设置” 。Under Settings, go to BrAPI.
在设置下，转到BrAPI 。Enable BrAPI to access its configuration.
启用 BrAPI 以访问其配置。Go to BrAPI Version and select option V2.
转到BrAPI 版本并选择选项V2 。Under Auth Settings, open OIDC Flow then select the option OAuth2 Implicit Grant
在Auth Settings下，打开OIDC Flow ，然后选择 选项OAuth2 Implicit GrantOpen OIDC Discovery URL (the location of the OIDC discovery JSON document).
打开OIDC Discovery URL （OIDC 发现 JSON 文档的位置）。Scan a barcode with the URL or define it as https://www.<institute’s BMS URL address>/bmsapi/<crop name>/.well-known/openid-configuration, for this tutorial use: https://trial-as.ibp.services/bmsapi/rice/.well-known/openid-configuration
Click OK.
使用 URL 扫描条形码或将其定义为https://www. <研究所的 BMS URL 地址> /bmsapi/ <作物名称> /.well-known/openid-configuration，本教程使用：https://trial-as.ibp.services/bmsapi/rice/.well-known/openid-configuration
单击“确定OK”。Open Base URL. Scan a barcode with the URL or enter the BrAPI Base URL https://<institute’s BMS address>/bmsapi/<crop name> . In this tutorial use : https://trial-as.ibp.services/bmsapi/rice/
打开基本 URL 。使用 URL 扫描条形码或输入 BrAPI 基本 URL https:// <研究所的 BMS 地址> /bmsapi/ <作物名称>。Click Authorize.
单击授权It will launch the BMS Authorization page on a web browser of the Android device. Enter the BMS login Name and Password and click on Sign In.
它将在 Android 设备的 Web 浏览器上启动 BMS 授权页面。输入 BMS 登录名和密码，然后单击“登录” 。Click Authorize.
单击“授权”。Click Import Source and Export Source to the BrAPI server as default Import and Export Source. Click Save.
点击导入源和导出源，将 BrAPI 服务器作为默认的导入和导出源。点击保存。To get the studybook (Fields) instances, return to main screen and then click on FIELDS.
要获取学习手册（Fields）实例，请返回主屏幕，然后单击FIELDS。To add environment instance into Fieldbook. Click on the +.
要将环境实例添加到 Fieldbook。单击+。Environments may be filtered by program or by trial. Select Filter by program.
可以按程序或试用筛选环境。选择按程序筛选。Select Rice Demo Program. Click Select Program.
选择Rice Demo Program。点击Select Program 。Observation Level must be set to PLOT if you wish to collect data at the plot level
如果您希望在地块级别收集数据，则必须将观察级别设置为地块Select an environment from the List.
从列表中选择一个环境。Click Preview Field. This allows users to check the field before saving. Click Save.
单击预览字段。这允许用户在保存之前检查字段。单击保存。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.
点击“性状”选择要测量的性状。请注意，其他领域/环境的特质也将出现在性状列表中To start entering observed values, click “COLLECT”.
要开始输入观察值，请单击“收集”。Collected observation values can be exported to BMS by clicking Export.
导出，可以将收集的观察值导出到BMS 。The number of new or modified observations will be shown. In this example, 8 New Observations have been collected. Click Export.
将显示新的或修改的观测值的数量。在此示例中，已收集了 8 个新观测值。单击导出。“BrAPI Export Successful” message shows up if the export is successful.
如果导出成功，则会显示“BrAPI 导出成功”消息。When you go back to BMS, the observation tab will be highlighted with an orange line to show that the observations has pending data.
当您返回 BMS 时，观察选项卡将以橙色线突出显示，以显示观察具有待处理数据。Click Accept to update the BMS trial with the collected data from Fieldbook.
单击“接受”以使用从 Fieldbook 收集的数据更新 BMS 试验。
Other Fieldbook Installation and Settings instructions (其他 Fieldbook 安装和设置说明):
In the General Settings, set the Default import and export source as BrAPI.
在常规设置中，将默认导入和导出源设置为BrAPI
Installation from downloaded .apk file (从下载的 .apk 文件安装)
Download APK file for Fieldbook-v5.6.22. It will usually go to the downloads folder.
下载APK文件 Fieldbook-v5.6.22 。它通常会进入下载文件夹。Click on the file <Field-Book-version.apk>
点击文件 <Field-Book-version.apk>Click install
点击安装Open the app.
打开应用程序。Specify a Storage Location by clicking Choose a folder.
单击“选择文件夹”指定存储位置。Select the permission to allow access to photos and videos.
选择允许访问照片和视频的权限。Select or create a new folder for Fieldbook to use. Click CREATE NEW FOLDER.
选择或创建一个供 Fieldbook 使用的新文件夹。单击“创建新文件夹” 。Type-in the name of the folder. Click OK.
输入文件夹的名称。单击“确定” 。Click Use this Folder.
单击“使用此文件夹” 。Click Allow to allow access to the newly created folder.
单击“允许”以允许访问新创建的文件夹。Click permissions. Best to use While using the app.
在使用应用程序时使用。
Alternative workflow: OIDC OAuth 2 (工作流程：OIDC OAuth 2)
For this flow to work it’s mandatory to provide either an environment property BASE_URL or set the property directly in
bmsapi/WEB-INF/classes/application.properties. This is needed for BMSAPI to know the public url in cases where it’s running behind a proxy.For the moment this flow only works in https
工作流程：OIDC OAuth 2
为了使此流程正常工作，必须提供环境属性BASE_URL或直接在b
msapi/WEB-INF/classes/application.properties中设置该属性。这是为了让 BMSAPI 在代理后面运行时知道公共 URL。目前此流程仅适用于https
Important: Android supported links (重要信息：Android 支持的链接)
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
对于链接http://fieldbook.phenoapps.org 确保 Android 设置“打开支持的链接”设置为在此应用中打开，而不是“每次询问”
Related articles
https://ibplatform.atlassian.net/wiki/spaces/DT/pages/2477195339