Die meisten Konfigurationsoptionen für den Application Server werden in den verschiedenen Konfigurationsdateien festgelegt. Es ist wichtig zu verstehen, wie diese Dateien funktionieren, wenn Sie das Verhalten des Systems ändern möchten.
Alle Einstellungen in den Konfigurationsdateien des Application Server verwenden dasselbe Format:
Variable = Wert
...wobei Variable der Name der zu setzenden Application Server-Variable ist und Wert der Wert für diese Variable. Die Variablennamen stehen für die verschiedenen Optionen oder Einstellungen, die Sie für das Verhalten des Application Server festlegen können.
In den Konfigurationsdateien kennzeichnet das Rautenzeichen (#) einen Kommentar. Der Application Server ignoriert diese beim Verarbeiten der Konfigurationsdatei. InterAction installiert die Datei InterAction.cfg automatisch. Sie enthält mehrere Kommentare, die die Bedeutung der verschiedenen Einstellungen erklären.
Viele Variablen erlauben mehrere Werte. Wenn Sie eine Liste von Einträgen eingeben, trennen Sie diese mit Semikolons (;).
Zum Beispiel gibt die Variable SMTPSendAlertsTo die E-Mail-Adressen der Personen an, die E-Mail-Benachrichtigungen erhalten sollen, falls der Application Server auf ein Problem stößt. Wenn Sie möchten, dass diese Nachrichten an zwei verschiedene Benutzer gehen, würden Sie diese Option wie folgt einstellen:
Werte mit Semikolons trennen
SMTPSendAlertsTo = interactionadmin@crawford.com;iaadmin@crawford.com
Wenn Sie besonders lange Werte oder eine umfangreiche Liste von Werten eingeben, möchten Sie den Wert vielleicht auf mehrere Zeilen aufteilen. Das erleichtert das Lesen beim späteren Überprüfen oder Bearbeiten der Datei.
Dazu geben Sie am Ende jeder Zeile einen Backslash (\) ein. Der Application Server ignoriert in diesem Fall den Zeilenumbruch.
Zum Beispiel enthält der Wert für methodFiles mehrere Einträge in einer gut lesbaren Liste:
Wert auf mehrere Zeilen aufteilen
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;\
Ohne die Backslash-Zeichen würden dies als fünf separate Zeilen betrachtet werden.
Verwendung von Variablenersetzung
Variablenersetzung ermöglicht es Ihnen, einer Variablen in einer Konfigurationsdatei einen Wert zuzuweisen und dann den Namen der Variablen in anderen Konfigurationseinstellungen zu verwenden. Wenn der Application Server die Konfigurationsdatei verarbeitet, werden die Variablennamen durch ihre Werte ersetzt.
Die Variablenersetzung funktioniert in allen Konfigurationsdateien des Application Server und des Web Client.
Wenn Sie einen Variablennamen in einer Konfigurationseinstellung eingeben, verwenden Sie folgendes Format:
$(Variablenname)
Zum Beispiel enthält die Datei InterAction.cfg eine Variable namens SMTPDomain. Sie setzen diese auf den E-Mail-Domainnamen Ihrer Organisation – zum Beispiel „crawford.com“. Sie können diese Variable dann überall dort verwenden, wo Sie „crawford.com“ eingeben müssten:
Eine Variable angeben
SMTPDomain = crawford.com
...(weitere Einstellungen in der Datei)
SMTPSendAlertsTo = appserveradmin@$(SMTPDomain);iaadmin@$(SMTPDomain)
Im obigen Beispiel ersetzt der Application Server den Text crawford.com für jede Instanz von $(SMTPDomain). Die Option SMTPSendAlertsTo wird dann wie folgt aktualisiert:
Eine Variable verwenden
SMTPSendAlertsTo = appserveradmin@crawford.com;iaadmin@crawford.com
Wenn sich die Einstellung SMTPDomain aus irgendeinem Grund ändern muss, müssen Sie sie nur an einer Stelle anpassen.
Sie können Variablen auch so setzen, dass sie nicht sofort aktualisiert werden. Dazu geben Sie sie wie folgt ein:
$$(Variablenname)
Wenn Sie zum Beispiel die Variable Test auf $$(SMTPDomain) setzen, wird der Wert von Test zu $(SMTPDomain), nicht zum aktuellen Wert von SMTPDomain.
Dies wird hauptsächlich verwendet, wenn Sie die Webseiten für die Straßenkarten- und Wetteranbieter konfigurieren. Die Variablen werden ausgewertet, wenn das Nugget generiert wird.
Mehrere Konfigurationsdateien definieren
Sie können mehrere Konfigurationsdateien für den Application Server erstellen. Das ist nützlich, um zusammengehörige Gruppen von Konfigurationseinstellungen übersichtlich zu organisieren und die Wartung zu erleichtern.
Um zusätzliche Dateien zu definieren, listen Sie sie in der Option additionalConfigFiles in der InterAction.cfg auf. Das folgende Beispiel definiert zwei zusätzliche Konfigurationsdateien:
Mehrere Konfigurationsdateien definieren
additionalConfigFiles = $(IRIS_ETC_DIR)/InterActionWebPage.cfg;\
$(IRIS_HOME_DIR)/additionalFields.cfg;\
Die Datei InterAction.cfg wird immer zuerst gelesen. Die übrigen Konfigurationsdateien werden in der Reihenfolge verarbeitet, in der sie in der Variable additionalConfigFiles aufgeführt sind.
Wenn dieselbe Variable an mehreren Stellen definiert ist, wird die zuletzt definierte verwendet. Angenommen, Sie verwenden die oben gezeigte Einstellung additionalConfigFiles. Wenn Sie dieselbe Variable sowohl in der Datei InterAction.cfg als auch in der Datei IntDemo.cfg definieren, verwendet der Application Server den Wert aus der Datei IntDemo.cfg. So können Sie mit einem Satz von Variablen beginnen und mit zusätzlichen Konfigurationsdateien diese Variablen für bestimmte Situationen überschreiben.
Sie können den Bericht „Globale Umgebungsvariablen“ verwenden, um alle aktuell definierten Variablen und deren Werte anzuzeigen. Das ist hilfreich, wenn Sie herausfinden möchten, welcher Wert letztlich verwendet wurde. Weitere Informationen zur Verwendung der Berichte des Application Server finden Sie unter Administrative Berichte für den Application Server.
Intern definierte Variablen
Die InterAction.cfg enthält mehrere intern definierte Variablen, die Sie beim Festlegen von Werten verwenden können. Diese sind im Application Server definiert, nicht in der InterAction.cfg.
Typische Variablen, die Sie verwenden, sind zum Beispiel:
- hostName
- hostAddress