Projekte automatisch erstellen oder bearbeiten
logi.CAD 3 s
tellt ein Werkzeug für das automatisierte Erstellen oder Bearbeiten von logi.CAD 3-→Projekten zur Verfügung.
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.
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.die Informationen für das Projekt, das erstellt oder bearbeitet werden soll – z.B. der Pfad und Name für das Projekt und die zu verwendende Projekt-Vorlage
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.
Falls JAVA JDK nicht bereits auf Ihrem Computer installiert ist, installieren und entpacken Sie JAVA JDK. Erweitern Sie im Falle einer Installation auch die Umgebungsvariable PATH des Betriebssystems um das Verzeichnis, in das JAVA JDK installiert/entpackt wurde. Im Zweifelsfall bitten Sie Ihren Administrator um Unterstützung.
Öffnen Sie eine Befehlszeile: z.B. cmd.exe unter Windows und wechseln Sie in das Installationsverzeichnis von logi.CAD 3 .
Aufruf
@REM Commands to start the development environment in German
start cmd /c logicad3.exe -nl de -data <WORKSPACE> -nosplash -vmargs -Dlicenseaccepted=true -Dosgi.requiredJavaVersion=<X.Y> -DLC3useRTS3MetaData=true -Xms256m -Xmx6144m -Dlc3.serverport=50055 -Dlog4j.configuration=file:<LOG-CONFIGURATION>
ping 127.0.0.1 -n 40 1>NUL
@REM Command to create the project based on a template
java -jar util\com.logicals.lc3.command.jar -port 50055 --createProject -projectName <PROJECT> -targetPath <PROJECTPATH> -templateName <TEMPLATENAME>
@REM Command to modify the project (replace the content of a file in the project)
java -jar util\com.logicals.lc3.command.jar -port 50055 --modifyProject -targetFilePath <FILE_TO_BE_MODIFIED> -sourceFilePath <REPLACEMENT_FILE> -binary
@REM Command to delete a file in the project
java -jar util\com.logicals.lc3.command.jar -port 50055 --removeProjectFile -targetFilePath <FILE_TO_BE_DELETED>
@REM Command to exit the development environment
java -jar util\com.logicals.lc3.command.jar -port 50055 -shutdown
Beschreibung der Parameter:
Parameter |
Beschreibung |
Beispiel |
<WORKSPACE> |
absoluter Pfad zu einem Arbeitsbereich, in den das Projekt importiert werden soll
|
C:\temp\LC3Workspace |
<X.Y> |
Versionsnummer der benötigten Java-Version |
1.8 |
<LOG-CONFIGURATION> |
Pfad zur Konfigurationsdatei für das Protokoll |
C:\LC3LogConfig\log4j.xml |
<PROJECT> |
Name des Projekts, das erstellt werden soll |
MyProject |
<PROJECTPATH> |
absoluter Pfad zum Ordner, in dem das Projekt erstellt werden soll |
C:\LC3Projects\ |
<TEMPLATENAME> |
Name der Projektvorlage, auf deren Basis das Projekt erstellt werden soll |
"logi.CAD 3 Projekt" |
<FILE_TO_BE_MODIFIED> |
absoluter Pfad und Name der Datei, deren Inhalt ersetzt werden soll (= Original-Datei) |
C:\LC3Projects\MyProject\TestNotes.txt |
<REPLACEMENT_FILE> |
absoluter Pfad und Name der Datei, deren Inhalt für die Ersetzung verwendet wird (= Ersatz-Datei) Falls es sich bei der Ersatz-Datei um eine binäre Datei handelt, fügen Sie den Parameter -binary hinzu. Für nicht-binäre Dateien (z.B. Text-Dateien) ist der Parameter -binary nicht erforderlich. |
C:\Templates\DoneTests.txt |
<FILE_TO_BE_DELETED> |
absoluter Pfad und Name der Datei, die gelöscht werden soll |
C:\LC3Projects\MyProject\GenericTestNotes.txt |
Der Parameter -noSplash ist optional. Wird er nicht angegeben, wird der Startbildschirm von logi.CAD 3 nach dem Aufruf angezeigt.
Der Parameter -Dlog4j.configuration ist ebenfalls optional. logi.cals empfiehlt jedoch, diesen Parameter anzugeben, damit Protokoll-Ereignisse ausgegeben werden.
Alle anderen Parameter sind erforderlich. Falls sie nicht angegeben werden, weist eine entsprechende Meldung darauf hin, dass Parameter fehlen.
start cmd /c logicad3.exe -nl de -data C:\temp\LC3Workspace -nosplash -vmargs -Dlicenseaccepted=true -Dosgi.requiredJavaVersion=1.8 -DLC3useRTS3MetaData=true -Xms256m -Xmx6144m -Dlc3.serverport=50055 -Dlog4j.configuration=file:C:\LC3LogConfig\log4j.xml
ping 127.0.0.1 -n 40 1>NUL
java -jar util\com.logicals.lc3.command.jar -port 50055 --createProject -projectName MyProject -targetPath C:\LC3Projects\ -templateName "logi.CAD 3 Projekt"
java -jar util\com.logicals.lc3.command.jar -port 50055 --modifyProject -targetFilePath C:\LC3Projects\MyProject\TestNotes.txt -sourceFilePath C:\Templates\DoneTests.txt
java -jar util\com.logicals.lc3.command.jar -port 50055 --removeProjectFile -targetFilePath C:\LC3Projects\MyProject\GenericTestNotes.txt
java -jar util\com.logicals.lc3.command.jar -port 50055 -shutdown
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>