Erstellen der Sprachdateien

Eine Property-Datei ist im Prinzip eine einfache Text-Datei die lediglich die Endung .properties besitzt. Die Dateiendung .properties deshalb, weil es eine Java-Konfigurationsdatei ist und für den ResourceBundle-Mechanismus genutzt wird, wie er auch von Jasperreports verwendet wird. Wichtig für uns ist an dieser Stelle nur die Bezeichnung und die innere Struktur. Da es sich um Text-Dateien handelt reicht ein einfacher Texteditor aus, es muss jedoch die Möglichkeit bestehen die Dateiendung .properties festlegen zu können.

Einfacher ist es den iReport-Designer diese Arbeit erledigen zu lassen.

Erstellen einer Datei Standard.properties

Über Datei -> New öffnet sich der Dialog "New file". An dieser Stelle wird Resource Bundle gewählt. Im nächsten Dialog wird der Ort und der Name der Standard-Sprachdatei, also der Datei die default, wenn keine Sprache ausgewählt ist, verwendet wird. Wichtig: Diese ist immer in Englisch!!!
Mit dem Betätigen des Buttons "Beenden" wird die Datei im Designer angezeigt. Wie zu sehen im Bild rechts, ist das Prinzip vorgegeben. (key=value)
Für alle anfallenden Formulare wird es einen Satz Dateien geben. Es kann natürlich für jedes Formular eine eigene Datei gewählt werden. (Rechnung.properties, .... etc). Wichtig ist jedoch die eindeutige Bezeichnung des Schlüssels.

Hinzufügen eines Regionalschemas

Nachdem eine Property-Datei angelegt ist, können die regionalen Sprachen hinzugefügt werden. In diesem Beispiel sind die Schlüssel und Werte bereits gesetzt bevor eine neue Datei erzeugt wird. Selbstverständlich können die Schemata auch erst erzeugt werden und danach die Schlüssel und Werte bearbeitet werden.

Im Dateibrowser (Favoriten) des iReport-Designer wählen Sie im Kontextmenü (rechts Klick auf Bundle.properties) Hinzufügen->Regionalschema. Im folgenden Dialog wählen Sie lediglich im Feld "Sprachcode" im Kontextmenü en - Englisch. Der gesamte Arbeitsschritt wird für de Deutsch wiederholt.

Es müssen nun in dem Ordner wo Bundle.properties abgelegt wurde zwei weitere Dateien existieren, Bundle_en.properties und Bundle_de.properties.

Nachdem alle Dateien angelegt wurden sollten die Einträge im Dateibrowser (Favoriten) des iReport-Designers wie folgt aussehen:

Mit einem Rechtsklick auf Bundle.properties -> Öffnen sollte die Ansicht so aussehen:

In dieser Ansicht können nun die entsprechenden Values der Regionalschemata angepasst werden. Weiter unten im Designer (im Bild nicht zu sehen) steht eine Eingabemaske zum Hinzufügen neuer Wertepaare zur Verfügung. Dabei wird in dieser Ansicht der Schlüssel und der Wert immer in allen, hier drei, Dateien gesetzt.

Sind die Dateien fertiggestellt müssen sie zu einem Jar gepackt werden und im Nuclos eingebunden werden. hier