Administratorhandbuch > Konfiguration > Aufbau der Konfigurationsdateien > Aufbau der uc4config.xml

UserInterface

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.

Aufbau der uc4config.xml

Parameter

Beschreibung

<configuration> Beginn der Konfiguration.
<paths> Beginn der Elemente für die Verzeichnis- und Dateidefinitionen.
<docu type="Format">Pfad</docu> Definitionen zur Online-Dokumentation .

"Format" = Hilfesystem, das beim Betätigen der F1-Taste aufgerufen werden soll.

Erlaubte Werte: "wh"
"wh" = WebHelp

"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"
"-1" = An den Namen der Logdatei wird der Rechnername und die aktuelle Uhrzeit im Format HHMMSSSSS angehängt.
"0" = Das Schreiben der Logdatei ist ausgeschaltet.
"1" - "99" = Anzahl der Generationen von Logdateien, die erhalten bleiben.

"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"
"-1" = An den Namen der Tracedatei wird der Rechnername und die aktuelle Uhrzeit im Format HHMMSSSSS angehängt.
"0" = Das Schreiben der Tracedatei ist ausgeschaltet.
"1" - "99" = Anzahl der Generationen von Tracedateien, die erhalten bleiben.

"XML-Trace" = Traceflag für die Protokollierung von XML-Operationen.

Erlaubte Werte: "0", "1", "2", "3"
"0" = Es erfolgt keine Protokollierung
"1" = Sendeaufrufe
"2" = Empfangsaufrufe
"3" = Sende- als auch Empfangsaufrufe

"TCP/IP-Trace" = Traceflag für die Protokollierung des TCP/IP-Datenverkehrs.

Erlaubte Werte: "0", "1", "2", "3"
"0" = Es erfolgt keine Protokollierung
"1" = Sendeaufrufe
"2" = Empfangsaufrufe
"3" = Sende- als auch Empfangsaufrufe

"Rapid Automation Trace" = Traceflag für Rapid Automation Agenten.

Erlaubte Werte: "0", "9"
"0" = Rapid-Automation-Trace-Datei schreiben ist deaktiviert.
"9" = Das Schreiben der Rapid Automation Tracedatei ist eingeschaltet.

"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.
Diese wird zur Visualisierung der Verbindung zu einem Mandant im UserInterface verwendet (farbliche Linie unterhalb der Titelleiste von Fenstern).

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
"0" - Keep-Alive-Pakete werden nicht geschickt.

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 AEAE-System..

"Name" = Alias für die Verbindung zu einem Automation Engine System. Im Anmeldefenster kann die Verbindung über diesen Namen ausgewählt werden.

"system" - Name des Automation Engine Systems, zu dem die Verbindung aufgebaut werden soll Wie das Automation Engine System heißt, ist in der INI-Datei der Automation Engine vermerkt.

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 Kommunikationsprozess im AE-System.

"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>.

Beispiel einer uc4config.xml

<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