Knowledge Base

Automatische Chat-Übersetzung

Der Assist-Chat verfügt über eine Funktion, die alle eingehenden Nachrichten, die in einer anderen Sprache gesendet werden, automatisch in die bevorzugte Sprache eines Benutzers 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 xAssist-Standardrolle vorhanden sein:

xa_icall_chat_translate-Chat-Nachrichten

E-Mail-Konfiguration

E-Mail-Funktionen einrichten

In diesem Abschnitt wird beschrieben, wie Sie E-Mail-Funktionen in Vor-Ort-Installationen aktivieren.

E-Mail einrichten

Standardmäßig bietet Frontline mehrere Funktionen, die auf E-Mail basieren. Daher muss ein E-Mail-Server konfiguriert werden. Aktivieren Sie 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 die E-Mail-Adresse eingegeben werden (statt <>):

spring.mail.username=<Benutzername>
spring.mail.password=<Passwort>

Stellen Sie sicher, dass die konfigurierte E-Mail in anderen Anwendungen verwendet werden darf.

Verwenden von SendGrid

Anstatt sich mit einem E-Mail-Server zu verbinden, ist es auch möglich, den Drittanbieterdienst SendGrid zu verwenden. Verwenden Sie dazu bitte die folgenden Eigenschaften:

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

Azure-Spracherkennung

Konfigurieren Sie den Aboschlüssel und die Region in der xserver.properties:

xserver.speech.azure.enabled=true
xserver.speech.azure.version=2
xserver.speech.azure.subscription-key=[Ihr Schlüssel]
xserver.speech.azure.service-region=[Ihre Region]

Für neuere Installationen verwenden Sie:

fcc.speech.azure.subscription-key=[Ihr Schlüssel]
fcc.speech.azure.subscription-region=[Ihre Region]

Starten Sie das Frontline Command Center neu. Die Protokolldatei wird wie folgt aktualisiert:

[Hauptseite] INFO  d.u.x.s.s.s.AzureSpeechToTextHandlerV2 – Starten von Azure Speech Version 2. Dienst aktiviert?: 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

JMX-Konfiguration

Einrichten der JMX-Konfiguration

In diesem Abschnitt wird beschrieben, wie Sie JMX für On-Premise-Installationen einrichten.

Standard-JMX-Setup

Bei der Einrichtung 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 FRONTLINE_HOME Verzeichnis und bearbeiten Sie esfrontline.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

Standardeinstellung zum Aktivieren von JMX

-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 jmxremote.password Datei mit folgendem Inhalt:

monitorRolle  QED-SteuerungRolle
   F&E

Erstellen Sie eine weitere Datei jmxremote.accessmit:

monitorRole   readonly
controlRolle   readwrite

Ändern Sie den Zugriff aufjmxremote.password und jmxremote.access die Datei mit den folgenden Befehlen:

cacls jmxremote.password /P "your_username":R
cacls jmxremote.access /P "your_username":R

Wechseln Sie your_username zu einem bevorzugten Benutzer, mit dem der Dienst gestartet wird. Fügen Sie dann die Pfade hinzu frontline.xml:

-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 Frontline-Dienst fest, indem Sie die Eigenschaftendatei öffnen. Legen Sie den Benutzer auf einen Benutzer fest, der Zugriff auf die jmxremote.password Datei hat.

SSL

 Für die Verwendung von Assist ist SSL erforderlich. Ohne SSL können alle modernen Browser nicht auf das Mikrofon und die Webcam zugreifen.

Um SSL zu aktivieren, müssen vier Eigenschaften konfiguriert werden:

server.ssl.enabled=true
server.ssl.key-store=/Pfad/zum/meinen/zertifikaten/server.ks
server.ssl.key-store-password=key-store-password
server.ssl.key-password=key-password

1. Auf true setzen server.ssl.enabled 
2. Legen Sie den Pfad zu Keystore in der Eigenschaft festserver.ssl.key-store
3. Geben Sie die Passwörter in die Eigenschaften server.ssl.key-store-passwordein und server.ssl.key-password
4. Nachdem Sie SSL konfiguriert haben, ändern Sie den Serverport von 80 in 443, was dem Standard-SSL-Port  entspricht. Dies kann durch 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 anzuwenden.

MariaDB

Um MariaDB nutzen zu können, sind folgende 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 Platzhalter, die mit einem "$" gekennzeichnet sind, durch ihre tatsächlichen Werte.

Microsoft SQL Server

Frontline Command Center unterstützt Microsoft SQL Server-Datenbanken . Um eine SQL-Datenbank einzurichten, sind die folgenden 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