Automatische Chat-Übersetzung
Die xAssist-Chatfunktionalität verfügt über eine Funktion, die alle eingehenden Nachrichten, die in einer anderen Sprache gesendet werden, automatisch in die vom Benutzer bevorzugte Sprache umwandelt.
Um die automatische Übersetzung von Nachrichten einzurichten, sind die folgenden Konfigurationen erforderlich:
xserver.translation.service.url=https://api.cognitive.microsofttranslator.com/
xserver.translation.service.key
xserver.translation.service.region=westeurope
xserver.translation.connecttimeout=10s
xserver.translation.readtimeout=10s
Die erforderliche Berechtigung sollte bereits in der Standardrolle xAssist vorhanden sein:
xa_icall_chat_translate-chat-messages
E-Mail-Konfiguration
E-Mail-Funktionen einrichten
In diesem Abschnitt wird beschrieben, wie Sie E-Mail-Funktionen in Vor-Ort-Installationen von aktivieren.
E-Mail einrichten
Standardmäßig bietet Frontline mehrere Funktionen, die auf E-Mail basieren. Aus diesem Grund muss ein E-Mail-Server konfiguriert werden. Aktivieren Sie die E-Mail-Funktionen mit diesen Einstellungen:
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
Hier muss eine E-Mail eingegeben werden (anstelle von <>):
spring.mail.username=<username>
spring.mail.password=<password>
Stellen Sie sicher, dass die konfigurierte E-Mail in anderen Anwendungen verwendet werden darf.
SendGrid verwenden
Anstelle der Verbindung zu einem E-Mail-Server ist es auch möglich, den Drittanbieterdienst SendGrid zu verwenden. Verwenden Sie dazu bitte die unten stehenden Eigenschaften:
xserver.email.notifications.enabled=false
xserver.sendgrid.enabled=true
xserver.sendgrid.apikey=<apikey>
xserver.mail.from=<frommail>
xserver.sendgridservice.mail.from.name=<companyname>
Azure Speech To Text
Hinweis: Die folgenden Anleitungen sind nur für Vor-Ort-Installationen gedacht. Für TeamViewer Cloud-Installationen wenden Sie sich bitte an Ihren Customer Success Representative.
Hinweis: Um die Sprache-zu-Text-Funktion zu aktivieren, ist ein Azure-Konto mit Sprachdiensten erforderlich. Um mehr über Azure Services zu erfahren und Ihren Service Key zu erwerben, folgen Sie bitte diesem Link.
Konfigurieren Sie den Abonnementschlüssel und die Region in der Datei xserver.properties:
xserver.speech.azure.enabled=true
xserver.speech.azure.version=2
xserver.speech.azure.subscription-key=[your key]
xserver.speech.azure.service-region=[your region]
Für neuere Installationen verwenden:
fcc.speech.azure.subscription-key=[your key]
fcc.speech.azure.subscription-region=[your region]
Starten Sie Frontline Command Center neu. Die Protokolldatei wird mit den folgenden Angaben aktualisiert:
[main] INFO d.u.x.s.s.s.AzureSpeechToTextHandlerV2 - Starting Azure Speech Version 2. Service enabled?: true
OCR
Die OCR-Komponente (Optical Character Recognition) wandelt Text aus einem Bild in Text um. Die OCR-Komponente kann mit der folgenden Konfiguration eingerichtet werden:
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
Hinweis: Um die OCR-Funktionalität zu aktivieren, ist ein Azure-Konto mit kognitiven Diensten erforderlich. Um mehr über Azure Cognitive Services zu erfahren und Ihren Service Key zu erwerben, folgen Sie bitte diesem Link.
JMX-Konfiguration
JMX-Konfiguration einrichten
In diesem Abschnitt wird beschrieben, wie Sie JMX für On-Premise-Installationen einrichten.
Standard-JMX-Einrichtung
Beim Einrichten von JMX können Visualisierungstools wie VisualVM und JConsole verwendet werden, um die Systemleistung von Frontline Command Center zu überwachen .
Um JMX einzurichten, navigieren Sie zum Verzeichnis FRONTLINE_HOME
und bearbeitenfrontline.xml
.
Ändern Sie die Argumente wie folgt:
<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>
Starten Sie den Dienst neu , um eine Verbindung über JConsole herzustellen.
Konfiguration
Standard, um JMX zu aktivieren
-Dcom.sun.management.jmxremote
Festlegen des Ports für den Zugriff auf JMX
-Dcom.sun.management.jmxremote.port=XXXX
Aktivieren oder Deaktivieren der SSL-Konfiguration
-Dcom.sun.management.jmxremote.ssl=false
Aktivieren oder Deaktivieren der Authentifizierung für den Zugriff auf JMX
-Dcom.sun.management.jmxremote.authenticate=false
Authentifizierung
In diesem Abschnitt wird beschrieben, wie Sie die Authentifizierung von Benutzern konfigurieren. Erstellen Sie eine Datei jmxremote.password
mit dem Inhalt:
monitorRole QED
controlRole R&D
Erstellen Sie eine weitere Datei jmxremote.accesswith
:
monitorRole readonly
controlRole readwrite
Ändern Sie den Zugriff auf die Datei jmxremote.password
und jmxremote.access
mit diesen Befehlen:
cacls jmxremote.password /P “your_username”:R
cacls jmxremote.access /P “your_username”:R
Ändern Sie your_username
in einen bevorzugten Benutzer, mit dem der Dienst gestartet werden soll. Fügen Sie dann die Pfade in frontline.xml
ein:
-Dcom.sun.management.jmxremote.access.file=path_to\jmxremote.access
-Dcom.sun.management.jmxremote.password.file= path_to\jmxremote.password
Legen Sie einen Benutzer für den Dienst Frontline fest, indem Sie die Eigenschaftsdatei öffnen. Legen Sie als Benutzer einen Benutzer fest, der Zugriff auf die Datei jmxremote.password
hat.
SSL
Für die Verwendung von xAssist ist SSL erforderlich. Ohne SSL sind alle modernen Browser nicht in der Lage, auf das Mikrofon und die Webcam zuzugreifen.
Um SSL zu aktivieren, müssen vier Eigenschaften konfiguriert werden:
server.ssl.enabled=true
server.ssl.key-store=/Path/to/my/certificates/server.ks
server.ssl.key-store-password=key-store-password
server.ssl.key-password=key-password
server.ssl.enabled
auf true setzen- Legen Sie den Pfad zum Keystore in der Eigenschaft
server.ssl.key-store
fest - Tragen Sie die Kennwörter in die Eigenschaften
server.ssl.key-store-passwordund
server.ssl.key-password
ein. - Nachdem Sie SSL konfiguriert haben , ändern Sie den Server-Port von 80 auf 443, den Standard-SSL-Port . Dies kann über die Konfiguration erfolgen.
server.port=443
Da sich der Port und das Protokoll geändert haben, aktualisieren Sie die externen URLs:
xserver.url.external.http=https://an.example.com:443/
xserver.url.external.mqtt=wss://an.example.com:443/mqtt/
Leicht zu übersehen
Stellen Sie sicher, dass Sie HTTPS und WSS anstelle von HTTP und WS verwenden .
Starten Sie den Dienst neu, um die neuen Konfigurationen zu übernehmen.
MariaDB
Für die Verwendung von MariaDB sind die folgenden Konfigurationen erforderlich:
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
Ersetzen Sie die mit einem "$
" gekennzeichneten Platzhalter durch ihre tatsächlichen Werte.
Microsoft SQL-Server
Frontline Command Center unterstützt Microsoft SQL Server-Datenbanken. Um eine SQL-Datenbank einzurichten, sind folgende Konfigurationen erforderlich:
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
Um MS SQL mit Active Directory zu verwenden, ersetzen Sie die Platzhalter durch die entsprechenden Werte, wie im folgenden Beispiel gezeigt.
Ersetzen Sie diesen Befehl:
xserver.db.url=jdbc:sqlserver://${db.url};databaseName=${db.database}
xserver.db.user= ${db.username}
xserver.db.password= ${db.password}
Mit diesem Befehl:
xserver.db.url=jdbc:sqlserver://${db.url};databaseName=${db.database};integratedSecurity=true;trustServerCertificate=true;
xserver.db.user= 1234
xserver.db.password= 1234