Textlisten dienen dazu, Texte für eine Visualisierung in mehreren Sprachen bereitzustellen. Sie können die Texte im Unicode-Format eingeben, so dass Ihnen sämtliche Sprachen und Schriftzeichen zur Verfügung stehen. Sie können Textlisten exportieren und importieren und damit die Texte außerhalb des aktuellen Projekts übersetzen.
CODESYS unterscheidet zwischen statischem Text, der im Objekt „GlobalTextList“ verwaltet wird, und dynamischem Text, der in Objekten des Typs „Textliste“ verwaltet wird. Statische Texte sind Texte innerhalb der Visualisierung, die zur Laufzeit nur ihre Sprache ändern können. Die Text-ID bleibt dabei konstant. Dynamische Texte können Sie über eine IEC-Variable steuern, die die Text-ID enthält. Damit können Sie in einem Visualisierungselement zur Laufzeit variierenden Text anzeigen lassen. Zum Beispiel können Sie ein Textfeld so konfigurieren, dass es einen Fehlertext zu einer Fehlernummer ausgibt.
Beide Textlistentypen enthalten eine Tabelle mit Texteinträgen. Ein Eintrag besteht aus einer ID zur Identifizierung, dem Ausgangstext und dessen Übersetzungen. In einer Textliste oder einer globalen Textliste können Sie einen Ausgangstext in beliebig vielen Sprachen übersetzen. Die Übersetzungen sind die Basis für die Sprachauswahl und die Sprachumschaltung in Visualisierungen.
Sprache hinzufügen und Text übersetzen
Voraussetzung: Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.
-
Doppelklicken Sie im Gerätebaum oder in der POUs-Ansicht auf ein Objekt des Typs „Textliste“ oder „GlobalTextList“.
Das Menü „Textliste“ erscheint in der Menüleiste und die Textliste öffnet im Editor.
-
Wählen Sie „Textliste Sprache einfügen“
-
Geben Sie einen Namen für die Sprache ein, zum Beispiel
en-US. Beenden Sie den Dialog mit „OK“.Eine Spalte mit der Überschrift
en-USerscheint. -
Geben Sie in der Spalte die Übersetzung des Ausgangstextes ein.
Mit dem Befehl „Sprache umbenennen“ aus dem Kontextmenü der Textliste können Sie den Namen einer Sprache in der Tabelle korrigieren.
Textliste exportieren
Voraussetzung: Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.
-
Doppelklicken Sie auf das Objekt „GlobalTextList“ oder auf ein Objekt des Typs „Textliste“.
Das Objekt öffnet sich.
-
Wählen Sie „Textliste Import/Export Textlisten“
Der Dialog „Import/Export“ öffnet sich.
-
Klicken Sie bei „Exportdatei auswählen“ auf
und wählen Sie dort Verzeichnis und Dateiname, zum Beispiel Text_lists_exported -
Aktivieren Sie die Option „Exportieren“.
-
Beenden Sie den Dialog „Import/Export“ mit „OK“.
CODESYS exportiert in die Datei die Textlisteneinträge aller Textlisten des Projekts. Die Tabelle enthält eine Spalte mit dem Textlistennamen.
Beispiel
Inhalt der Datei Text_lists_exported
TextList Id Default en_US Text_list_A A Information A Infrrmaiton A_en Text_list_A B Information B: OK Information B_en: OK Text_list_A C Information C Information C_en Text_list_A D Informaiton D Information D_en Text_list_A E Information E Infromation E_en Text_list_A F Information F Information F_en AlarmGroup 2 Warnung 2 AlarmGroup 1 Warnung 1 GlobalTextList Infomation B Information B_en GlobalTextList Information A Information A_en GlobalTextList Umschalten Switch GlobalTextList Zähler: %i Counter : %i
Exportierte Datei für die Eingabehilfe bereitstellen
Voraussetzung: Sie haben eine Datei, zum Beispiel Text_lists_exported, über den Befehl „Import/Export Textlisten“ erstellt. Sie enthält die Texte der Textlisten des Projekts.
-
Wählen Sie den Befehl „Tools Optionen“, Kategorie „Visualisierung“, Registerkarte „Dateioptionen“.
-
Klicken Sie in „Textlisten-Dateien für textuelles "Komponenten auflisten" “ auf
und wählen Sie eine Datei, zum Beispiel Text_lists_exported. Beenden Sie den Dialog mit „OK“.Wenn Sie in einer Visualisierung bei einem Element einen statischen Text unter der Eigenschaft „Texte“ eingeben, bietet CODESYS beim Eingeben des ersten Buchstaben die Ausgangstexte der Datei als Eingabehilfe zur Auswahl an.
(1) : „Texte“, „Text“
Siehe auch
Datei mit Textlisteneinträgen importieren
Eine importierbare Datei ist eine Datei mit Format .csv. Die erste Zeile ist eine Kopfzeile, wie zum Beispiel TextList Id Default en_US. Die weiteren Zeilen enthalten Textlisteneinträge. Sie erhalten so eine Datei, wenn
Sie die Textlisten des Projekts in eine Datei exportierten. Sie können dort, außerhalb
von
CODESYS, die Textlisteneinträge bearbeiten und die Datei anschließend importieren. CODESYS behandelt beim Import die Textlisteneinträge für die GlobalTextList und für dynamische Textlisten aber unterschiedlich.
GlobalTextList
-
Bei einer unbekannten ID legt CODESYS keine neuen Textlisteneinträge an.
-
CODESYS ignoriert Änderungen, die die ID oder den Ausgangstext betreffen.
-
CODESYS übernimmt Änderungen der Übersetzungen
Textliste
-
Bei einer neuen ID ergänzt CODESYS die zugehörige Textliste um einen Textlisteneintrag
-
Bei einer bestehenden ID, die im Ausgangstext nicht übereinstimmen, wird der Ausgangstext der Textliste mit dem Ausgangstext der Datei überschrieben.
-
CODESYS übernimmt Änderungen der Übersetzungen.
Datei importieren
Voraussetzung: Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.
-
Doppelklicken Sie auf das Objekt „GlobalTextList“ oder auf ein Objekt des Typs „Textliste“.
Das Objekt öffnet sich.
-
Wählen Sie „Textliste Import/Export Textliste“
Der Dialog „Import/Export“ öffnet sich.
-
Klicken Sie in „Datei für Vergleich oder Import auswählen“ auf
und wählen Sie dort Verzeichnis und Dateiname, zum Beispiel Text_lists_corrected.csv. -
Aktivieren Sie die Option „Importieren“.
-
Beenden Sie den Dialog mit „OK“.
CODESYS importiert die Textlisteneinträge der Datei in die zugehörigen Textlisten.
Beispiel
Inhalt der Datei Text_lists_corrected.csv
TextList Id Default en_US Text_list_A A Information A Information A2_en Text_list_A B Information B: OK Information B_en: OK Text_list_A C Information C Information C_en Text_list_A D Information D Information D_en Text_list_A E Information E Information E_en Text_list_A F Information F Information F_en Text_list_A G Information G Information G_en AlarmGroup 2 Warnung 2 AlarmGroup 1 Warnung 1 GlobalTextList Information B Information B_en GlobalTextList Information A Information A_en GlobalTextList Umschalten Switch GlobalTextList Zähler: %i Counter : %i
Dieser Inhalt wird so im Projekt in den gleichnamigen Textlisten übernommen.
Siehe auch
Textlisten mit Datei vergleichen und Unterschied exportieren
Voraussetzung: Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.
-
Doppelklicken Sie auf das Objekt „GlobalTextList“ oder auf ein Objekt des Typs „Textliste“.
Das Objekt öffnet sich.
-
Wählen Sie im Kontextmenü „Textliste Import/Export Textliste“.
Der Dialog „Import/Export“ öffnet sich.
-
Klicken Sie in „Datei für Vergleich oder Import auswählen“ auf
und wählen Sie dort Verzeichnis und Dateiname der Vergleichsdatei aus, zum Beispiel
Text_lists_corrected.csv. -
Klicken Sie bei „Exportdatei auswählen“ auf
und wählen Sie dort Verzeichnis und Dateiname der Datei aus, die das Vergleichsergebnis
enthalten wird. -
Aktivieren Sie die Option „Nur Textunterschiede exportieren“.
-
Beenden Sie den Dialog mit „OK“.
CODESYS liest die Importdatei und vergleicht die Textlisteneinträge, die die gleiche ID haben. Wenn sie nicht übereinstimmen, schreibt CODESYS den Textlisteneinträge der Textliste in die Exportdatei.
Bei der globalen Textliste vergleicht CODESYS bei gleichen Ausgangstexten die Übersetzungen. Wenn sie nicht übereinstimmen, schreibt CODESYS den Textlisteneinträge in die Exportdatei.
-
Statischen Text in einer globalen Textliste verwalten
-
Dynamischen Text in einer Textliste verwalten