Kommandozeilen Übersetzungs Tools

Neben dem Translator-Tool stehen drei Kommandozeilen-Tools für die Übersetzung zur Verfügung. Zwei Programme zum Übersetzen bestehender Panels sind verfügbar. Das letzte Werkzeug ist verfügbar um eine Sprache, die keine Projektsprache ist, aus einer Paneldatei zu entfernen.

Die Programme sind: WCCOAtoolParse zum Exportieren der Bezeichnungen, WCCOAtoolTrans zum Übersetzen und WCCOAtoolLang, um eine Sprache zu entfernen.

WCCOAtoolParse

Die folgende Tabelle enthält die Kommandozeilenoptionen für WCCOAtoolParse:

Allgemeine Optionen für WCCOAtoolParse Beschreibung
-dictIN <input-dict> Name des existierenden Wörterbuchs, das verwendet wird.
-dictOUT <output-dict> Name des Wörterbuchs das erstellt wird.
-html <html-dict> Ein HTML-Wörterbuch.
[-noRef] -langid <lang-id>[{,<lang-id> ... } ]

Definiert, dass die Referenz-Sprache nicht verwendet wird. Die Option kann verwendet werden, um Source- und Zielsprachen über die lang-ids zu definieren.

Die Funktion getGlobalLangId() Liefert die ID einer Projektsprache (lang-id).

-langid <refLangID>,<destLangID>[,<destLangID>]

Id's der Sprachen für das Wörterbuch. Die erste Sprache ist die globale ID der Referenzsprache. Die Einträge der Referenzsprache werden in die Zielsprachen übersetzt.

Die Funktion getGlobalLangId() Liefert die ID einer Projektsprache (lang-id).

-files <file>[{,<file> ..}] Eine Datei/Dateien, die übersetzt werden.
[-overwrite] [-multitrans] Überschreibt das existierende Wörterbuch.
[-noChange] Das Wörterbuch wird nicht geändert, sondern es wird nur ein "Dry run" ausgeführt.
Dateioptionen
-pD Übersetzt die Datenpunkte des Projektes.
-vA Übersetzt alle Kataloge und Panels der WinCC OA-Version.

-vC

Übersetzt nur Kataloge der WinCC OA-Version.
-vP Übersetzt nur Panels der WinCC OA-Version.
-pA Übersetzt alle Kataloge, Panels und Datenpunkte des Projektes.
-pC Übersetzt nur Kataloge des Projektes.
-pP Übersetzt nur Panels des Projektes.

Logoptionen

-logF Nur fatale Fehler ausgeben.
-logE Log-Fehlermeldungen ausgeben.
-logW Log-Warnungen ausgeben.
-logP Log-Prozess (Dateilevel) ausgeben.
-logS Logschritte (Wortlevel) ausgeben.
-logV Ausführliche Logging-Ausgabe.
-overwrite Der letzte einkommende Eintrag wird gespeichert. Die alten Einträge werden gelöscht.
-multitrans Unterschiedliche Übersetzungen können für unterschiedliche Panels, Kataloge usw. gespeichert werden.

WCCOAtoolTrans

Die folgende Tabelle enthält die Kommandozeilenoptionen für WCCOAtoolTrans:

Allgemeine Optionen für WCCOAtoolTrans Beschreibung
-dict Angabe der Wörterbuchdatei.
-langid <refLangID>,<destLangID>[,<destLangID>]

Id's der Sprachen für das Wörterbuch. Die erste Sprache ist die globale ID der Referenzsprache. Die Einträge der Referenzsprache werden in die Zielsprachen übersetzt.

Die Funktion getGlobalLangId() Liefert die ID einer Projektsprache (lang-id).

-files <file>[{,<file> ..}] Eine Datei/Dateien, die übersetzt werden.
Dateioptionen
-pD Übersetzt die Datenpunkte des Projektes.
-vA Übersetzt alle Kataloge und Panels der WinCC OA-Version.

-vC

Übersetzt nur Kataloge der WinCC OA-Version.
-vP Übersetzt nur Panels der WinCC OA-Version.
-pA Übersetzt alle Kataloge, Panels und Datenpunkte des Projektes.
-pC Übersetzt nur Kataloge des Projektes.
-pP Übersetzt nur Panels des Projektes.

Logoptionen

-logF Nur fatale Fehler ausgeben.
-logE Log-Fehlermeldungen ausgeben.
-logW Log-Warnungen ausgeben.
-logP Log-Prozess (Dateilevel) ausgeben.
-logS Logschritte (Wortlevel) ausgeben.
-logV Ausführliche Logging-Ausgabe.

WCCOAtoolLang

Die folgende Tabelle enthält die Kommandozeilenoptionen für WCCOAtoolLang:

Allgemeine Optionen für WCCOAtoolLang Beschreibung
-proj <name> Name des registrierten SIMATIC WinCC OA-Projektes.
-rem[ove] Lösche eine nicht Projektsprache aus einer Paneldatei.
-lang <languageid> ID der Sprache, die gelöscht werden soll (z.B. en_US.utf8)
Logoptionen
-logE Fehlermeldungen ausgeben.
-logP Log-Prozess ausgeben.
-log +stderr Meldungen werden in der Eingabeaufforderung ausgegeben. Ohne diese Option werden die Meldungen im LogViewer ausgegeben.
CAUTION: WCCOAtoolLang funktioniert nicht für Panels in Xml-Format.
CAUTION: Ab Version 3.16 können keine ISO-Projekte mehr erstellt werden. Erstellen Sie stattdessen UTF-8-Projekte.
Note: Beim Übersetzen von ISO-kodierten Texten in eine UTF-8 kodierte Sprache kommt derselbe Sprachen-Fallback-Mechanismus wie bei der Dateisuche zur Anwendung.
Note: Das Panel muss mit dem vollen Pfad angegeben werden.

In diesem Beispiel wird ein Wörterbuch "dictionary.txt" über das Tool WCCOAtoolParse erstellt. Es enthält die Sourcesprache Englisch (10001) und die Zielsprachen Deutsch(10000) und Russisch (10027) sowie das Panel Sample.pnl. Das Wörterbuch wird über das Tool WCCOAtoolTrans importiert.

Export:

  1. WCCOAtoolParse -dictOut dictionary.txt -langid 10001,10000,10027 -files D:/Projects/WinCCOAProj/panels/Sample.pnl
    -overwrite -logW -log +stderr 2> D:/Projects/WinCCOAProj/log/WCCOATranslator.log

INFO: das Wörterbuch dictionary.txt liegt im Verzeichnis data/trans des Projektes.

Import:

  1. WCCOAtoolTrans -dict dictionary.txt -langid 10001,10000,10027 -files  D:/Projects/WinCCOAProj/panels/Sample.pnl
    -logW-log +stderr 2> D:/Projects/WinCCOAProj/log/WCCOATranslator.log

Das folgende Beispiel löscht Französisch (nicht eine Projektsprache) aus der Paneldatei "langtest.pnl". Der Log-Prozess wird in der Eingabeaufforderung ausgegeben.

  1. WCCOAtoolLang -proj TST_RemoveLangTarget -rem -lang fr_FR.utf8 -file D:\Projects\TST_RemoveLangTarget\panels\langtest.pnl -log +stderr -logP