Alle Umgebungsvariablen, die globale Konfigurationseinstellungen betreffen, haben einen Namen, der mit PISASALES_WEBCLI_ beginnt. Daran wird die ID der globalen Einstellung in Kleinbuchstaben angehängt.
Beispiel:
export PISASALES_WEBCLI_wsv_frc_tls=trueSetzen Sie einen Wert auf $NONE (wörtlich), um eine leere Konfigurationseinstellung zu erzwingen.
Die folgende Tabelle listet alle unterstützten globalen Konfigurationseinstellungen auf:
| ID | Typ | Standard | Name | Beschreibung |
|---|---|---|---|---|
app_cfg_pth | text | (leer) | Anwendungskonfigurationspfad | Gibt einen spezifischen Pfad für Anwendungskonfigurationsdaten an, der anstelle des Standardpfads verwendet wird |
bas_wnd_hgt | text | 635 | Basis-Fensterdesignhöhe | Die Höhe des Fensters (Display, Monitor), das im Dialogdesign verwendet wird. Muss mindestens 600 betragen. |
bas_wnd_wdt | text | 900 | Basis-Fensterdesignbreite | Die Breite des Fensters (Display, Monitor), das im Dialogdesign verwendet wird. Muss mindestens 800 betragen. |
bsc_tmo_off | number | 0 | Warteanimation – „Aus"-Timeout-Zeit | Minimale Dauer in Millisekunden einer „Warten"-Animation. Auf 0 setzen für Standardwert. |
bsc_tmo_sho | number | 0 | Warteanimation – „Anzeigen"-Timeout-Zeit | Verzögerungszeit in Millisekunden, bevor eine „Warten"-Animation angezeigt wird; auf 0 setzen für Standardwert. |
chk_log_out | bool | false | Prüfung ordnungsgemäßer Sitzungsbeendigung | Wenn gesetzt, wird geprüft, ob die Benutzer sich ordnungsgemäß abmelden. Eine Warnung wird angezeigt, wenn eine vorherige Sitzung nicht korrekt abgemeldet wurde. |
cli_aut_dwn | bool | true | Automatischer Download | Die Eigenschaft „Automatischer Download" bestimmt, ob Downloads automatisch gestartet werden, d.h. ob eine Datei unmittelbar nach einer Benutzeranfrage an den Client übertragen wird. Es wird empfohlen, automatische Downloads aktiviert zu lassen. Falls Probleme mit Browsern auftreten, die den Download-Prozess blockieren, sollten Sie diese Eigenschaft auf false setzen. |
cus_css_url | text | (leer) | URL der benutzerdefinierten CSS-Definition | Wenn gesetzt, wird diese URL an den Webbrowser des Benutzers weitergegeben, um zusätzliche CSS-Definitionen bereitzustellen. Der Standard ist leer. |
cus_pvc_url | text | (leer) | Benutzerdefinierte Datenschutz-URL | Eine URL, die auf die Datenschutzrichtlinie Ihres Unternehmens verweist. Sie muss mit entweder „https://" oder „http://" beginnen. Standard ist die Datenschutzrichtlinie der JustRelate Deutschland GmbH. |
dbg_adv_jslog | bool | false | Debug: Erweiterte Protokollierung von JavaScript-Fehlern aktivieren | Wenn aktiv, werden mehr Kontextinformationen für eine bessere Analyse möglicher JavaScript-Fehler gespeichert. Dies erhöht den Speicherverbrauch des Webbrowsers. |
dbg_cmd_avl | bool | false | Debug: Spezielle Debug- und Testbefehle aktivieren | Gibt an, ob Debug-Befehle verfügbar sind. Der Standard ist false. |
dbg_mon_avl | bool | false | Debug: JustRelate CRM Web Client Monitor aktivieren | Diese Einstellung steuert, ob der JustRelate CRM Web Client Monitor verfügbar ist. Der Standard ist false. |
dbg_mon_pwd | password | (leer) | Debug: Kennwort für Zugriff auf JustRelate CRM Web Client Monitor erforderlich | Der Zugriff auf den JustRelate CRM Web Client Monitor kann durch ein Kennwort geschützt werden. Standardmäßig ist kein Kennwort gesetzt, sodass jeder auf den JustRelate CRM Web Client Monitor zugreifen kann. |
dbg_wvw_avl | bool | false | Debug: Spezielle „Watch"-Ansicht aktivieren | Gibt an, ob die spezielle „Watch"-Ansicht verfügbar ist. Der Standard ist false. |
dim_aut_lgi | bool | false | JustRelate CRM Desktop Integration – automatische Anmeldung aktivieren | Die auf der JustRelate CRM Desktop Integration basierende automatische Anmeldung beruht auf dem Benutzernamen und der Anmeldedomäne des Endbenutzers. Es wird dringend empfohlen, stattdessen ein sichereres Verfahren wie OpenID Connect zu verwenden. |
dim_frc_tls | bool | false | TLS für JustRelate CRM Desktop Integration erzwingen | Erzwingt die Verwendung von TLS für die Web-Socket-Verbindungen der JustRelate CRM Desktop Integration. |
dim_old_con | bool | false | JustRelate CRM Desktop Integration: Veraltetes URI-Schema zur Verbindungsherstellung verwenden | Wenn gesetzt, wird das veraltete URI-Schema zur Herstellung der Verbindung zur JustRelate CRM Desktop Integration verwendet. |
dim_ssn_tmo | number | 120 | JustRelate CRM Desktop Integration – Sitzungs-Timeout | Timeout in Sekunden, nach dem eine inaktive Verbindung zur JustRelate CRM Desktop Integration geschlossen wird. |
dim_use_lnk | bool | false | JustRelate CRM Desktop Integration – Initialisierungsmethode | Gibt die Methode an, wie die JustRelate CRM Desktop Integration initialisiert wird; auf true setzen, um einen speziellen Hyperlink zu verwenden, wenn die Standardmethode mit einem iframe-Element in Ihrer Umgebung nicht funktioniert. |
dim_wsc_url | text | /psawsc | JustRelate CRM Desktop Integration – Service-URL (Sicht des Endbenutzerbrowsers) | Die URL des JustRelate CRM Desktop Integration Service. Der Standard ist „/psawsc", was bedeutet, dass der Service vom selben Webserver gehostet wird und den Servlet-Namen „psawsc" hat. Die vollständige Syntax ist „[hostname[:port]]/servlet". |
dis_brw_plg | bool | false | JustRelate CRM Desktop Integration deaktivieren | Deaktiviert die JustRelate CRM Desktop Integration. Funktionen, die die JustRelate CRM Desktop Integration erfordern, stehen nicht zur Verfügung. Der Standardwert ist false. |
dis_dim_dnl | bool | false | Download der JustRelate CRM Desktop Integration deaktivieren | Wenn dieser Wert auf true gesetzt ist, können Benutzer das Installationsmodul der JustRelate CRM Desktop Integration nicht herunterladen. |
dis_dyn_ttp | bool | false | QuickViews: QuickViews deaktivieren | Wenn aktiviert, werden alle QuickViews vollständig deaktiviert und erscheinen nicht. |
dis_nfo_wdg | bool | false | Info-Widgets auf dem Anmeldebildschirm deaktivieren | Wenn aktiviert, werden keine Info-Widgets (Versionsinformationen etc.) auf dem Anmeldebildschirm angezeigt. |
dis_usr_cfg | bool | false | Benutzerkonfiguration verwerfen | Wenn aktiviert, werden alle benutzerspezifischen Konfigurationsdaten verworfen, sodass jede Sitzung mit leeren Konfigurationsdaten startet. |
dsk_nfy_off | bool | false | Desktop-Benachrichtigungen deaktivieren | Deaktiviert alle Desktop-Benachrichtigungen im Kontext des JustRelate CRM Web Clients. Im Portal-Modus empfiehlt es sich, Desktop-Benachrichtigungen zu deaktivieren. |
dsp_min_hgt | text | 768 | Minimal erforderliche Displayhöhe | Gibt die minimal erforderliche Displayhöhe in Pixeln an. Wenn die Höhe des Browser-Seitenbereichs kleiner als dieser Wert ist, erscheint eine Scrollbar. Der Wert 0 schaltet die Scrollbar aus. Ein negativer Wert bewirkt, dass der eingebaute Standard verwendet wird. |
dsp_min_wdt | text | 1280 | Minimal erforderliche Displaybreite | Gibt die minimal erforderliche Displaybreite in Pixeln an. Wenn die Breite des Browser-Seitenbereichs kleiner als dieser Wert ist, erscheint eine Scrollbar. Der Wert 0 schaltet die Scrollbar aus. Ein negativer Wert bewirkt, dass der eingebaute Standard verwendet wird. |
edt_cke5_bsc | bool | true | Basis-CK-Editor 5 verwenden | Eine Einstellung, die es ermöglicht, den CK Editor 5 mit reduzierter Symbolleiste oder Ballons zu verwenden. So wird der Editor schneller geladen und verbraucht weniger Speicher. Ein vollständig ausgestatteter Editor ist weiterhin verfügbar. Der Standardwert ist true. |
ena_ssn_cookies | bool | true | Sitzungs-Cookies aktivieren | Sitzungs-Cookies werden verwendet, um laufende Sitzungen bei der Verarbeitung von Objekt-Links zu identifizieren. Wenn Sitzungs-Cookies deaktiviert sind, erfordert jeder Objekt-Link eine explizite Anmeldung. |
ena_wake_locks | bool | true | Wake Locks aktivieren | Wake Locks verhindern, dass der Computer des Benutzers in den Ruhe- oder Schlafmodus wechselt, und beugen so Sitzungs-Timeouts vor. Wenn nicht aktiviert, sind Wake Locks global ausgeschaltet. Wenn aktiviert, können Benutzer Wake Locks selbst ein- oder ausschalten. |
frc_dlg_mod_bar | bool | false | Dialog-Änderungsleiste erzwingen | Diese Variable ist nur im Portal-Modus gültig. Sie erzwingt die Anzeige der Dialog-Änderungsleiste (Speichern/Abbrechen-Schaltflächen). Der Standardwert ist false. |
glb_dbg_mod | bool | false | Web Client DEBUG-Modus | Ermöglicht das Ein- oder Ausschalten des internen DEBUG-Modus. Der Standardwert ist „aus". |
glb_dsp_nam | text | (leer) | Anzeigename des JustRelate CRM Web Clients | Ein informativer Text, der diese JustRelate CRM Web Client-Instanz besser identifizieren kann. |
glb_ins_ids | text | (leer) | Instanz-ID des JustRelate CRM Web Clients | Eine ID-Zeichenkette, die diese JustRelate CRM Web Client-Instanz besser identifizieren kann. |
glb_rdr_frc | bool | false | Globale Weiterleitung erzwungen | Wenn dieser Wert auf true gesetzt und eine globale Weiterleitungs-URL angegeben ist, verweigert diese Instanz die Anmeldung und leitet alle Zugriffe auf die angegebene Weiterleitungs-URL um. |
glb_rdr_url | text | (leer) | Globale Weiterleitungs-URL | Gibt die globale Weiterleitungs-URL an. |
hid_ext_lgi_nfo | bool | false | Erweiterte Informationen bei der Anmeldung ausblenden | Blendet den Link zur Unternehmens-Homepage, zu den Datenschutzeinstellungen und zum Info-Bildschirm aus. |
imc_tim_tmo | number | 60 | Aktualisierungs-Timeout für ungelesene Nachrichten | Intervall (in Sekunden) für die Hintergrundaufgabe, die den Zähler ungelesener Nachrichten in der oberen Leiste aktualisiert. Ein Wert von 0 deaktiviert den Timer. |
ini_dis_lgi | bool | false | Anmeldung initial deaktiviert | Wenn auf true gesetzt, ist die Anmeldung nach dem Webserver-Start zunächst deaktiviert und muss explizit von einem Administrator aktiviert werden. |
lgi_bkg_clr | text | (leer) | Hintergrundfarbe des Anmeldebildschirms | Kann auf einen HTML-Farbwert wie „#00796B" gesetzt werden. Wenn gesetzt, wird diese Farbe anstelle eines Hintergrundbildes verwendet. Standardmäßig leer, sodass das Hintergrundbild angezeigt wird. |
lgi_lng_lis | text | (leer) | Sprachliste | Gibt die verfügbaren Sprachen auf der Anmeldeseite an. Die Syntax lautet „IDN(Titel:Code)[, IDN(Titel:Code)]". Beispiel: „GER(Deutsch:de), ENG(English:us)". |
lgi_lng_sel | bool | true | Sprachauswahl auf der Anmeldeseite verfügbar | Gibt an, ob der Benutzer eine bestimmte Sprache für die Sitzung auswählen kann. Dies überschreibt nicht die Spracheinstellungen des Benutzers im Repository. Der Standard ist true. |
lgi_nfo_txt | text | (leer) | Zusätzlicher Anmelde-Infotext | Wenn gesetzt, wird dieser Text auf der Anmeldeseite als besondere Nachricht bzw. Information für die Benutzer angezeigt. Ein Hyperlink kann mit folgender Syntax gesetzt werden: {link:URL/Titel}. |
lng_loc_ovr | text | (leer) | Standard-Sprach- und Locale-Überschreibungen | Überschreibt die Standard-Locale für verschiedene Sprachen. Geben Sie eine durch Semikolon getrennte Liste von Sprachcodes gemäß BCP 47 / RFC 5646 ein; Beispiel: „en-NZ; de-CH; es-AR". |
mac_use_tch | bool | false | Auf der Macintosh-Plattform immer zur mobilen App umleiten | Wenn auf true gesetzt, wird jede Objekt-Link-Anfrage von einem Macintosh-Client-Computer zur mobilen App umgeleitet. Dies ist auf eine Änderung in Safari auf dem iPad zurückzuführen, das sich als Desktop-System ausgibt. |
nav_hst_siz | number | 5 | Größe des Navigationsverlaufs | Dieser Wert wird nur im Portal-Modus verwendet. Er bestimmt die Anzahl der Dialoge, die über die Schaltflächen „Zurück" und „Vorwärts" erreichbar sind. Dialoge außerhalb dieses Bereichs werden verworfen und sind nicht mehr navigierbar. Die Anzahl navigierbarer Dialoge sollte gering gehalten werden, da diese Dialoge auch im Browser-DOM vorhanden sind. Es muss mindestens ein navigierbarer Dialog zugelassen sein. Der erwartete Wert ist eine ganze Zahl größer oder gleich 1. |
nfy_wnd_pos | text | BR | Position des Benachrichtigungsfensters | Gibt die Position an, an der Benachrichtigungsfenster erscheinen. Mögliche Werte sind „TL" (oben/links), „TH" (oben/Mitte), „TR" (oben/rechts), „VL" (Mitte/links), „VH" (Mitte/Mitte), „VR" (Mitte/rechts), „BL" (unten/links), „BH" (unten/Mitte), „BR" (unten/rechts). Der Standard ist „BR" (unten/rechts). |
nfy_wnd_tmo | number | 14 | Anzeigedauer des Benachrichtigungsfensters | Zeit in Sekunden, die ein Benachrichtigungsfenster sichtbar bleibt, wenn der Benutzer es nicht schließt. |
otn_tim_tmo | number | 0 | Timeout für den Timer offener Transaktionen | Intervall (in Sekunden) für die Hintergrundaufgabe, die prüft, ob Transaktionen offen sind. Der Standardwert 0 deaktiviert den Timer. |
plg_log_lvl | text | WARN | Log-Level der JustRelate CRM Desktop Integration | Legt das Log-Level der JustRelate CRM Desktop Integration fest. Der erwartete Wert ist einer von {TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF}. |
psc_blk_rdr | text | (leer) | Weiterleitung blockieren | Wenn der Benutzerzugriff auf den Portal-Anmeldebildschirm blockiert ist und dieser Parameter gesetzt ist, wird der Benutzer sofort zur angegebenen URL weitergeleitet. Der URL-Wert sollte mit einem Präfix versehen werden, d.h. der erwartete Wert hat die Form {fixed::www.xyz.com}. Standardmäßig ist dieser Parameter leer. |
psc_exi_rdr | text | login | Exit-Weiterleitungsoption | Die Weiterleitungsoption bestimmt, was passiert, wenn der Benutzer die Anwendung verlässt. Mögliche Werte sind {login} für die Weiterleitung zur Anmeldeseite, {blank} zum Anzeigen einer leeren Seite oder {fixed::www.xyz.com} für die Weiterleitung zu einer bestimmten URI. Der Standard ist {login}. Der Anwendungsserver kann diesen Wert überschreiben. |
psc_exi_rto | number | 3 | Exit-Weiterleitungs-Timeout | Das Weiterleitungs-Timeout gibt die Anzahl der Sekunden zwischen der Abmeldeaktion und dem Auslösen des Weiterleitungsprozesses an. Hinweis: Dieses Timeout ist erforderlich, um die aktuelle Benutzerkonfiguration persistenter Anwendungskomponenten zu speichern. Der empfohlene Wert ist 10; der Wert wird in Sekunden interpretiert. Standardmäßig 10. |
psc_msg_ttl | text | (leer) | Titel des Nachrichtendialogs | Bestimmt den Titel einfacher Meldungsfenster. Der Standardtitel dieser Fenster lautet „JustRelate CRM Client". Setzen Sie den Wert dieser Variablen auf eine nicht-leere Zeichenkette, um diesen Titel zu ändern. Der erwartete Werttyp ist eine Zeichenkette. Der Standardwert ist eine leere Zeichenkette. |
psc_por_app | text | (leer) | Portal-Anwendungsname | Der Portal-Anwendungsname legt eine Sales-Anwendung aus den verfügbaren Anwendungen fest, die im Portal-Modus als Sales-Anwendung verwendet wird. Dem Benutzer wird keine Option zur Auswahl einer anderen Anwendung angeboten. Stellen Sie sicher, dass die Anwendung auch im Anwendungssatz definiert ist. Der erwartete Wert ist eine Zeichenkette. |
psc_por_blk | bool | false | Portal-Anmeldezugriff blockieren | Dieser Parameter ermöglicht es Administratoren, den Zugriff auf den Benutzer-Anmeldebildschirm zu blockieren, wenn der Portal-Modus aktiviert ist. Diese Funktion kann nützlich sein, wenn der Client mit Server-Autologin verwendet wird und eine sehr spezifische Funktionalität bereitstellt. Der Standardwert ist false. |
psc_por_mod | bool | false | PSC Portal-Modus | Dieser Wert bestimmt, ob der Web Client im Vollmodus (false) oder Portal-Modus (true) läuft. Im Portal-Modus wird den Benutzern das PiSA Web Portal Interface präsentiert, das einen vereinfachten Zugriff auf das System bietet. |
shw_cli_nfo | bool | false | Client-Informationen bei der Anmeldung anzeigen | Wenn auf true gesetzt, werden einige Client-Informationen im Nachrichtenfenster angezeigt. Im Portal-Modus ist dieser Wert immer false. |
ssn_alv_tim_out | number | 5 | Session-Alive-Timeout | Das Session-Alive-Timeout gibt die Dauer in Minuten an, nach der eine inaktive Sitzung als beendet gilt. Ein Wert von weniger als 2 Minuten ist nicht zulässig. Die Zeit wird in Minuten gemessen; das Standard-Timeout beträgt 5 Minuten. |
ssn_frc_tls | bool | false | HTTPS-Protokoll erzwingen | Erzwingt die Verwendung des HTTPS-Protokolls. Der Standard ist false. |
tmp_frc_rap_tbl | bool | false | Temporär: Verwendung des klassischen Tabellensteuerelements erzwingen | Eine temporäre Option, die die Verwendung des klassischen Tabellensteuerelements erzwingt. |
ttp_sho_tmo | number | 0 | QuickViews: Tooltip/QuickView-Verzögerungszeit | Verzögerungszeit in Millisekunden, bevor ein Tooltip oder QuickView erscheint, wenn der Mauszeiger über einem Tooltip- oder QuickView-fähigen Element verweilt. Auf 0 setzen für den Standardwert. |
url_cli_img_ret_svc | text | (leer) | URL des Bildabrufdiensts | Wenn der angegebene URL-Wert nicht leer ist, zwingt diese Variable den Client, Ressourcen (wie Bilder) clientseitig über den Dienst abzurufen. Wenn die Variable leer ist, muss der Web-Client-Server Zugang zum Web haben. |
ver_nfo_rdc | bool | false | Reduzierte Versionsinformationen | Wenn aktiv, werden stark reduzierte Versionsinformationen im Versionsinformationsdialog angezeigt. |
wai_for_dim | number | 10 | JustRelate CRM Desktop Integration – Initialisierungs-Timeout | Timeout in Sekunden, bis eine Verbindung zur JustRelate CRM Desktop Integration hergestellt sein muss. |
web_cli_uri | text | (leer) | URI dieser JustRelate CRM Web Client-Instanz | Wenn diese JustRelate CRM Web Client-Instanz über verschiedene URIs erreichbar ist, sollte hier eine gemeinsame gültige URI angegeben werden. Sie muss mit dem korrekten Servlet-Namen enden. |
wsv_frc_tls | bool | false | TLS für Backend-Web-Socket-Verbindung erzwingen | Erzwingt die Verwendung von TLS für Web-Socket-Verbindungen, die vom Web-Client-Backend und dem Anwendungsserver erstellt werden. |
wsv_wsc_url | text | /psawsc | JustRelate CRM Desktop Integration – Service-URL (Sicht des Webservers) | Die URL des JustRelate CRM Desktop Integration Service. Der Standard ist „/psawsc", was bedeutet, dass der Service vom selben Webserver gehostet wird und den Servlet-Namen „psawsc" hat. Die vollständige Syntax ist „[hostname[:port]]/servlet". |
Um eine initiale Logging-Konfiguration zu erstellen oder eine bereits konfigurierte Web-Client-Installation zu aktualisieren, können logging-bezogene Umgebungsvariablen angegeben werden.
Alle Namen beginnen mit PISASALES_WEBCLI_LOG_:
Die folgenden Umgebungsvariablen werden für die Logging-Konfiguration erkannt:
| Name | Wert | Beschreibung |
|---|---|---|
LEVEL_ROOT | Root-Logger-Level | Mögliche Werte: OFF, ERROR, WARN, INFO, DEBUG, TRACE, ALL. Standard ist WARN. |
LEVELS | Logger-spezifische Level | Logger-spezifische Level als kommagetrennte logger=level-Liste, z.B. de.pisa.webcli.thm=DEBUG,de.pisa.webcli.vws=DEBUG. |
| DIR | Lokales Verzeichnis | Überschreibt das Verzeichnis, in das die Log-Dateien geschrieben werden. |
STDOUT | y / n | Auf y setzen, um das Log zusätzlich in die Konsole (stdout) zu schreiben, was die meisten Container-Log-Sammler erwarten. |
RECREATE | y / n | Auf y setzen, um die Umgebungsvariablen beim nächsten Start oder Konfigurationsneustart erneut auf die Logger-Konfiguration anzuwenden. |
Ein ungültiger Wert (ein unbekanntes Level oder ein fehlerhafter Eintrag) wird mit einer Warnung ignoriert, sodass ein Tippfehler den Logging-Start nie blockieren kann.
Die Werte werden angewendet, wenn die Logger-Konfigurationsdatei (logback.xml) beim Start der Webanwendung aus der eingebetteten Vorlage erzeugt wird. Die Vorlage enthält Platzhalter, die zum Zeitpunkt der Erzeugung ersetzt werden; jeder Standardwert bewahrt dabei das bisherige Verhalten exakt:
| Platzhalter | Bezogen aus | Standard |
|---|---|---|
###LOGDIR### | PISASALES_WEBCLI_LOG_DIR Umgebungsvariable, sonst konfiguriertes Log-Verzeichnis | Konfiguriertes Log-Verzeichnis |
###APPNAM### | Kontextpfad (unverändert) | Kontextpfad |
###ROOT_LEVEL### | PISASALES_WEBCLI_LOG_LEVEL_ROOT | WARN |
###LOGGER_LEVELS### | PISASALES_WEBCLI_LOG_LEVELS (gerendert als <logger .../>-Zeilen) | Leer |
###STDOUT_REF### | PISASALES_WEBCLI_LOG_STDOUT (rendert den <appender-ref ref="STDOUT"/>) | Leer |
Der STDOUT-Konsolen-Appender ist bereits in der Vorlage definiert; das Flag steuert lediglich, ob der Root-Logger darauf verweist – ein Eingriff in die Appender-Konfiguration ist daher nicht erforderlich.
Wenn PISASALES_WEBCLI_LOG_LEVELS einen Logger überschreibt, der bereits in der Vorlage konfiguriert ist (z.B. liefert die Vorlage de.pisa.webcli.cfg=INFO und die Umgebungsvariable setzt ihn auf DEBUG), wird die entsprechende Zeile der Vorlage vor dem Einfügen der Umgebungsvariablen entfernt, sodass jeder Logger nur einmal erscheint und der Wert der Umgebungsvariablen eindeutig übernommen wird (anstatt auf die „Letzter-gewinnt"-Reihenfolge mit verwirrenden Duplikaten zu setzen). Der Abgleich erfolgt auf Basis des exakten Logger-Namens, sodass ein spezifischerer Logger (de.pisa.webcli.ssn.RapSsnMgr) keinen Einfluss auf den Vorlageneintrag eines übergeordneten Loggers (de.pisa.webcli.ssn) hat.
Der Start der Webanwendung schreibt die Konfigurationsdatei nur dann, wenn sie noch nicht vorhanden ist:
logback.xml wird direkt geschrieben und die Logger-Konfiguration anschließend aktualisiert. Die Datei existiert nun, wird also nicht neu erzeugt; die Bearbeitung des Administrators wird geladen. Die Änderung des Administrators hat Vorrang.Grundprinzip: Die Umgebungsvariablen liefern die initiale Konfiguration (die Container-Rebuilds überdauert), während der Support zur Laufzeit weiterhin Log-Level über die Administrationsseite anpassen kann.
In einem Container ist das Konfigurationsverzeichnis flüchtig, sodass geänderte Umgebungsvariablen automatisch beim nächsten Start übernommen werden. Auf einer persistenten Installation (VM / Bare Metal) bleibt die vorhandene logback.xml erhalten, sodass ein geänderter Umgebungswert normalerweise nicht wirksam würde. Setzen Sie PISASALES_WEBCLI_LOG_RECREATE=y, um die Datei aus der Vorlage und den aktuellen Umgebungsvariablen neu zu erzeugen. Dies wird berücksichtigt:
Dies wird nicht berücksichtigt, wenn die Administrator-Logging-Seite das Logging zur Laufzeit neu konfiguriert, sodass eine Laufzeit-Änderung durch den Administrator niemals während einer Sitzung überschrieben wird. Typische Verwendung: PISASALES_WEBCLI_LOG_RECREATE=y für eine einmalige erneute Anwendung setzen (danach wieder entfernen, damit Administratoren wieder editieren können), oder dauerhaft aktivieren, um die Umgebungsvariablen bei jedem (Neu-)Laden als maßgeblich zu definieren.
Alle Umgebungsvariablen, die Login-Sets betreffen, haben einen Namen, der mit PISASALES_WEBCLI_LGI_ beginnt. Es gibt einen übergreifenden Wert namens PISASALES_WEBCLI_LGI_COUNT, der angibt, wie viele Login-Sets durch Umgebungsvariablen konfiguriert sind.
Alle Login-Set-spezifischen Werte haben ein Namenspräfix, das den passenden Index liefert: PISASALES_WEBCLI_LGI_n_ mit n = 1, 2, 3, ...
Für jedes Login-Set, das aus Umgebungsvariablen erstellt oder aktualisiert werden soll, muss der Login-Set-Name (auch Anwendungsname genannt) angegeben werden. D.h., die Umgebungsvariable PISASALES_WEBCLI_LGI_n_NAME muss einen nicht-leeren Namen liefern. Beispiel:
export PISASALES_WEBCLI_LGI_COUNT=2
export PISASALES_WEBCLI_LGI_1_NAME="Application One"
export PISASALES_WEBCLI_LGI_2_NAME="Application Two"Um ein neues Login-Set zu erstellen, müssen der Hostname und der Zielport angegeben werden. Alle anderen Werte sind optional.
Beispiel:
export PISASALES_WEBCLI_LGI_1_HOST=crm-host1.domain.com
export PISASALES_WEBCLI_LGI_1_PORT=42042Es ist weder erforderlich noch möglich, alle Eigenschaften über Umgebungsvariablen zu setzen. Wenn eine bestimmte Eigenschaft nicht gesetzt ist, wird der aktuelle Wert eines vorhandenen Login-Sets oder der Standardwert eines neuen Login-Sets wirksam.
Die folgenden grundlegenden Werte werden erkannt:
| Name | Wert | Beschreibung |
|---|---|---|
NAME | Anwendungsname | Der Name des Login-Sets, der in der Anwendungsauswahl angezeigt wird. |
HOST | Hostname | Der Hostname des Anwendungsservers. |
PORT | 0 < Portnummer < 65535 | Der TCP-Port, an dem der Anwendungsserver lauscht. |
USER | Benutzername | Der Standard-Benutzername. Wird normalerweise nicht benötigt. |
SASHPROPS | y / n | Persistente Sash-Positionen. |
TABITEMS | y / n | Persistente Unterreiter-Auswahl. |
FIXED | y / n | Wenn gesetzt, kann der Benutzer den Anmeldenamen nicht ändern. In diesem Fall muss USER gesetzt sein. |
AUTOLOGIN | y / n | Das Setzen von AUTOLOGIN auf y erfordert, dass USER gesetzt ist, und kann verwendet werden, um die Anwendung unter Umgehung der Anmeldeseite zu starten, wenn der Web Client mit einer entsprechenden URL aufgerufen wird. |
Alle erweiterten Anwendungskonfigurationsoptionen haben das Namenspräfix PISASALES_WEBCLI_LGI_n_CFG_ mit n = 1, 2, 3, ...
Die folgenden erweiterten Anwendungskonfigurationsoptionen werden erkannt:
| Name | Wert | Beschreibung |
|---|---|---|
FORCETMS | Zeitstempel im PisaCubes-Format | Benutzerkonfigurationen, die älter als der angegebene Zeitstempel sind, übernehmen Konfigurationseinstellungen aus dem Login-Set. |
BRWVIEW | y / n | Zeigt oder versteckt die „Browser"-Ansicht. |
DSKVIEW | y / n | Zeigt oder versteckt die „Desktop"-Ansicht. |
FNCPANEL | y / n | Zeigt oder versteckt das Funktionspanel. |
MSGVIEW | y / n | Zeigt oder versteckt die „Nachrichten"-Ansicht. |
MULTIXTV | y / n | Aktiviert oder deaktiviert mehrere externe Ansichten. |
NOOVERFLOW | y / n | Wenn aktiv, werden Haupt-Tabs, die unsichtbar werden, sofort geschlossen. |
PUSHSVC | y / n | Aktiviert oder deaktiviert den Push-Benachrichtigungsdienst. |
QVWSHOWALL | y / n | Aktiviert oder deaktiviert die Funktion „Alle QuickViews anzeigen". |
QVWSHOWEXT | y / n | Aktiviert oder deaktiviert die Funktion „QuickViews in externen Ansichten anzeigen". |
RCNCTRLS | y / n | Zeigt oder versteckt die Datensatz-Navigationssteuerung. |
TABGROUPING | y / n | Aktiviert oder deaktiviert die Funktion „Tab-Gruppierung". |
TBPINNED | y / n | Legt fest, ob die zweite obere Menüleiste angeheftet oder losgelöst ist. |
VIEWTGL | y / n | Legt fest, ob die Ansichts-Umschalttasten sichtbar oder ausgeblendet sind. |
WSCTLS | y / n | TLS für den Push-Benachrichtigungsdienst erzwingen. |
WSCURL | URL | Legt eine spezifische Web-Socket-URL für den Push-Benachrichtigungsdienst fest. |
XVIEWTAB | y / n | Gibt an, ob externe Ansichten in einem neuen Browser-Tab (y) anstatt in einem Popup-Fenster (n) geöffnet werden sollen. |
Alle Load-Balancing-bezogenen Optionen haben das Namenspräfix PISASALES_WEBCLI_LGI_n_LBA_ mit n = 1, 2, 3, ...
Die folgenden Load-Balancing-bezogenen Optionen werden erkannt:
| Name | Wert | Beschreibung |
|---|---|---|
LBA_USE | y / n | Aktiviert oder deaktiviert die Load-Balancing-Funktion. |
LBA_DEFHOST | y / n | Gibt an, ob der Standard-Host in die Liste der Ziel-Hosts aufgenommen werden soll. |
LBA_TIMEOUT | Sekunden | Ein Socket-Timeout in Sekunden, um auf eine Antwort eines Anwendungsservers zu warten. |
LBA_COUNT | k = 1, 2, 3, ... | Die Anzahl der Hosts, die im Load-Balancing-Prozess kontaktiert werden sollen. |
LBA_HOST_k_NAME | Hostname | Der Hostname des k-ten Hosts. k = 1, 2, 3, ... |
LBA_HOST_k_PORT | 0 < Portnummer < 65535 | Der TCP-Port des k-ten Hosts. k = 1, 2, 3, ... |
Für jeden Load-Balancing-Host müssen der Hostname und der TCP-Port angegeben werden.
Alle OpenID-Connect-bezogenen Optionen („OIDC") haben das Namenspräfix PISASALES_WEBCLI_LGI_n_OIDC_ mit n = 1, 2, 3, ...
Die folgenden OpenID-Connect-bezogenen Optionen werden erkannt:
| Name | Wert | Beschreibung |
|---|---|---|
DCU | URI | Die URI des Discovery-Dokuments. |
SVU | URI | Die URI des Authentifizierungsdienstes. |
TEU | URI | Die URI des Token-Endpunkts. |
CID | text | Die Client-ID. |
SEC | text | Das Client-Geheimnis. |
RDR | URI | Die Weiterleitungs-URI. |
SCS | text | Zusätzliche Scopes, die vom ID-Provider angefordert werden sollen. |
FRC | y / n | Wenn auf y gesetzt, muss der Benutzer immer ein vollständiges Anmeldeverfahren durchlaufen. |
POP | y / n | Wenn auf y gesetzt, sollte der Authentifizierungsdienst ein Popup-Fenster anzeigen. |
POP | JSON | Die Größe des Popup-Fensters als JSON. |