Manuel d'administration > Configuration > Organisation des fichiers de configuration > Structure du fichier uc4config.xml

Interface Utilisateur

Par défaut, c'est le fichier de configuration (uc4config.xml) se trouvant dans le même dossier que l'Interface Utilisateur qui est utilisé. Il est cependant également possible d'indiquer le chemin du fichier de configuration à utiliser avec le paramètre de démarrage -l dans le fichier INI. Chaque Utilisateur peut ainsi créer son propre fichier uc4config.xml avec les paramètres qu'il préfère.

Vous pouvez également utiliser des Variables d'environnement dans le chemin. Insérez les caractères de remplacement suivants :

Windows : %Variable%
UNIX : $(Variable)

L'Interface Utilisateur remplace alors le caractère de remplacement par la valeur de la Variable d'environnement.

Des valeurs par défaut ont été attribuées à la plupart des paramètres. Vous pouvez les modifier en fonction de vos besoins. Les paramètres que vous devez en tous cas adapter à l'environnement de votre système sont mis en évidence en caractères rouges.

Structure du fichier uc4config.xml

Paramètres	Description
<configuration>	Début de la configuration.
<paths>	Début des éléments pour définir le répertoire et le fichier.
<docu type="Format">Chemin</docu>	Définitions pour la documentation en ligne. "Format" = système d'aide devant s'afficher lorsque l'Utilisateur appuie sur la touche F1. Valeurs autorisées : "hh", "wh" "hh" = aide HTML (uniquement pour Microsoft Windows). "wh" = WebHelp "chemin" = répertoire dans lequel le système d'aide a été installé.
<browser type="nom">chemin</browser>	Ce paramètre est uniquement nécessaire si vous souhaitez utiliser Webhelp. "Nom" = Nom du navigateur Web Valeurs autorisées : "Mozilla Firefox", "Internet Explorer", Netscape Browser" "Chemin" = Répertoire et nom de fichier du navigateur Web (Exemple pour UNIX : /users/uc4/firefox/firefox)
<logging count="Nombre">Fichier log</logging>	Définitions pour le fichier log "nombre" = nombre maximal de fichiers log. Selon la valeur, le nombre est également inclus dans le fichier log. Valeurs autorisées : "-1", "0", "1" - "99" "-1" = le nom de l'ordinateur et l'heure actuelle au format HHMMSSSSS sont ajoutés au nom du fichier log. "0" = L'écriture du fichier log est désactivée. "1" - "99" = Nombre de générations de fichiers log conservés. "Fichier log" = répertoire et nom du fichier dans lequel les informations de log sont écrites. Les noms de fichiers peuvent également comporter des caractères numériques ##. Ils servent de caractère de remplacement pour une numérotation croissante des fichiers de log. Au démarrage de l'Interface Utilisateur, les fichiers log sont renommés de telle manière que le fichier log actuel ait toujours le numéro "00".
<trace count="nombre" xml="trace XML" tcp="trace TCP/IP">fichier de trace</trace>	Définitions pour le fichier de trace. "nombre" = nombre maximal de fichiers de trace. Selon la valeur, le nombre est également inclus dans le nom du fichier de trace. Valeurs autorisées : "-1", "0", "1" - "99" "-1" = le nom de l'ordinateur et l'heure actuelle au format HHMMSSSSS sont ajoutés au nom du fichier de trace. "0" = L'écriture du fichier de trace est désactivée. "1" - "99" = Nombre de générations de fichiers de trace conservés. "XML-Trace" = indicateur de trace pour la journalisation des opérations XML. Valeurs autorisées : "0", "1", "2", "3" "0" = Aucune journalisation. "1" = Appels d'envoi "2" = Appels de réception "3" = Appels d'envoi et de réception "TCP/IP-Trace" = indicateur de trace pour la journalisation du trafic de données TCP/IP. Valeurs autorisées : "0", "1", "2", "3" "0" = Aucune journalisation. "1" = Appels d'envoi "2" = Appels de réception "3" = Appels d'envoi et de réception "fichier de trace" = répertoire et nom du fichier dans lequel les informations de trace sont écrites. Le répertoire doit exister. Les noms de fichiers peuvent également comporter des caractères numériques ##. Ils servent de caractère de remplacement pour une numérotation croissante des fichiers de trace. Au démarrage de l'Interface Utilisateur, les fichiers log sont renommés de telle manière que le fichier de trace actuel ait toujours le numéro "00".
<SendBufferSize>Nombre</SendBufferSize>	Nombre maximal d'octets que l'Interface Utilisateur envoie par bloc à Automation Engine. "Nombre" = Taille maximale du bloc en octets Valeur par défaut : 1048576
<RecvBufferSize>Nombre</RecvBufferSize>	Nombre maximal d'octets que l'Interface Utilisateur reçoit par bloc d'Automation Engine. "Nombre" = Taille maximale du bloc en octets Valeur par défaut : 1048576
<tcp_nodelay>Valeur</tcp_nodelay>	Utilisation de l'algorithme de Nagle pour la connexion entre l'Interface Utilisateur et Automation Engine. Valeurs autorisées : "0" ou "1" (valeur par défaut)
</paths>	Fin de l'élément XML<paths>.
<colors>	Début des éléments pour les définitions de couleur.
<color r="pourcentage de rouge" g="pourcentage de vert" b="pourcentage de bleu"/>	Définition d'une couleur. Celle-ci est utilisée pour visualiser la connexion à un Client dans l'Interface Utilisateur (ligne en couleur sous la barre de titre des fenêtres). Pour les pourcentages de couleur, une valeur comprise entre 0 et 255 peut être attribuée. Veuillez noter que seules 8 connexions simultanées par instance d'Interface Utilisateur sont prises en charge. Il est donc recommandé de ne définir que 8 couleurs au maximum, car chaque connexion est représentée par une couleur.
</colors>	Fin de l'élément XML <color>.
<timeout>durée</timeout>	"durée" = durée en secondes pendant laquelle une réponse du processus de communication est attendue. Si le processus de communication ne répond pas durant la durée indiquée, un message d'erreur s'affiche. Valeur par défaut : 60 secondes
<tcpip_keepalive>maintien de la connexion</tcpip_keepalive>	Paramétrage des packages Keepalive pour le maintien de la connexion (par exemple dans WAN). Valeurs autorisées : "0" et "1" (valeur par défaut) "1" - les packages Keep-Alive sont envoyés "0" - Les packages Keep-Alive ne sont pas envoyés. L'Interface Utilisateur perd la connexion à Automation Engine si aucune action n'est effectuée par l'utilisateur pendant une période prolongée (environ 2 heures). Définissez ce paramètre sur "1" pour éviter toute perte de connexion. L'envoi de packages Keep-Alive maintient la connexion active.
<active_keepalive>intervalle de temps<active_keepalive>	Durée en minutes au cours de laquelle l'Interface Utilisateur envoie des messages à l'Automation Engine pour maintenir la connexion. Ce paramètre est indépendant de <tcpip_keepalive>. Le paramètre <tcpip_keepalive> active le maintien de la connexion au niveau du socket, ce qui empêche de déterminer l'intervalle de temps des packages Keepalive. <active_keepalive> se réfère au niveau du programme.
<connections>	Début des éléments pour les connexions aux systèmes AE.
<connection name="nom" system="système">	Définition de la connexion à un système AE. "Nom" = alias pour la connexion à un système AE. La connexion avec ce nom peut être sélectionnée dans la fenêtre de connexion. "System" = nom du système AE. Le nom du système AE figure dans le fichier INI d'Automation Engine. Attention : les différents systèmes AE ne doivent pas porter le même nom.
<cp ip="DNS/IP" port="port"/>	Définition de la connexion au processus de communication du système AE. "DNS/IP" = indiquez soit le nom, soit l'adresse IP de l'ordinateur sur lequel le processus de communication s'exécute. "port" = numéro de port du processus de communication dans le système AE.
</connection>	Fin de l'élément XML<connection>.
</connections>	Fin de l'élément XML <connections>.
</configuration>	Fin de l'élément XML <configuration>.

Exemple d'un fichier uc4config.xml