知识库

返回支持概述

什么是 Frontline Connector 模板？

Frontline Connector 主要用于将客户数据集成到工作流程中，并允许与运行 Frontline Workplace 的移动设备轻松通信。它充当 Frontline 套件和客户 IT 之间的连接器。为了促进与 Frontline 的后端集成，提供了 Frontline Connector 项目模板作为开发的基础。

Frontline Connector 模板是一个 Java + Spring Boot 项目，前端部分使用 Angular。该模板附带了 Frontline Command Center API 的完整实现，并包含用于设备通信的类。 

对于 Frontline 的仓库物流解决方案 xPick，它还配备了 Vision Pick 接口（客户可以针对的接口规范）的完整实现。最后，它还包含一个文件上传界面，用于拣选订单（CSV 或 Excel 文件）和文章图像，提供无需客户端开发即可快速轻松地进行概念验证的明显优势。

先决条件

  • 关于 Java 版本和 DBMS，请参阅前线指挥中心 先决条件。
  • Node.js 16

初始设置

以下步骤允许用户从集成开发环境 （IDE） 运行 Frontline Connector 模板：

  1. 从 “下载 ”部分，下载最新的 连接器模板。
  2. 将其导入到 IDE 中（使用 IntelliJ Idea 进行测试）。 导入库时，请 swagger-codegen-cli 排除库。
  3. IDE 检测到 Maven 后：
    1. install运行生命周期阶段。
    2. compile运行生命周期阶段。
  4. 使用类创建运行配置并配置以下环境变量： = <Path to a HD Folder where the Application will store logs, configuration files etc.>   UBIMAX_HOME. IntegrationService
  5. 在调试模式下运行它。首次运行模板时，启动将失败，但将在“<UBIMAX_HOME>\config\configuration\”文件夹中创建文件 xservice.properties ，该文件夹将用于使 Frontline Connector 可配置，而无需重新编译。 需要提供以下属性：
    1. xserver.api.key：使用“sysadmin”用户访问前线指挥中心。
    2. server.ssl.enabled 和其他 SSL 属性可以像 Frontline Command Center 一样进行配置。
    3. service.port：运行 Frontline Connector 的端口。
    4. xserver.remote.address： 例如https://192.168.133.45:444，要连接到的前线指挥中心的完整 URL（主机名 + 端口，除非您使用标准端口 443）。
    5. integration-service.url：Frontline Connector 的完整 URL，例如。https://192.168.133.45:445
    6. integration-service.url.external：Frontline Connector 的完整 URL，例如，https://192.168.133.45:445 每当 Frontline Command Center 在端口 443 上运行时，此属性都是必需的。
    7. fc.db.url： 例如jdbc:mysql://<DB Hostname/IP>/<Database name>
    8. db.username， db.password
    9. 在终端中，更改为 \webapp 和 运行npm installnpm run build
  6. 设置这些属性后，初始设置应完成。 

在初始设置后运行模板

  1. 选择运行配置并在调试模式下运行它。
  2. （可选）在前端工作时，为了应用更改：在终端中更改为“\webapp”并再次运行“npm run build”

项目的第一步

与开发最相关的包是 com.teamviewer.connector.service 包。为了与运行 Frontline Workplace 的设备进行通信，将使用 RequestHandler 类，例如，对于 xInspect 或 xMake 类： service.inspection.implemention.DefaultInspectionRequestHandler

对于 Picking 用例，有两个完全实现的 RequestHandler。该类包含使用 CSV 或 Excel 订单上传时的即用型拣选逻辑实现，而 service.picking.implementation.RestBasedPickOrderRequestHandler 该类service.picking.implementation.FileBasedPickOrderRequestHandler包含视觉拣选接口的实现。

哪个 RequestHandler 从设备接收哪些消息由 ServiceController 类处理，例如： service.picking.PickOrderServiceController

为了向客户的后端发送 HTTP 请求，可以使用 TemplateHttpConnector 。

为了有一个良好的起点，您可以查看我们的 Hello Machine 示例， 该示例由一个小工作流、一个修改后的 DefaultInspectionHandler 和一个简单的 Node-Red 端点组成。在此示例中，一线工作人员在现场检查计算机。他们使用智能眼镜扫描机器上的条形码。条形码被传递给 Frontline Connector，后者又将 REST 请求发送到包含机器诊断数据的 Node-Red 端点。这些数据最终显示在智能玻璃上。

注意： 在示例中，无论扫描哪个二维码，接收到的结果数据都是相同的。