La plupart des options de configuration pour le serveur d'application sont définies dans les différents fichiers de configuration. Comprendre comment ces fichiers fonctionnent est important si vous souhaitez modifier le comportement du système.
Tous les paramètres dans les fichiers de configuration du serveur d'application utilisent le même format :
Variable = Valeur
...où Variable est le nom de la variable du serveur d'application à définir, et Valeur est la valeur pour la variable. Les noms de variables représentent les différentes options ou paramètres que vous pouvez définir pour le comportement du serveur d'application.
Dans les fichiers de configuration, le caractère dièse (#) indique un commentaire. Le serveur d'application ignore ces commentaires lors du traitement du fichier de configuration. InterAction installe automatiquement le fichier InterAction.cfg. Il inclut plusieurs commentaires expliquant la signification des différents paramètres.
De nombreuses variables permettent plusieurs valeurs. Chaque fois que vous entrez une liste d'éléments, séparez-les par des points-virgules (;).
Par exemple, la variable SMTPSendAlertsTo spécifie les adresses e-mail des personnes qui doivent recevoir des alertes par e-mail si le serveur d'application rencontre un problème. Si vous souhaitez que ces messages soient envoyés à deux utilisateurs différents, vous définiriez cette option comme suit :
Utilisation de points-virgules pour séparer les valeurs
SMTPSendAlertsTo = interactionadmin@crawford.com;iaadmin@crawford.com
Lorsque vous entrez des valeurs particulièrement longues, ou une longue liste de valeurs, vous pouvez vouloir diviser la valeur en plusieurs lignes. Cela facilite la lecture lors de la révision ou de la modification ultérieure du fichier.
Pour ce faire, entrez un antislash (\) à la fin de chaque ligne. Le serveur d'application ignore le saut de ligne dans ce cas.
Par exemple, la valeur pour methodFiles a plusieurs éléments entrés dans une liste facile à lire :
Diviser la valeur en plusieurs lignes
methodFiles = $(IRIS_ETC_DIR)/InterActionMethods.xml;\
$(IRIS_ETC_DIR)/IAMethods.xml;\
$(IRIS_ETC_DIR)/InterActionWebPageMethods.xml;\
$(IRIS_ETC_DIR)/pages.xml;\
$(IRIS_ETC_DIR)/nuggetMethods.xml;\
Sans les caractères antislash, cela serait considéré comme cinq lignes distinctes.
Utilisation de la substitution de variables
La substitution de variables vous permet de définir une variable à une valeur dans un fichier de configuration, puis d'utiliser le nom de la variable dans d'autres paramètres de configuration. Lorsque le serveur d'application traite le fichier de configuration, les noms de variables sont remplacés par leurs valeurs.
La substitution de variables fonctionne dans les différents fichiers de configuration du serveur d'application et du Web Client.
Lorsque vous entrez un nom de variable dans un paramètre de configuration, vous l'entrez comme suit :
$(Nom de la variable)
Par exemple, le fichier InterAction.cfg inclut une variable appelée SMTPDomain. Vous la définissez sur le nom de domaine e-mail de votre organisation - par exemple, "crawford.com". Vous pouvez ensuite l'utiliser comme une variable partout où vous devez entrer "crawford.com" :
Spécification d'une variable
SMTPDomain = crawford.com
...(autres paramètres dans le fichier)
SMTPSendAlertsTo = appserveradmin@$(SMTPDomain);iaadmin@$(SMTPDomain)
Dans l'exemple ci-dessus, le serveur d'application substitue le texte crawford.com pour chaque instance de $(SMTPDomain). L'option SMTPSendAlertsTo se met à jour comme suit :
Utilisation d'une variable
SMTPSendAlertsTo = appserveradmin@crawford.com;iaadmin@crawford.com
Si le paramètre SMTPDomain doit changer pour une raison quelconque, vous n'avez besoin de le changer qu'à un seul endroit.
Vous pouvez également définir des variables pour ne pas se mettre à jour immédiatement. Pour ce faire, vous l'entrez comme suit :
$$(Nom de la variable)
Par exemple, si vous définissez la variable Test à $$(SMTPDomain), la valeur de Test deviendrait $(SMTPDomain), et non la valeur actuelle de SMTPDomain.
Cela est principalement utilisé lors de la configuration des sites Web pour les fournisseurs de cartes de rue et de météo. Les variables sont évaluées lorsque le nugget est généré.
Définir plusieurs fichiers de configuration
Vous pouvez créer plusieurs fichiers de configuration pour le serveur d'application. Cela est utile pour organiser des groupes de paramètres de configuration liés pour une maintenance plus facile.
Pour définir des fichiers supplémentaires, vous les listez dans l'option additionalConfigFiles dans le fichier InterAction.cfg. L'exemple suivant définit deux fichiers de configuration supplémentaires :
Définir plusieurs fichiers de configuration
additionalConfigFiles = $(IRIS_ETC_DIR)/InterActionWebPage.cfg;\
$(IRIS_HOME_DIR)/additionalFields.cfg;\
Le fichier InterAction.cfg est toujours lu en premier. Les fichiers de configuration restants sont traités dans l'ordre dans lequel ils sont listés dans la variable additionalConfigFiles.
Si la même variable est définie à plusieurs endroits, la dernière définie est utilisée. Par exemple, supposons un environnement utilisant le paramètre additionalConfigFiles montré ci-dessus. Si vous définissez la même variable à la fois dans le fichier InterAction.cfg et dans le fichier IntDemo.cfg, le serveur d'application utiliserait la valeur définie dans le fichier IntDemo.cfg. Cela vous permet de commencer avec un ensemble de variables et d'utiliser des fichiers de configuration supplémentaires pour remplacer ces variables pour des situations particulières.
Vous pouvez utiliser le rapport des variables d'environnement globales pour voir toutes les variables actuellement définies et leurs valeurs. Cela est utile si vous devez déterminer quelle valeur a été retenue. Pour plus de détails sur l'utilisation des rapports du serveur d'application, voir Rapports administratifs pour le serveur d'application.
Variables définies en interne
Le fichier InterAction.cfg inclut plusieurs variables définies en interne que vous pouvez utiliser lors de la définition des valeurs. Celles-ci sont définies dans le serveur d'application, pas dans le fichier InterAction.cfg.
Les variables typiques que vous utilisez incluent les suivantes :
- hostName
- hostAddress