Ein DeepL Benutzerkonto ist Voraussetzung und ein Pro Abo wird empfohlen: https://www.deepl.com/de/pro#developer

Quellen

Art

URL / Datei
BitBucket GIT Repositoryhttps://bitbucket.org/nuclos/localization-translator-deepl
Jar: v1.0.0https://maven.nuclos.de/repository/releases/org/nuclet/deepl/deepl-translator/1.0.0/deepl-translator-1.0.0.jar
https://repo1.maven.org/maven2/com/deepl/api/deepl-java/1.9.0/deepl-java-1.9.0.jar
Nuclet: mit den Jars der v1.0.0

Konfiguration

{
	"authKey": "please.set.your.API.KEY.here",
	"formality": "Default"
	"glossaryId": "optional.GLOSSARY.ID",
	"allowPersistentTranslation": true,
	"allowInMemoryTranslation": true,
	"allowUncachedTranslation": true,
	"logLevel": "WARN"
}

Diese Konfiguration wird Ihnen automatisch als Vorlage generiert. Nur der authKey ist für eine erste Nutzung anzupassen, alle anderen Parameter sind optional.

authKey

Bitte geben Sie an dieser Stelle Ihren API Key an.

formality

Folgende Werte erlaubt DeepL

WertBeschreibung
"Default"Standard level of formality.
"Less"Less formality, i.e. more informal.
"More"Increased formality.
"PreferLess"

Less formality, i.e. more informal, if available for the specified target language, otherwise default.

"PreferMore"Increased formality, if available for the specified target language, otherwise default.

(https://github.com/DeepLcom/deepl-java/blob/main/deepl-java/src/main/java/com/deepl/api/Formality.java)

glossaryId

Die eindeutige ID des zu verwendenden Glossars. Diese IDs werden derzeit nicht direkt auf der Seite von DeepL angezeigt: https://www.deepl.com/de/glossary

Aber wenn Sie ein Glossar zur Ansicht/Bearbeitung auswählen finden Sie die ID in der Adressleiste Ihres Browser. Hier ein Beispiel:
https://www.deepl.com/en/glossary/61a0a60e-b0f3-4e53-93d0-f05fe9a02dfb
61a0a60e-b0f3-4e53-93d0-f05fe9a02dfb wäre die zu verwendende ID.

allowPersistentTranslation

WertBeschreibung
trueDefault. Erlaubt Übersetzungen, die dauerhaft als Lokalisierungstext im System gespeichert werden.
falseBlockiert Übersetzungen die dauerhaft gespeichert werden. Hilfreich wenn zum Beispiel Tests keine zusätzlichen Kosten verursachen sollen.

allowInMemoryTranslation

WertBeschreibung
trueDefault. Erlaubt Übersetzungen, auch wenn diese nur zur Laufzeit des Servers im Speicher gehalten werden.
false

Blockiert Übersetzungen die nur zur Laufzeit im Speicher gehalten werden.

Alle Nuclos API Standard Methoden und Konstruktoren produzieren nur In-Memory Anfragen. Für eine Persistierung muss der Aufruf erweitert werden.

Diese Texte können Daten aus Businessobjekten enthalten, und das könnte ohne Überprüfung des Quellcodes auch Datenschutz relevante Inhalte betreffen, die von DeepL verarbeitet werden würden.

Wenn Sie sich unsicher sind, deaktivieren Sie diese automatisch Übersetzung an dieser Stelle mit false


allowUncachedTranslation

WertBeschreibung
trueDefault. Erlaubt Übersetzungen, auch wenn diese nicht vom Nuclos Lokalisierungsmechanismus im Speicher gehalten werden. Empfehlung für Übersetzungen von Daten.
falseBlockiert Übersetzungen die nicht im Speicher gehalten werden. Hilfreich wenn zum Beispiel Tests keine zusätzlichen Kosten verursachen sollen.

logLevel

WertBeschreibung
"OFF"Es werden keine Logmeldungen generiert.
"ERROR"Nicht DeepLExceptions werden als Fehler im Log gemeldet.
"WARN"Default. DeepLException werden zusätzlich im Log als Warning ausgegeben.
"INFO"Zusätzlich zu Fehlern werden die Ergebnisse von DeepL im Log ausgegeben.
"DEBUG"Noch mehr Informationen zu allen Requests gegen die DeepL API, jeweils vor einem Request und wenn das Ergebnis eintrifft.