Text in einer Textliste verwalten

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.

TwinCAT 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-Variablen 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.

	Verzeichnis für Textlistendateien Die Verzeichnisse, die Textlisten für die Visualisierung bereitstellen, legen Sie in den Projekteigenschaften in der Kategorie Visualization fest.

Siehe auch:

Eingabeunterstützung nutzen
Dokumentation TC3 User Interface: Textliste

Sprache hinzufügen und Text übersetzen

Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.

1. Doppelklicken Sie im SPS-Projektbaum auf ein Objekt des Typs Textliste oder GlobalTextList.

Das Menü Textliste erscheint in der Menüleiste und die Textliste öffnet im Editor.

2. Wählen Sie im Menü Textliste oder im Kontextmenü den Befehl Sprache einfügen.

3. 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-US erscheint.

4. Geben Sie in der Spalte die Übersetzung des Ausgangstextes ein.

Sie können so beliebig viele Sprachen ergänzen.

	Im Gegensatz zum Text in der Spalte Standard müssen Sie in der Sprachspalte keine Übersetzung eintragen. Wenn für einen Texteintrag keine Übersetzung gefunden wird, wird automatisch der Standardtext angezeigt.

Siehe auch:

Dokumentation TC3 User Interface: Befehl Sprache einfügen

Textliste exportieren

Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.

1. Doppelklicken Sie im SPS-Projektbaum auf ein Objekt des Typs Textliste oder GlobalTextList.

Das Menü Textliste erscheint in der Menüleiste und die Textliste öffnet im Editor.

2. Wählen Sie im Menü Textlist oder im Kontextmenü den Befehl Import/Export Textlisten.

Der Dialog Import/Export öffnet sich.

3. Klicken Sie bei Exportdatei auswählen auf Text in einer Textliste verwalten 3:

und wählen Sie dort das Verzeichnis und geben Sie einen Dateinamen ein, zum Beispiel „Text_lists_exported“.

4. Aktivieren Sie die Option Exportieren.

5. Beenden Sie den Dialog Import/Export mit OK.

TwinCAT exportiert die Textlisteneinträge aller Textlisten des Projekts in eine .csv-Datei. Die Tabelle enthält eine Spalte mit dem Textlistennamen.

	Über den Befehl Alles als Text exportieren können Sie die Textlisteneinträge als .txt-Datei exportieren. Für jede Textliste wird eine Datei angelegt. Das Verzeichnis, in dem die Export-Dateien automatisch gespeichert werden, definieren Sie in den Projekteigenschaften.

Beispiel:

Inhalt der Datei Text_lists_exported

TextList       Id   Default        en-us
TextList_A     A    Information A  Information A_en
TextList_A     B    Information B  Information B_en: Ok
TextList_A     C    Information C  Information C_en
AlarmGroup     1    Warnung 1    
AlarmGroup     2    Warnung 2    
GlobalTextList      Information G  Information G_en
GlobalTextList      Information H  Information H_en
GlobalTextList      Umschalten     Switch
GlobalTextList      Zähler: %i     Counter: %i

Siehe auch:

Dokumentation TC3 User Interface: Befehl Import/Export Textlisten

Exportierte Datei für die Eingabehilfe bereitstellen

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.

1. Wählen Sie den im Menü Extras den Befehl Optionen, Kategorie TwinCAT > SPS Programmierumgebung > Visualisierung, Registerkarte Dateioptionen.

2. Klicken Sie in Textdatei für textuelles Komponenten auflisten auf Text in einer Textliste verwalten 5:

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 TwinCAT beim Eingeben des ersten Buchstaben die Ausgangstexte der Datei als Eingabehilfe zur Auswahl an.
Text in einer Textliste verwalten 6:

Siehe auch:

Eingabeunterstützung nutzen

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. So eine Datei erhalten Sie, wenn Sie die Textlisten des Projekts in eine Datei exportierten. Sie können dort, außerhalb von TwinCAT, die Textlisteneinträge bearbeiten und die Datei anschließend importieren. TwinCAT behandelt beim Import die Textlisteneinträge für die GlobalTextList und für dynamische Textlisten aber unterschiedlich.

GlobalTextList:

Bei einer unbekannten ID legt TwinCAT keine neuen Textlisteneinträge an.
TwinCAT ignoriert Änderungen, die die ID oder den Ausgangstext betreffen.
TwinCAT übernimmt Änderungen der Übersetzungen.

Textliste:

Bei einer neuen ID ergänzt TwinCAT die zugehörige Textliste um einen Textlisteneintrag.
Bei einer bestehenden ID und unterschiedlichen Ausgangstexten wird der Ausgangstext der Textliste mit dem Ausgangstext der Datei überschrieben.
TwinCAT übernimmt Änderungen der Übersetzungen.

Datei importieren:

Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.

1. Doppelklicken Sie im SPS-Projektbaum auf ein Objekt des Typs Textliste oder GlobalTextList.

Das Menü Textliste erscheint in der Menüleiste und die Textliste öffnet im Editor.

2. Wählen Sie im Menü Textlist oder im Kontextmenü den Befehl Import/Export Textliste

Der Dialog Import/Export öffnet sich.

3. Klicken Sie in Datei für Vergleich oder Import auswählen auf Text in einer Textliste verwalten 7:

und wählen Sie dort ein Verzeichnis und einen Dateinamen, zum Beispiel „Text_lists_corrected.csv“.

4. Aktivieren Sie die Option Importieren.

5. Beenden Sie den Dialog mit OK.

TwinCAT importiert die Textlisteneinträge der Datei in die zugehörigen Textlisten.

Beispiel:

Inhalt der Datei Text_lists_corrected.csv

TextList       Id   Default            en-us
TextList_A     A    Information A      Information A_en
TextList_A     B    Information B: Ok  Information B_en: Ok
TextList_A     C    Information C      Information C_en
TextList_A     D    Information D      Information D_en
AlarmGroup     1    Warnung 1          Warning 1
AlarmGroup     2    Warnung 2    
GlobalTextList      Information G      Information G_en: Ok
GlobalTextList      Information HH     Information H_en
GlobalTextList      Information I      Information I_en
GlobalTextList      Umschalten         Switch
GlobalTextList      Zähler: %i         Counter: %i

Dieser Inhalt wird so im Projekt in den gleichnamigen Textlisten übernommen.

TextList       Id   Default            en-us
TextList_A     A    Information A      Information A_en
TextList_A     B    Information B: Ok  Information B_en:  Ok
TextList_A     C    Information C      Information C_en
TextList_A     D    Information D      Information D_en
AlarmGroup     1    Warnung 1          Warning 1
AlarmGroup     2    Warnung 2    
GlobalTextList      Information G      Information G_en: Ok
GlobalTextList      Information H      Information H_en
GlobalTextList      Umschalten         Switch
GlobalTextList      Zähler:  %i        Counter:  %i

Textlisten mit Datei vergleichen und Unterschied exportieren

Ein Projekt mit Textliste oder globaler Textliste ist geöffnet.

1. Doppelklicken Sie im SPS-Projektbaum auf ein Objekt des Typs Textliste oder GlobalTextList.

Das Menü Textliste erscheint in der Menüleiste und die Textliste öffnet im Editor.

2. Wählen Sie im Menü Textlist oder im Kontextmenü den Befehl Import/Export Textlisten.

Der Dialog Import/Export öffnet sich.

3. Klicken Sie in Datei für Vergleich oder Import auswählen auf Text in einer Textliste verwalten 8:

und wählen Sie dort Verzeichnis und Dateiname der Vergleichsdatei aus, zum Beispiel „Text_lists_corrected.csv“.

4. Klicken Sie bei Exportdatei auswählen auf Text in einer Textliste verwalten 9:

und wählen Sie dort ein Verzeichnis und geben Sie einen Dateinamen für die Datei ein, die das Vergleichsergebnis enthalten wird.

5. Aktivieren Sie die Option Nur Textunterschiede exportieren.

6. Beenden Sie den Dialog mit OK.

TwinCAT liest die Importdatei und vergleicht die Textlisteneinträge, die die gleiche ID haben. Wenn sie nicht übereinstimmen, schreibt TwinCAT die Textlisteneinträge der Textliste in die Exportdatei. Bei der globalen Textliste vergleicht TwinCAT bei gleichen Ausgangstexten die Übersetzungen. Wenn sie nicht übereinstimmen, schreibt TwinCAT die Textlisteneinträge in die Exportdatei.

Beispiel:

TextList       Id   Default        en-us
TextList_A     B    Information B  Information B_en: Ok
AlarmGroup     1    Warnung 1      Warning 1
GlobalTextList      Information G  Information G_en
GlobalTextList      Information H  Information H_en

Siehe auch:

Dokumentation TC3 User Interface: Befehl Import/Export Textlisten

Weiterführende Informationen