你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
与服务器场活动数据提供程序集成
Azure Data Manager for Agriculture 支持连接器，以便方便地同步来自一系列服务器场机械数据源的最终用户数据。 该设置涉及 将 oAuth 流配置为与任何服务器场活动数据提供程序集成的先决条件，以及处理初始和增量数据同步的每个帐户透明同意步骤，以便使 ADMA 数据资产保持最新。
注意
步骤 1 到 3 是每个提供程序一次性的初始配置的一部分。 集成后，你将能够让所有最终用户使用现有的 oAuth 工作流，并调用每个用户的配置 API（步骤 4）来检索访问令牌。
提供程序安装程序
此处的示例流使用 Climate FieldView
步骤 1：应用创建
如果应用程序尚未注册到 Climate Fieldview，请转到 FieldView 门户 并提交表单。 一旦 FieldView 处理请求，它们就会发送你的 client_id 请求，并且 client_secret 每个 ADMA 实例对 FieldView 使用一次。
步骤 2：提供程序配置
oAuthProvider使用 API 通过新创建的应用的相应凭据创建或更新 oAuth 提供程序（例如：FIELDVIEW）。
API 文档： oAuthProviders - 创建或更新
可选步骤： 操作完成后，可以运行 oAuthProviders_Get 来验证应用程序是否已注册。 现在，在 Azure Data Manager for Agriculture 实例中创建的所有参与方都可以使用 FieldView 作为提供程序来提取服务器场活动数据。
步骤 3：终结点配置
用户重定向终结点：此终结点是希望在 oAuth 流完成后将用户重定向到的位置。 此终结点将由你生成，并将其提供给 ADMA，如 userRedirectLink oauth/tokens/：connect API 中所示。
在 Climate FieldView 门户中向应用注册 oAuth 回调终结点。
最终用户帐户设置
步骤 4：Party （最终用户） 集成
当一方（最终用户）登陆你的网页时（例如：连接到 FieldView 按钮），使用以下方式调用 oauth/tokens/:connect API 以获取 oAuth 提供程序（例如：Climate FieldView）登录 URI 以启动最终用户 oAuth 流。
API 文档：oAuthTokens - 获取 OAuth 连接ion 链接
oauth/tokens/:connect API 成功返回oauthAuthorizationLink后，最终用户单击此链接以完成 oAuth 流（例如：对于 Climate FieldView，将为用户提供 FieldView 访问许可和登录页）。 登录完成后，ADMA 会将用户重定向到客户提供的终结点（userRedirectLink）URL 中的以下查询参数
- 状态 （成功/失败）
- 状态 （用于唯一标识客户端的用户的可选字符串）
- 消息 （可选字符串）
- 参数中的 errorCode （为 Failure/error 发送的可选字符串）。
注意
如果 API 返回 404，则表示 oAuth 流失败，ADMA 无法获取访问令牌。
步骤 5：检查访问令牌信息（可选）
此步骤是可选的，仅确认对于给定用户或用户列表，是否已获取所需的有效访问令牌。 可以通过调用 API 来完成此操作，oauth/tokens以便为响应正文中的条目isValid: true检查。
API 文档： oAuthTokens - 列表
此步骤标志着用户 oAuth 流成功完成。 现在，用户已全部设置为触发新的 FarmOperationsDataJob ，开始从 Climate FieldView 拉取服务器场活动数据。