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.

Auf dieser Seite

Ü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.

hier
throw new InputRequiredException(
				new InputSpecification(InputSpecification.CONFIRM_YES_NO, "my.nuclet.input.key.1",
"Soll eine Bestätigung gesendet werden?", "Rückfrage")); // vor v4.2025.15
throw new InputRequiredException(
				new InputSpecification(InputSpecification.CONFIRM_YES_NO, "my.nuclet.input.key.1",
true, "Soll eine Bestätigung gesendet werden?", "Rückfrage", Locale.GERMAN)); // ab v4.2025.15

Der optimale Weg

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

MessageContext.sendMessage("Das Formular wurde erzeugt und im Laufwerk abgelegt."); // vor v4.2025.15
MessageContext.sendMessage(true, "Das Formular wurde erzeugt und im Laufwerk abgelegt."); // ab v4.2025.15

Lokalisierung verhindern

Text als DoNotTranslate-Objekt übergeben:

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

Meldungen parametrisieren

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

MessageContext.sendMessage("Das Formular wurde erzeugt und im Laufwerk abgelegt."); // vor v4.2025.15
MessageContext.sendMessage("org.nuclet.handel.pdf-created-and-stored", "Das Formular wurde erzeugt und im Laufwerk abgelegt.", /*no-title*/null, Locale.GERMAN); // ab v4.2025.15

Verwandte Seiten

globe with meridians Lokalisierung


Übersicht.

Öffnen →

gear Regelwerke


Regeln.

Öffnen →

electric plug Unterstützende Klassen


Regel-API.

Öffnen →