Standardmäßig wird die Konfigurationsdatei (uc4config.xml) benutzt, die sich im gleichen Ordner wie das UserInterface befindet. Es ist jedoch auch möglich, den Pfad der zu verwendenden Konfigurationsdatei mit dem Startparameter -I in der INI-Datei anzugeben. Damit kann sich jeder Benutzer eine eigene uc4config.xml mit den bevorzugten Einstellungen anlegen.
In den Pfadangaben können Sie auch Umgebungsvariablen verwenden. Fügen Sie folgende Platzhalter ein:
Windows: %Variable%
UNIX: $(Variable)
Das UserInterface ersetzt sodann den Platzhalter mit dem Wert der Umgebungsvariablen.
Für die meisten Parameter wurden Standardwerte vergeben. Sie können diese je nach Bedarf verändern. Die Parameter aber, die Sie auf jeden Fall an Ihre Systemumgebung anpassen müssen, sind in roter Schrift hervorgehoben.
Parameter |
Beschreibung |
---|---|
<configuration> | Beginn der Konfiguration. |
<paths> | Beginn der Elemente für die Verzeichnis- und Dateidefinitionen. |
<docu type="Format">Pfad</docu> | Definitionen zur
"Format" = Hilfesystem, das beim Betätigen der F1-Taste aufgerufen werden soll. Erlaubte Werte: "wh" "Pfad" = Verzeichnis, in dem das Hilfesystem installiert wurde. |
<browser type="Name">Pfad</browser> |
Dieser Parameter ist eine Voraussetzung für die Nutzung der WebHelp-Dokumentation! "Name" = Name des Web-Browsers Erlaubte Werte: "Mozilla Firefox", "Internet Explorer", Netscape Browser" "Pfad" = Verzeichnis und Dateiname des Web-Browsers (Beispiel für UNIX: /users/uc4/firefox/firefox) |
<logging count="Anzahl">Logdatei</logging> |
Definitionen für die Logdatei. "Anzahl" = Maximale Anzahl von Logdateien. Abhängig vom Wert wird die Anzahl auch im Namen der Logdatei aufgenommen. Erlaubte Werte: "-1", "0", "1" - "99" "Logdatei" = Verzeichnis und Name der Datei, in welche die Log-Informationen geschrieben werden. Sie können im Dateinamen auch Nummernzeichen ## verwenden. Diese dienen als Platzhalter für eine aufsteigende Nummerierung der Logdateien. Beim Start des UserInterfaces werden die Logdateien umbenannt, sodass die aktuellste Logdatei immer jene mit der Nummer 00 ist. |
<trace count="Anzahl" xml="xml-Trace" tcp="TCP/IP Trace" ra="Rapid Automation trace">TraceDatei</trace> |
Definitionen für die Tracedatei.
"Anzahl" = Maximale Anzahl von Tracedateien. Abhängig vom Wert wird die Anzahl auch im Namen der Tracedatei aufgenommen. Erlaubte Werte: "-1", "0", "1" - "99" "XML-Trace" = Traceflag für die Protokollierung von XML-Operationen. Erlaubte Werte: "0", "1", "2", "3" "TCP/IP-Trace" = Traceflag für die Protokollierung des TCP/IP-Datenverkehrs. Erlaubte Werte: "0", "1", "2", "3" "Rapid Automation Trace" = Traceflag für Rapid Automation Agenten. Erlaubte Werte: "0", "9" "Tracedatei" = Verzeichnis und Name der Datei, in welche die Trace-Informationen geschrieben werden. Das Verzeichnis muss vorhanden sein. Sie können im Dateinamen auch Nummernzeichen ## verwenden.Diese dienen als Platzhalter für eine aufsteigende Nummerierung der Tracedateien. Beim Start des UserInterfaces werden die Logdateien umbenannt, sodass die aktuellste Tracedatei immer jene mit der Nummer 00 ist. |
<SendBufferSize>Anzahl</SendBufferSize> |
Maximale Anzahl an Bytes, die das UserInterface pro Block an die Automation Engine sendet. "Anzahl" = Maximale Blockgröße in Bytes Standardwert: 1048576 |
<RecvBufferSize>Anzahl</RecvBufferSize> |
Maximale Anzahl an Bytes pro Block die das UserInterface von der Automation Engine empfängt. "Anzahl" = Maximale Blockgröße in Bytes Standardwert: 1048576 |
<tcp_nodelay>Wert</tcp_nodelay> |
Verwendung des Nagle-Algorithmus für die Verbindung zwischen UserInterface und AutomationEngine. Erlaubte Werte: "0" oder "1" (Standardwert) |
</paths> | Abschluss für XML-Element <paths>. |
<colors> | Beginn der Elemente für die Farbdefinitionen. |
<color r="Rot-Anteil" g="Grün-Anteil" b="Blau-Anteil"/> |
Definition einer Farbe. Für die farblichen Anteile kann jeweils ein Wert zwischen 0 und 255 vergeben werden. Beachten Sie, dass nur gleichzeitige 8 Verbindungen pro UserInterface-Instanz unterstützt werden. Daher wird empfohlen, auch nur maximal 8 Farben zu definieren, da jede Verbindung durch eine Farbe repräsentiert wird. |
</colors> | Abschluss für XML-Element <colors>. |
<timeout>Dauer</timeout> |
"Dauer" = Zeitspanne in Sekunden, in der auf eine Antwort des Kommunikationsprozess gewartet wird. Antwortet der Kommunikationsprozess nicht innerhalb dieser angegebenen Zeit, so wird eine Fehlermeldung ausgegeben. Standardwert: 60 Sekunden |
<tcpip_keepalive>Verbindungserhalt</tcpip_keepalive> |
Einstellung von Keepalive-Paketen für den Verbindungserhalt (z.B. in WAN). Erlaubte Werte: "0" und "1" (Standardwert) "1" - Keep-Alive-Pakete werden gesendet Das UserInterface verliert die Verbindung zur Automation Engine, wenn für einen längeren Zeitraum (ungefähr 2 Stunden) keine Benutzer-Aktion erfolgt. Setzen Sie diesen Parameter auf "1", um einen Verbindungsverlust zu vermeiden. Durch die Versendung der Keep-Alive-Pakete wird die Verbindung aufrecht erhalten. |
<active_keepalive>Zeitintervall<active_keepalive> |
Zeit in Minuten, in der das UserInterface Nachrichten an die Automation Engine sendet, um die Verbindung aufrecht zu erhalten. Dieser Parameter ist unabhängig von <tcpip_keepalive>. Die Einstellung <tpcip_keepalive> aktiviert den Verbindungserhalt auf Socket-Ebene, wodurch auch das Zeitintervall der Keepalive-Pakete nicht bestimmt werden kann. <active_keepalive> bezieht sich auf Programmebene. |
<connections> |
Beginn der Elemente für die Verbindungen zu den Automation Engine Systemen. |
<connection name="Name" system="System"> |
Definition der Verbindung zu einem AE "Name" = Alias für die Verbindung zu einem Automation Engine System. Im Beachten Sie, dass die unterschiedlichen Automation Engine Systeme nicht den gleichen Namen besitzen dürfen! |
<cp ip="DNS/IP" port="port"/> |
Definition der Verbindung zum "DNS/IP" = Geben Sie entweder den Namen oder die IP-Adresse des Rechners an auf dem der Kommunikationsprozess läuft. "Port" = Portnummer des Kommunikationsprozesses im Automation Engine System. |
</connection> | Abschluss für XML-Element <connection>. |
</connections> | Abschluss für XML-Element <connections>. |
</configuration> | Abschluss für XML-Element <configuration>. |
<configuration>
<paths>
<docu type="wh">C:\AUTOMIC\Documentation</docu>
<browser type="Internet Explorer">"C:\Program Files\Internet Explorer\iexplore.exe"</browser>
<logging count="10">..\temp\UCDJ_LOG_##.TXT</logging>
<trace count="10" xml="0" tcp="0" ra="9">../temp/UCDJ_TRC_##.TXT</trace>
</paths>
<colors>
<color b="0" g="0" r="255"/>
<color b="0" g="255" r="0"/>
<color b="255" g="152" r="42"/>
<color b="0" g="255" r="255"/>
<color b="0" g="144" r="255"/>
<color b="255" g="0" r="255"/>
<color b="255" g="255" r="255"/>
<color b="149" g="140" r="170"/>
</colors>
<timeout>60</timeout>
<tcpip_keepalive>0</tcpip_keepalive>
<connections>
<connection name="AE Production" system="AE">
<cp ip="uc4prod" port="2217"/>
</connection>
<connection name="AE Test" system="AET">
<cp ip="testsys" port="2217"/>
</connection>
</connections>
</configuration>
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |