DocumentationWorkflowsApps et services
DeepL : traduire node
Traduit du texte avec DeepL. Tout passe par l'accès DeepL d'anymize, tu n'as pas besoin de ta propre clé. Facturé au caractère, et le bloc indique les crédits consommés. Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.
8 min de lectureMis à jour le
Fonction du node
Traduit du texte avec DeepL. Tout passe par l'accès DeepL d'anymize, tu n'as pas besoin de ta propre clé. Facturé au caractère, et le bloc indique les crédits consommés.
Utilisez DeepL : traduire comme étape clairement définie dans un workflow anymize.
- Traite 1 entrée.
- Fournit 1 sortie aux étapes suivantes.
- S'exécute comme une étape normale du workflow.
Configurer le node
- 01Ouvrez un workflow et ajoutez DeepL : traduire depuis le catalogue.
- 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
- 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
- 04Reliez la sortie réussie et activez le workflow après un test complet.
Actions et modes
DeepL : traduire remplit une fonction précise. Ses paramètres apparaissent lorsque vous sélectionnez le node.
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Texte | Ce qui doit être traduit. Fais glisser un champ depuis le panneau d'entrée ou écris un texte fixe. Si tu laisses vide, le bloc prend le texte de l'élément entrant, y compris celui d'un fichier texte joint (txt, csv, md, json, html). | Standard |
| Langue cible | Vers quelle langue traduire. Si la langue vient des données, bascule le champ en mode expression (en haut à droite) et écris par exemple {{ $json.target_lang }}. | Standard |
| Anonymiser avant l'envoi | Activé (par défaut) : noms, adresses, numéros et autres données personnelles sont remplacés par des marqueurs avant que le texte parte chez DeepL, puis rétablis dans la traduction. DeepL ne voit jamais les données en clair. Sans coût supplémentaire. Ne le désactive que pour un texte dont tu es sûr qu'il ne contient rien de personnel. | Standard |
| Langue source | À laisser en général sur « Détection automatique » : DeepL trouve la langue source tout seul. Ne la fixe que si le texte est court ou mélange plusieurs langues. | Standard |
| Registre | Formel ou familier. N'a d'effet que dans les langues qui font la distinction (allemand, français, espagnol, italien, néerlandais, polonais, portugais, japonais, russe) - ailleurs DeepL l'ignore. | Standard |
| Protéger les marqueurs d'anonymisation | Activé (par défaut) : les marqueurs de la forme [[catégorie-hash]] sont encapsulés pour que DeepL les ignore et les rende inchangés. Ne le désactive que si tu es sûr qu'il n'y en a aucun. | Standard |
| Joindre la traduction en fichier texte | Ajoute aussi la traduction en .txt à l'élément, pour que les blocs suivants puissent la transmettre comme fichier - en pièce jointe d'un e-mail ou en dépôt dans un espace de stockage. | Standard |
| Exécuter une fois par élément | Désactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée. | Standard |
| Si un élément échoue | « Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible. | Standard |
| Pause entre les éléments (millisecondes) | Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes). | Standard |
Entrées et sorties
| Entrée | Signification | Type |
|---|---|---|
| text | Texte à traduire. Remplace le champ de configuration. | text |
| target_lang | Langue cible sous forme de code DeepL, par ex. EN-US. Remplace le champ de configuration. | text |
| Sortie | Signification | Type |
|---|---|---|
| text | La traduction. | text |
| detected_source_lang | Langue détectée par DeepL dans le texte source. | text |
| target_lang | Langue vers laquelle la traduction a été faite. | text |
| billed_characters | Caractères facturés par DeepL. Base de calcul des crédits. | number |
| credits | Crédits consommés par cette étape. | number |
| input_text | Le texte source, inchangé. | text |
| anonymized | true si le texte a été anonymisé avant d'aller chez DeepL. | boolean |
| anonymized_input | Exactement le texte reçu par DeepL. Avec l'anonymisation active, c'est le texte à marqueurs. | text |
| placeholders | Nombre de marqueurs posés par le bloc. | number |
| restored_placeholders | Combien d'entre eux ont été remplacés par les valeurs d'origine dans la traduction. | number |
Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.
Exemple et test
Traduire une demande client: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.
Exemple de test
{
"text": "Guten Tag, wir bitten um ein Angebot für 20 Lizenzen zum 1. Oktober.",
"target_lang": "EN-US"
}Accès et sécurité
Avant l'activation, vérifiez les données reçues par cette étape et le contenu de sa sortie.
Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.
Résoudre les erreurs
- Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
- Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
- Liste traitée une seule fois: activez l'exécution par élément.