Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Auszug
hiddentrue

Nuclos Regeln lokalisieren: BusinessException, InputRequiredException, MessageContext, Lokalisierungsschlüssel, Locale, withArgs, DoNotTranslate.

globe with meridians Sprache: Deutsch · English

hammer and wrench Regeln lokalisieren

Regelmeldungen übersetzbar machen – BusinessException, InputRequiredException und MessageContext mit Schlüsseln, Locale und Platzhaltern.

Status
colourPurple
titleHow-to
Status
colourBlue
titleAnwendungsentwickler
Status
colourGreen
titleStand: Jul 2026
Status
colourGrey
titlegilt fuer Nuclos 4.2026.x

Panel
bgColor#F4F5F7

Auf dieser Seite

Inhalt
maxLevel2
minLevel2

Überblick

Regelmeldungen an den Benutzer lassen sich seit v4.2025.15 lokalisieren. Unterstützung bieten die Klassen BusinessException, InputRequiredException und MessageContext. Übergib nach Möglichkeit immer eine Locale – sonst versucht Nuclos, das Nuclet über das Package zu ermitteln.

Der schnelle Weg

Für statische Texte: automatische Schlüsselerzeugung per Boolean-Flag true.

Codeblock
languagejava
hier
Codeblock
languagejava
throw new BusinessException(new DoNotTranslate(machineApi.getErrorMessage()));

Der optimale Weg

Vergib einen festen, eindeutigen Lokalisierungsschlüssel. So kannst du den Ausgangstext später ändern, ohne dass Übersetzungen komplett neu aufgebaut werden.

Codeblock
languagejava
throw new BusinessException(new DoNotTranslate(machineApi.getErrorMessage()));

Lokalisierung verhindern

Text als DoNotTranslate-Objekt übergeben:

Codeblock
languagejava
throw new BusinessException(new DoNotTranslate(machineApi.getErrorMessage()));

Meldungen parametrisieren

Dynamische Teile über withArgs/withMessageArgs – übersetzt wird nur das Template mit {}-Platzhaltern:

Codeblock
languagejava

Verwandte Seiten

globe with meridians Lokalisierung


Übersicht.

Öffnen →

gear Regelwerke


Regeln.

Öffnen →

electric plug Unterstützende Klassen


Regel-API.

Öffnen →