知识库

自动聊天翻译

xAssist 聊天功能具有自动将以另一种语言发送的所有传入消息转换为用户首选语言的功能。

要设置邮件的自动翻译，需要以下配置：

xserver.translation.service.url=https：//api.cognitive.microsofttranslator.com/
xserver.translation.service.key
xserver.translation.service.region=西欧
xserver.translation.connecttimeout=10s
xserver.translation.readtimeout=10s

默认 xAssist 角色中应已存在必要的权限：

xa_icall_chat_translate聊天消息

电子邮件配置

设置电子邮件功能

本节介绍如何在本地 安装中启用电子邮件功能。

设置电子邮件

默认情况下，Frontline 提供多种基于电子邮件的功能。因此，需要配置电子邮件服务器。使用以下设置启用电子邮件功能：

spring.mail.host=smtp.example.com spring.mail.port=587
spring.mail.username=<username>
spring.mail.password=<password>
spring.mail.properties.mail.smtp.starttls.enable=true spring.mail.properties.mail.smtp.starttls.required=true
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.connectiontimeout=5000
spring.mail.properties.mail.smtp.timeout=5000


spring.mail.properties.mail.smtp.writetimeout=5000

xserver.email.notifications.enabled=true

xserver.sendgrid.enabled=false

电子邮件需要在此处输入（而不是<>）：

spring.mail.username=<用户名>
spring.mail.password=<password>

确保允许在其他应用程序中使用配置的电子邮件。

使用 SendGrid

除了连接到电子邮件服务器之外，还可以使用第三方服务 SendGrid。为此，请使用以下属性：

xserver.email.notifications.enabled=false
xserver.sendgrid.enabled=true
xserver.sendgrid.apikey=<apikey>
xserver.mail.from=<frommail>
xserver.sendgridservice.mail.from.name=<companyname>

Azure 语音转文本

在 xserver.properties:

xserver.speech.azure.enabled=true
xserver.speech.azure.version=2
xserver.speech.azure.subscription-key=[你的密钥]
xserver.speech.azure.service-region=[你的区域]

对于较新的安装，请使用：

fcc.speech.azure.subscription-key=[你的密钥]
fcc.speech.azure.subscription-region=[你的区域]

重新启动 前线指挥中心。日志文件将更新为以下内容：

[主要]INFO  d.u.x.s.s.s.AzureSpeechToTextHandlerV2 - 启动 Azure 语音版本 2。服务已启用？：true

光学字符识别

光学字符识别 （OCR） 组件将图像中的文本转换为文本。可以使用以下配置设置 OCR 组件：

xserver.ocr.service.url=https：//westeurope.api.cognitive.microsoft.com/
xserver.ocr.service.key xserver.ocr.detect.orientation=true
xserver.ocr.service.connect.timeout=5s
xserver.ocr.service.read.timeout=10s

JMX 配置

JMX 配置设置

本节介绍如何为本地安装设置 JMX。

缺省 JMX 设置

在设置JMX时，可以使用VisualVM 和 JConsole 等 可视化工具来监控Frontline Command Center的 系统性能。

要设置 JMX，请导航到 FRONTLINE_HOME 目录并进行编辑frontline.xml。

将参数修改为以下内容：

<arguments>-XX：+HeapDumpOnOutOfMemoryError -XX：HeapDumpPath=“%BASE%” -Xms1024m -Xmx1024m -Dfile.encoding=UTF-8 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=XXXX -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false -jar “%BASE%\frontline.jar”</arguments>

重新启动 服务以通过 JConsole 进行连接。

配置

默认启用 JMX

-Dcom.sun.management.jmxremote

设置访问 JMX 的端口

-Dcom.sun.management.jmxremote.port=XXXX

启用或禁用 SSL 配置

-Dcom.sun.management.jmxremote.ssl=false

启用或禁用访问 JMX 的身份验证

-Dcom.sun.management.jmxremote.authenticate=false

认证

本节介绍如何配置用户的身份验证。创建一个 jmxremote.password 包含以下内容的文件：

monitor角色  QED
控制角色   R&D

使用以下命令创建另一个文件 jmxremote.access：

monitorRole   readonly
controlRole   readwrite

使用以下命令更改对jmxremote.password 文件的访问权限 jmxremote.access 和文件：

cacls jmxremote.password /P “your_username”：R
cacls jmxremote.access /P “your_username”：R

更改 your_username 为服务将启动的首选用户。然后在里面 frontline.xml添加路径：

-Dcom.sun.management.jmxremote.access.file=path_to\jmxremote.access-Dcom.sun.management.jmxremote.password.file 
= path_to\jmxremote.password 

通过打开 属性文件来设置 Frontline Service 的用户。将“用户”设置为有权访问 jmxremote.password 该文件的用户。

SSL证书

使用 xAssist 需要 SSL。  如果没有 SSL ，所有现代浏览器都将无法访问麦克风和网络摄像头。

要启用 SSL，需要配置四个属性：

server.ssl.enabled=true
server.ssl.key-store=/Path/to/my/certificates/server.ks
server.ssl.key-store-password=密钥存储密码
server.ssl.key-password=密钥密码

1. 设置为  trueserver.ssl.enabled 
2. 在属性 中设置密钥库 的 路径server.ssl.key-store
3. 在属性 server.ssl.key-store-password中填写密码，然后 server.ssl.key-password
4. 配置 SSL 后， 将服务器端口从 80 更改为 443，这是标准 SSL 端口。这可以通过配置来完成。

服务器端口 = 443

由于端口和协议已更改，请更新外部 URL：

xserver.url.external.http=https：//an.example.com：443/
xserver.url.external.mqtt=wss：//an.example.com：443/mqtt/

容易被忽视

请确保使用 HTTPS 和 WSS ，而不是 HTTP 和 WS。

重新启动服务以应用新配置。

玛丽亚数据库

为了使用 MariaDB，需要以下配置：

xserver.db.url=jdbc：mysql：//${db.url}/${db.database}
xserver.db.user= ${db.username}
xserver.db.password= ${db.password}
spring.jpa.properties.hibernate.dialect=de.ubimax.xserver.util.ImprovedMariaDBDialect

将标有“$”的占位符替换为其实际值。

Microsoft SQL Server

一线指挥中心支持 Microsoft SQL Server 数据库。若要设置 SQL 数据库，需要以下配置：

xserver.db.url=jdbc：sqlserver：//${db.url};databaseName=${db.database}
xserver.db.user= ${db.username}
xserver.db.password= ${db.password}
xserver.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.jpa.properties.hibernate.dialect=de.ubimax.xserver.util.ImprovedSQLServer2012Dialect
spring.jpa.properties.hibernate.physical_naming_strategy=de.ubimax.xserver.util.UbimaxMSSqlNamingSchema
spring.datasource.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.jpa.hibernate.naming-strategy=de.ubimax.xserver.util.UbimaxMSSqlNamingSchema
spring.flyway.locations=classpath：db/migration/SQLServer

若要将 MS SQL 与 Active Directory 一起 使用 ，请将占位符替换为其相应的值，如以下示例所示。

替换以下命令：

xserver.db.url=jdbc：sqlserver：//${db.url};databaseName=${db.database}
xserver.db.user= ${db.username}
xserver.db.password= ${db.password}

使用以下命令：

xserver.db.url=jdbc：sqlserver：//${db.url};数据库名称=${db.database};integratedSecurity=true;trustServerCertificate=true;
xserver.db.user= 1234
xserver.db.password= 1234