DokumentationWorkflowsApps und Services
DeepL: Übersetzen Node
Übersetzt Text mit DeepL. Läuft über den DeepL-Zugang von anymize, du brauchst keinen eigenen Schlüssel. Abgerechnet wird nach Zeichen, der Baustein gibt die verbrauchten Credits mit aus. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
8 Min LesezeitAktualisiert am
Was DeepL: Übersetzen macht
Übersetzt Text mit DeepL. Läuft über den DeepL-Zugang von anymize, du brauchst keinen eigenen Schlüssel. Abgerechnet wird nach Zeichen, der Baustein gibt die verbrauchten Credits mit aus.
- Verarbeitet einen Eingang.
- Stellt einen Ausgang für weitere Schritte bereit.
- Wird als normaler Schritt in den Ablauf eingebunden.
Node einrichten
- 01Öffne einen Workflow und füge „DeepL: Übersetzen“ über Bausteine hinzu.
- 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
- 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
- 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.
Aktionen und Betriebsarten
DeepL: Übersetzen hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.
Einstellungen
| Feld | Bedeutung | Bereich |
|---|---|---|
| Text | Was übersetzt werden soll. Zieh ein Feld aus dem Input-Panel hierher oder schreib einen festen Text. Bleibt das Feld leer, nimmt der Baustein den Text aus dem eingehenden Item - auch aus einer angehängten Textdatei (txt, csv, md, json, html). | Standard |
| Zielsprache | In welche Sprache übersetzt wird. Kommt die Sprache aus den Daten, stell das Feld oben rechts auf Ausdruck um und schreib zum Beispiel {{ $json.target_lang }}. | Standard |
| Vor dem Senden anonymisieren | An (Standard): Namen, Adressen, Nummern und andere personenbezogene Daten werden durch Platzhalter ersetzt, bevor der Text an DeepL geht, und in der Übersetzung wieder durch die Originalwerte ersetzt. DeepL sieht damit keine Klardaten. Kostet nichts extra. Aus nur für Texte, bei denen du sicher bist, dass nichts Personenbezogenes drinsteht. | Standard |
| Quellsprache | Normalerweise auf „Automatisch erkennen“ stehen lassen: DeepL findet die Ausgangssprache selbst. Setz sie nur, wenn der Text kurz ist oder mehrere Sprachen mischt. | Erweitert |
| Anrede | Förmlich oder locker. Wirkt nur in Sprachen, die das unterscheiden (Deutsch, Französisch, Spanisch, Italienisch, Niederländisch, Polnisch, Portugiesisch, Japanisch, Russisch) - sonst ignoriert DeepL die Einstellung. | Erweitert |
| Anonymisierte Platzhalter schützen | An (Standard): Platzhalter der Form [[Kategorie-hash]] werden für DeepL unsichtbar verpackt und kommen unverändert zurück. Nur ausschalten, wenn du sicher weißt, dass im Text keine stehen. | Erweitert |
| Übersetzung als Textdatei anhängen | Legt die Übersetzung zusätzlich als .txt an das Item, damit Folge-Bausteine sie als Datei weiterreichen können - zum Beispiel als E-Mail-Anhang oder Upload in eine Ablage. | Erweitert |
| Für jedes Item einzeln ausführen | Aus (Standard): der Node läuft einmal für den gesamten Input. An: bekommt er mehrere Items (z. B. aus „Liste aufteilen“), läuft er einmal PRO Item, und {{ $json }} ist dabei jeweils genau dieses Item. So arbeitest du eine Dateiliste Eintrag für Eintrag ab. | Erweitert |
| Wenn ein Item fehlschlägt | „Überspringen“ schreibt für das fehlgeschlagene Item ein `error`-Feld und verarbeitet die übrigen weiter, statt den ganzen Lauf an einer einzigen unlesbaren Datei scheitern zu lassen. | Erweitert |
| Pause zwischen Items (Millisekunden) | Wartezeit vor jedem Durchlauf außer dem ersten. 1000 = 1 Sekunde pro Item. Nützlich, wenn die Gegenstelle sonst dichtmacht. Maximal 300000 (5 Minuten). | Erweitert |
Eingaben und Ausgaben
| Eingabe | Bedeutung | Typ |
|---|---|---|
| text | Text, der übersetzt werden soll. Überschreibt das Konfig-Feld. | text |
| target_lang | Zielsprache als DeepL-Code, z. B. EN-US. Überschreibt das Konfig-Feld. | text |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| text | Die Übersetzung. | text |
| detected_source_lang | Sprache, die DeepL im Ausgangstext erkannt hat. | text |
| target_lang | Zielsprache, in die übersetzt wurde. | text |
| billed_characters | Zeichen, die DeepL berechnet hat. Grundlage der Credits. | number |
| credits | Credits, die dieser Schritt gekostet hat. | number |
| input_text | Der Ausgangstext, unverändert. | text |
| anonymized | true, wenn der Text vor DeepL anonymisiert wurde. | boolean |
| anonymized_input | Genau der Text, den DeepL bekommen hat. Bei aktiver Anonymisierung der Platzhaltertext. | text |
| placeholders | Wie viele Platzhalter der Baustein gesetzt hat. | number |
| restored_placeholders | Wie viele davon in der Übersetzung wieder durch die Originalwerte ersetzt wurden. | number |
Dieser Node kann Listen Item für Item verarbeiten. Fehlerbehandlung und Pause zwischen Items findest du in den erweiterten Einstellungen.
Beispiel und Testlauf
Kundenanfrage übersetzen: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.
Beispiel für einen Testlauf
{
"text": "Guten Tag, wir bitten um ein Angebot für 20 Lizenzen zum 1. Oktober.",
"target_lang": "EN-US"
}Zugriff und Sicherheit
Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.
Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.
Häufige Fehler beheben
- Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
- Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
- Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.