Objekte automatisch aus XML importieren
logi.CAD 3 bietet ein Werkzeug für das automatisierte Importieren von ST-/FBS-Objekte aus einer XML-Datei (= Textdatei im XML-Format). Diese XML-Datei wurde am besten vorher mit Hilfe des Werkzeug für das automatisierte Exportieren erstellt.
Das Werkzeug ist zur Verwendung durch einen fortgeschrittenen Anwender von
logi.CAD 3
vorgesehen.
Bedingung für die erfolgreiche Verwendung des Werkzeugs sind Kenntnisse über die durchzuführende Aktion, wie sie in der grafischen Benutzeroberläche von
logi.CAD 3
ausgeführt werden würde.
Die Ausgaben des Werkzeugs erfolgen nur in englischer Sprache.
Inhalt dieses Artikels:
Vorbereitungen
-
Stellen Sie sicher, dass
logi.CAD 3
installiert ist. Halten Sie die folgenden Informationen bereit:
- der Pfad zum Installationsverzeichnis von logi.CAD 3
-
der Pfad zu einem Verzeichnis, das als Arbeitsbereich verwendet wird
Falls das Verzeichnis nicht existiert, wird es vom Werkzeug erstellt. Falls der optionale Parameter-checkEmptyWorkspace
verwendet wird (siehe die Beschreibung dieses Parameters weiter unten), muss das Verzeichnis leer sein. - der Pfad zum Projekt, in das die Objekte importiert werden sollen
-
der Pfad zur Konfigurationsdatei für das Protokoll (siehe unten für weitere Informationen)
Eine Datei mit einer Beispielkonfiguration ist in der Installation von logi.CAD 3 enthalten.
-
Öffnen Sie eine Befehlszeile: z.B.
cmd.exe
unter Windows und wechseln Sie in das Installationsverzeichnis von logi.CAD 3 .
Aufruf
Parameter, die innerhalb von []
stehen, sind optional. Das heißt, wenn Sie den Parameter auslassen, wird das Standardverhalten angewendet (siehe unter "Beschreibung der Parameter" weiter unten). Wenn Sie den Parameter verwenden möchten, geben Sie das Zeichen [
und ]
nicht ein (siehe die nachfolgenden Beispiele).
logiCAD3c --launcher.ini logiCAD3.ini -application com.logicals.lc32.importer.application [-noSplash] -projectPath <PROJECTPATH> [-inputFolder <INPUT_FOLDER> -inputFile <INPUT_FILE> -importFolder <FOLDER_TO_IMPORT_INTO>]|[-workpackagePath <WORKPACKAGE_PATH>] [-checkEmptyWorkspace] -vmargs -Dlog4j.configuration=file:<LOG-CONFIGURATION>
Der Aufruf des Werkzeugs wird nicht offiziell für Linux unterstützt. Wenn Sie dennoch versuchen wollen, das Werkzeug unter Linux aufzurufen, ersetzen Sie den Teil
logiCAD3c --launcher.ini logiCAD3.ini -application
des oben genannten Aufrufs durch logiCAD3 -application
. Der restliche Teil des Aufrufs ist identisch mit dem oben genannten Aufruf.
Beschreibung der Parameter:
Parameter | Beschreibung | Beispiel |
---|---|---|
| absoluter Pfad zum Projekt | C:\LC3Projects\MyProject |
<INPUT_FOLDER> <INPUT_FILE> | die folgenden Daten für die XML-Datei:
| C:\lc3 program.xml |
<WORKPACKAGE_PATH> | absoluter Pfad zu einer CSV-Datei
Beispiel für den Inhalt einer CSV-Datei: Die Objekte aus 2 XML-Dateien werden in den Projektordner "src" importiert. C:\lc3,program.xml,src C:\lc3,EnumType.xml,src | c:\LC3\workpackage.csv |
|
Pfad zur Konfigurationsdatei für das Protokoll |
|
-
Der Parameter
-noSplash
ist optional. Wird er nicht angegeben, wird der Startbildschirm von logi.CAD 3 nach dem Aufruf angezeigt.
-
Der Parameter
-checkEmptyWorkspace
ist ebenfalls optional. Geben Sie diesen Parameter an, um zu prüfen, ob der angegebene Arbeitsbereich leer ist. Das logi.CAD 3 -Projekt wird nur importiert, falls der Arbeitsbereich leer ist.
Beim Standardaufruf (wenn dieser Parameter nicht angegeben wird) wird das logi.CAD 3 -Projekt immer in den Arbeitsbereich importiert – unabhängig davon, ob der Arbeitsbereich leer ist oder nicht. Ist das logi.CAD 3 -Projekt bereits im Arbeitsbereich vorhanden, wird das logi.CAD 3 -Projekt neu importiert. -
Der Parameter
-Dlog4j.configuration
ist ebenfalls optional. logi.cals empfiehlt jedoch, diesen Parameter anzugeben, damit Protokoll-Ereignisse ausgegeben werden.
logiCAD3c --launcher.ini logiCAD3.ini -application com.logicals.lc32.importer.application -noSplash -projectPath C:\LC3Projects\MyProject -inputFolder C:\lc3 -inputFile program.xml -importFolder src -vmargs -Dlog4j.configuration=file:C:\LC3LogConfig\log4j.xml
logiCAD3c --launcher.ini logiCAD3.ini -application com.logicals.lc32.importer.application -noSplash -projectPath C:\LC3Projects\MyProject -workpackagePath c:\LC3\workpackage.csv -vmargs -Dlog4j.configuration=file:C:\LC3LogConfig\log4j.xml
Konfigurationsdatei für das Protokoll
Diese Datei wird zur Konfiguration des log4j-Protokollierungsmechanismus benötigt. Die Datei gibt an, wie Protokoll-Ereignisse ausgegeben werden.
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd"> <log4j:configuration debug="false" xmlns:log4j='http://jakarta.apache.org/log4j/'> <!-- This configuration logs to console. --> <appender name="console" class="org.apache.log4j.ConsoleAppender"> <param name="target" value="System.out"/> <param name="immediateFlush" value="true"/> <param name="encoding" value="UTF-8"/> <param name="threshold" value="info"/> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p: %m%n" /> </layout> </appender> <!-- This configuration logs to a file, with more information than for the console. --> <appender name="file" class="org.apache.log4j.DailyRollingFileAppender"> <param name="file" value="C:\\temp\\logfile.log" /> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%d{HH:mm:ss} %-5p [THREAD ID=%t] [Method:%M] %c{1}:%L - %m%n" /> </layout> </appender> <root> <level value="INFO" /> <appender-ref ref="console" /> <appender-ref ref="file" /> </root> </log4j:configuration>
Fehlerbehebung
Die Datei, die in der Konfigurationsdatei für das Protokoll angegeben ist, enthält Informationen über das Importieren. Falls das Importieren nicht erfolgreich war, beheben Sie das Problem gemäß der folgenden Tabelle.
Rückgabe-Code | Meldung (ausgegeben auf STDOUT oder STDERR) | Ursache | Lösung |
---|---|---|---|
0 | Import successful (0) | ||
13 | <keine Meldung> | Ein falscher Wert wurde für -application angegeben. | Rufen Sie das Werkzeug wie oben angegeben auf. |
-1 | Import failed (Parameter Error, -1): Name | Ein Argument oder Parameter fehlt. | Rufen Sie das Werkzeug wie oben angegeben auf. |
-2 | Import failed (-2): Project not found | Das angegebene Projekt existiert nicht. | Geben Sie ein vorhandenes Projekt an. Oder rufen Sie das Werkzeug mit dem absoluten Pfad für das Projekt auf. |
-6 | Import failed (-6): Workspace not empty | Der Arbeitsbereich enthält bereits Daten (z.B. ein oder mehrere logi.CAD 3 -Projekte). | Verwenden Sie einen leeren Arbeitsbereich oder entfernen Sie alle vorhandenen Daten aus dem aktuellen Arbeitsbereich. Alternative: Rufen Sie das Werkzeug ohne den Parameter -checkEmptyWorkspace auf. |
-7 | Import failed (-7): The object "name" does not exist in the project "name". | Sie haben einen Ordner angegeben. der im Projekt nicht vorhanden ist. | Geben Sie einen vorhandenen Ordner an. |
-127 | Import failed. Details: exception message | Ein unerwarteter Fehler ist aufgetreten. | Kontaktieren Sie logi.cals . |