Frontline コネクターテンプレートとは何ですか?
Frontline Connectorは、主に顧客データをワークフローに統合するために使用され、Frontline Workplaceを実行するモバイルデバイスとの容易な通信を可能にします。これは、Frontline スイートと顧客 IT 間のコネクタとして機能します。Frontline とのバックエンド統合を容易にするために、Frontline Connector プロジェクトテンプレートが開発の基礎として提供されます。
Frontline ConnectorテンプレートはJava + Spring Bootプロジェクトで、フロントエンド部分にAngularを使用しています。このテンプレートには、Frontline Command Center APIの完全な実装が付属しており、デバイス通信用のクラスが含まれています。
Frontline の倉庫物流ソリューションであるxPickには、さらにVision Pick Interface(顧客が開発できるインターフェース仕様)の完全な実装が付属しています。最後に、ピッキング・オーダー(CSVまたはExcelファイル)と記事画像のためのファイル・アップロード・インターフェースも含まれており、迅速で簡単な概念実証のために顧客側の開発を必要としないという明確な利点があります。
前提条件
- JavaバージョンとDBMSに関しては、Frontline Command Centerのシステム要件と 前提条件を参照してください。
- Node.js 16
初期設定
以下の手順により、ユーザは統合開発環境(IDE)からFrontline Connector テンプレートを実行できます:
- ダウンロード セクションから、最新のコネクタテンプレートをダウンロードします。
- IDEにインポートする(IntelliJ Ideaでテスト)。ライブラリをインポートするときは、
swagger-codegen-cli
ライブラリを除外します。 - IDEがMavenを検出したら
インストールライフサイクルフェーズを
実行する。コンパイル・
ライフサイクル・フェーズを実行する。
IntegrationService
クラスを使用して実行設定を作成し、以下の環境変数を設定します: UBIMAX_HOME
=<アプリケーションがログや設定ファイルなどを保存するHDフォルダへのパス>.
- デバッグモードで実行する。テンプレートを最初に実行すると、スタートアップは失敗しますが、"<UBIMAX_HOME>configuration "フォルダにxservice.propertiesファイルが作成され、再コンパイルすることなくFrontline Connectorを設定可能にするために使用されます。以下のプロパティを提供する必要があります:
- xserver.api.key:sysadmin "ユーザーでFrontline コマンドセンターにアクセスしてください。ユーザーを作成し、"Technical User "トグルを有効にしてください。その後、そのユーザーにすべてのロールを割り当ててください。ユーザーを保存した後、ユーザーリストからユーザーをダブルクリックして、ユーザーの詳細を再度開きます。詳細にはAPIキーが含まれています。
- server.ssl.enabled およびその他のSSLプロパティは、Frontline コマンドセンターと同様に設定できます。
- service.port:Frontline コネクタが実行されるポート。
- xserver.remote.address:接続するFrontline コマンドセンターの完全な URL (ホスト名 + ポート。標準のポート 443 を使用している場合を除く)。たとえば
、https://192.168.133.45:444。
- integration-service.url:Frontline Connectorの完全なURL。例えば
、https://192.168.133.45:445。
- integration-service.url.external:Frontline コネクタの完全な URL。たとえば
、
https://192.168.133.45:445 このプロパティは、Frontline コマンドセンターがポート 443 で実行される場合は常に必要です。 - fc.db.url: 例えば
、jdbc:mariadb://<DBホスト名/IP>/<データベース名>
です。 - db.username, db.password
- ターミナルで
npm installと
npm run buildを
実行する。
- これらのプロパティを設定した後、初期設定は終了するはずです。
初期設定後のテンプレートの実行
- 実行設定を選択し、デバッグモードで実行する。
- (オプション) フロントエンドで作業する場合、変更を適用するために、ターミナルで" \webapp" に変更し、再度 "npm run build" を実行する。
プロジェクトの第一歩
開発に最も関連するパッケージはcom.teamviewer.connector.service パッケージです。Frontline Workplace を実行しているデバイスと通信するために、RequestHandler
クラスが使用されます。たとえば、xInspect や xMake では、次のクラスが使用されます。
ピッキングのユースケースには、完全に実装された2つのRequestHandlerがあります。service.picking.implementation.FileBasedPickOrderRequestHandler
クラスには、CSVまたはExcelのオーダーアップロードを使用する際にすぐに使用できるピッキングロジックの実装が含まれており、service.picking.implementation.RestBasedPickOrderRequestHandlerには
、Vision Pickインターフェースの実装が含まれています。
どのRequestHandlerがデバイスからどのメッセージを受け取るかは、ServiceController
クラスで処理される。
顧客のバックエンドに HTTP リクエストを送信するには、TemplateHttpConnector を使用します。
小さなワークフロー、修正された DefaultInspectionHandler、シンプルなNode-Redエンドポイントで構成されている。 この例では、Frontline Worker が現場で機械を検査する。彼らは、スマートグラスを使って機械からバーコードをスキャンする。バーコードはFrontline コネクタに渡され、コネクタはマシン診断データを含む REST リクエストを Node-Red エンドポイントに送信する。このデータは最終的にスマートグラスに表示される。
注:この例では、どのQRコードをスキャンしても、結果として受信されるデータは同じです。