XML Datei für dynamische Texte
Zur Verwendung von dynamischen Texten sehen Sie die Beschreibung für den Dialog 'Einstellungen', Kategorie Sprache. Die zugrunde liegende Datei muss im XML-Format vorliegen (<dateiname>.xml). Sie enthält eine Zuordnung von Texten zu Prefix-ID-Kombinationen, die im Visualisierungselement angegeben werden können. Außerdem können in einer Header-Section eine Default-Sprache und ein einer Sprache zugeordneter Default-Font definiert werden. Die Beschreibungen in der XML-Datei werden von den Tags <dynamic_text> und <\dynamic_text> am Beginn und Ende der Datei eingeschlossen.
Die Sprachdateien für dynamische Texte können in Unicode (UTF-16) oder ANSI (ISO-8859-1) erstellt werden. Dies ist über die encoding-Syntax vor dem Header der xml-Datei anzugeben (siehe unten, Datei-Beispiel).
 | Ursprüngliche Formate der XML-Datei, die noch kein <dynamic_text>-Tag und keine Header-Sektion verwenden, werden auch weiterhin unterstützt. Die Target-Visualisierung bietet eine Schnittstelle zum Abfragen der Einträge dynamischer Textlisten. Somit können diese dann direkt im Programm verwendet werden. |
Die Header-Section beginnt mit <header> und wird mit <\header> abgeschlossen. Soll eine Default-Sprache festgelegt werden, fügen Sie hier den Eintrag <default-language> ein. Ein einer Sprache zugehöriger Default-Font wird über den Eintrag <default-font> festgelegt. Die Einträge sind optional, wenn sie fehlen, wird der dynamische Text in der Visualisierung in der/dem lokal konfigurierten Sprache bzw. Font angezeigt.
<header> |
|
<default-language><Sprachkürzel> </default-language> | Angabe der Default-Sprache; das heißt, wenn für einen Texteintrag (s.u.) kein Text in der eingestellten Sprache vorhanden ist, wird der Text verwendet, der im gleichen Texteintrag unter dem Kürzel der Default-Sprache definiert ist. Wenn auch ein solcher nicht vorliegt, wird "<PREFIX> <ID>“ ausgegeben. Werden mehrere XML-Dateien verwendet, die jeweils eine Header-Section enthalten, wird diejenige berücksichtigt, die zuletzt gelesen wird. Sinnvoll ist es, nur 1 Header-Section zu verwenden ! Das Sprachkürzel sollte einem der beiden Texteinträgen verwendeten entsprechen (s.u.). Anmerkung: Die Default-Sprache kann zur Laufzeit gezielt mit Hilfe eines Visualisierungselements eingestellt werden, das mit dem Befehl INTERN LANGUAGE DEFAULT in Kategorie Eingabe, Programm ausführen konfiguriert wurde (siehe Kap. 2.4.1, Spez. Eingabemöglichkeiten für Bedienversionen). |
<default-font> | Angabe des Default-Fonts für eine bei <language> angegebene Sprache.: Der mit der Font-Bezeichnung angegebene Font (z.B. "Arial" wird automatisch für alle Elemente verwendet, welche dynamische Texte in dieser Sprache ausgeben. Das Sprachkürzel sollte einem der beiden Texteinträgen verwendeten entsprechen (s.u.) |
<language><Sprachkürzel> </language>
| |
<font-name><Font-Bezeichnung></font-name> | |
<default-font> | |
</default-font> | weitere Default-Fonts für andere Sprachen |
<language>... | |
... | |
<default-font> | |
... | |
</header> |
|
Die Liste der Zuordnungen zwischen Prefix-ID und Texten wird mit <text-list> eröffnet und mit <\text-list> abgeschlossen. Die einzelnen Zuordnungen beginnen jeweils mit <text prefix> und enden mit <\text>.
Ein Texteintrag für eine Prefix-ID-Kombination enthält folgende Zeilen:
<text prefix>= "<PREFIX> id="<ID>" | " Das hier verwendete "PREFIX" entspricht dem im Visualisierungselement (Konfigurationskategorie Text) verwendeten; Die "ID" entspricht dem Eintrag in Konfigurationskategorie 'Variablen', Textausgabe |
<Sprachkürzel> <!CDATA[<TEXT>] </Sprachkürzel> | Das frei wählbare Sprachkürzel wird im Dialog 'Einstellungen', Kategorie Sprache des Visualisierungselements dann in der Auswahlliste bei 'Sprache' wiedergegeben; der "TEXT" ist der, der im Online Modus anstelle der oben definierten ID-PREFIX-Kombination im Visualisierungselement angezeigt wird. |
</text> |
|
Zumindest in 1 Landessprache muss pro Prefix-ID-Kombination ein Texteintrag vorliegen. Sehen Sie z.B. im unten gezeigten Dateibeispiel: <deutsch> startet den Text in deutscher Sprache, </deutsch> beendet ihn.
Die dynamischen Texte können zum einen zur Darstellung eines Textes in verschiedenen Sprachen dienen, aber natürlich auch, um verschiedene Inhalte dynamisch anzuzeigen.
Beispiel:
Sie verwenden zwei Visualisierungselemente, eins für die Anzeige einer Maschinenbezeichnung, das andere für die Anzeige eines Fehlertextes zu einer bestimmten Fehlernummer:
(1) Definieren Sie in PLC_PRG die Variablen ivar vom Typ INT, die die Maschinenbezeichnung festlegt und errnum vom Typ INT, die die Fehlernummer liefert.
(2) Konfigurieren Sie ein Visualisierungselement zur Anzeige der aktuellen Maschinenbezeichnung:
a. Tragen Sie in Kategorie Text im Textfeld ein: "%<Maschine>"
b. Tragen Sie in Kategorie Variablen bei Textausgabe ein: PLC_PRG.ivar
(3) Konfigurieren Sie ein weiteres Visualisierungselement zur Ausgabe des aktuellen Fehlertextes:
a. Tragen Sie in Kategorie Text im Textfeld ein: "%<Error>"
b. Tragen Sie in Kategorie Variablen bei Textausgabe ein: "PLC_PRG.errnum“
(4) Erstellen Sie eine xml-Datei, z.B. mit Namen dynamictextsample.xml, gemäß der oben beschriebenen Syntax, die für dieses Beispiel folgendermaßen aussieht:
<?xml version="1.0" encoding="ISO-8859-1"?>
<dynamic-text>
<header>
<default-language>deutsch</default-language>
<default-font>
<language>deutsch</language>
<font-name> Arial </font-name>
<font-color>0,0,0</font-color>
<font-height>-13</font-height>
<font-weight>700</font-weight>
<font-italic>false</font-italic>
<font-underline>false</font-underline>
<font-strike-out>false</font-strike-out>
<font-char-set>0</font-char-set>
</default-font>
<default-font>
<language>english</language>
<font-name> Arial </font-name>
<font-color>0,0,0</font-color>
<font-height>-13</font-height>
<font-weight>700</font-weight>
<font-italic>false</font-italic>
<font-underline>false</font-underline>
<font-strike-out>false</font-strike-out>
<font-char-set>0</font-char-set>
</default-font>
</header>
<text-list>
<text prefix="ERROR" id="4711">
<deutsch> Fehler an Position 4711 </deutsch>
<english> Error at position 4711 </english>
</text>
<text prefix="ERROR" id="815">
<deutsch> Fehler an Position 815 </deutsch>
<english> Error at position 815 </english>
</text>
<text prefix="ERROR" id="2000">
<deutsch> <![CDATA[Das ist ein Fehlertext über
mehrere Zeilen]]> </deutsch>
<english> <![CDATA[This is a error text over more than
one line]]> </english>
</text>
<text prefix="MASCHINE" id="1">
<deutsch> <![CDATA[Vorschub]]> </deutsch>
<english> <![CDATA[Feed rate]]> </english>
</text>
<text prefix="MASCHINE" id="2">
<deutsch> <![CDATA[Beschleunigung]]> </deutsch>
<english> <![CDATA[Acceleration]]> </english>
</text>
</text-list>
</dynamic-text>(5) Öffnen Sie in der Visualisierung den Dialog ‚Einstellungen’, Kategorie Sprache: Aktivieren Sie die Option ‚Dynamische Texte’; Fügen Sie die Datei dynamictextsample.xml, die nun auf Ihrem Rechner vorliegt, der Dateienliste hinzu.
(6) Gehen Sie mit dem Projekt in den Online Modus.
(7) Stellen Sie in den Einstellungen der Visualisierung die Sprache auf "deutsch". Setzen Sie PLC_PRG.ivar auf "1" und PLC_PRG.errnum auf "4711". In den Visualisierungselementen sollten nun folgende Texte erscheinen: "Vorschub" bzw. "Fehler an Position 4711".
(8) Setzen Sie PLC_PRG.ivar auf 2 und PLC_PRG.errnum auf "2000". Die Texte wechseln zu "Beschleunigung" und "Das ist ein Fehlertext über mehrere Zeilen. Der Text wird jeweils in Arial 13 dargestellt.
(9) Stellen Sie in den Einstellungen der Visualisierung die Sprache auf "english". Nun werden die folgenden Texte angezeigt: "Acceleration" und "This is a error text over more than one line".