Systemparameter GW

Allgemeines

Grundsätzliche Informationen zur Verwendung von Systemparametern finden Sie im Kapitel Systemparameter im Handbuch zum Modul "Portal & Organisation".

Webdesk unterstützt folgende Groupware-Systeme (symbolische Namen in Klammern): Microsoft Exchange über Exchange Webservices (ExchangeWS_v2), Microsoft 365 / Exchange Online über Microsoft Graph (Graph), Lotus Notes/Domino (LotusNotes), Zimbra (Zimbra) und GroupWise (Groupwise).

Einige Parameter sind nur der systemweite Standardwert: Ist in den Groupware-Einstellungen des Mandanten (Reiter "Groupware") die Option "Lokale Konfiguration" aktiv und ein Wert gesetzt, hat dieser Vorrang (in der Tabelle vermerkt). Microsoft Graph wird ausschließlich in den Groupware-Einstellungen des Mandanten (externe APIs) konfiguriert und hat keine eigenen Systemparameter.

Referenz der relevanten Systemparameter für das GW-Modul

Modul

Bean

Eigenschaft

Erklärung

mögliche Wert(e)

gw

GwOptions

serviceImplementationDefault

Groupware-System, das für eine Person verwendet wird, wenn weder der Mandant (lokale Konfiguration) noch customSystemImplementationSelectorBean noch mailDomainServiceImplementationMapping ein System bestimmen. Der früher mögliche Wert ExchangeWS (Exchange 2007-2013) existiert nicht mehr und wird ignoriert; es gilt dann ExchangeWS_v2.

ExchangeWS_v2 (Standard), Graph, LotusNotes, Zimbra, Groupwise

gw

GwOptions

mailDomainServiceImplementationMapping

Zuordnung der Mail-Domäne einer Person zum Groupware-System (je Eintrag @domäne = System). Wird verwendet, wenn der Mandant keine lokale Konfiguration mit Groupware-System hat und kein customSystemImplementationSelectorBean ein System liefert. Die ausgelieferten Einträge sind Beispiele.

z.B. @firma.at = ExchangeWS_v2

gw

GwOptions

customSystemImplementationSelectorBean

Name einer Bean, die das Groupware-System je Person ermittelt (z.B. bei gemischtem Betrieb von Exchange und Microsoft 365). Mitgeliefert wird GwLdapAttributeBasedSystemImplementationSelector: Sie sucht die Person anhand ihrer Mail-Adresse im LDAP (Parameter ldapProviderUrl, ldapUser, ldapPassword, ldapBaseDn dieser Bean) und wertet die Einträge in expressions (je Eintrag JavaScript-Ausdruck;System) aus. Die lokale Konfiguration des Mandanten hat Vorrang.

Bean-Name (Standard: leer)

gw

GwOptions

generalUser

Technischer Benutzer für den Zugriff auf das Groupware-System. Kann in den Server-Parameterlisten als $generalUser verwendet werden. Ein Benutzer in den Groupware-Einstellungen des Mandanten hat Vorrang.

gw

GwOptions

generalPassword

Passwort des technischen Benutzers (verschlüsselt gespeichert). Kann in den Server-Parameterlisten als $generalPassword verwendet werden. Ein Passwort in den Groupware-Einstellungen des Mandanten hat Vorrang.

*****

gw

GwOptions

groupsToCheck

Kurznamen der Gruppen, deren Personen für die Groupware-Integration aktiviert sind (Termine lesen und synchronisieren). Endet ein Kurzname mit +, werden auch die Personen aller Untergruppen berücksichtigt; * aktiviert alle Personen. Zusätzlich sind alle Personen eines Mandanten aktiviert, wenn in dessen Groupware-Einstellungen "Für alle Personen aktiviert" gesetzt ist. Für Microsoft Graph wird die Aktivierung pro Person über die externe API gesteuert.

Liste von Gruppen-Kurznamen (Standard: leer)

gw

GwOptions

personsNotToCheck

Personen, deren Groupware-Kalender nie gelesen oder beschrieben werden (Angabe des Benutzernamens).

Liste von Benutzernamen (Standard: dek)

gw

GwOptions

wfFlagValueForWrittenAppointments

Kategorie, mit der Termine gekennzeichnet werden, die Webdesk in den Groupware-Kalender schreibt (früher wfFlag).

Text (Standard: Webdesk3)

gw

GwOptions

monthsToCheckInPast

Zeitspanne in Monaten in die Vergangenheit, in der der Job "DeleteCalendarDates" von Webdesk geschriebene Termine löscht. Der Job "syncCalendarDates" verwendet eigene Job-Parameter.

Zahl (Standard: 1)

gw

GwOptions

monthsToCheckInFuture

Zeitspanne in Monaten in die Zukunft, in der der Job "DeleteCalendarDates" von Webdesk geschriebene Termine löscht.

Zahl (Standard: 4)

gw

GwOptions

userMappingStrategy

Ermittlung des Groupware-Benutzers einer Person: USERNAME = Benutzername der Person, EMAIL = Mail-Adresse der Person, LDAP = Abfrage im LDAP (siehe GwADLdapClient). Mandanten-Einstellung "Benutzer Mapping Strategie" hat Vorrang.

LDAP (Standard), EMAIL, USERNAME

gw

GwOptions

userMappingField

Feld der Person, mit dem bei userMappingStrategy LDAP gesucht wird. Mandanten-Einstellung "Feld aus Stammsatz für Groupware User" hat Vorrang.

USERNAME (Standard), MAILADDRESS, EMPLOYEEID

gw

GwOptions

allowEditOfMailForwardingAsAdmin

Bei true können Administratoren beim Bearbeiten einer anderen Person auch deren Mail-Weiterleitung in den Groupware-Einstellungen (Abwesenheit) ändern. Die eigenen Einstellungen sind immer bearbeitbar.

true/false (Standard: false)

gw

GwADLdapClient

ldapProviderUrl

URL des LDAP-Servers, über den bei userMappingStrategy LDAP die Groupware-Daten der Person ermittelt werden. Die LDAP-Angaben in den Groupware-Einstellungen des Mandanten (lokale Konfiguration) haben Vorrang.

ldap://testserver (muss angepasst werden)

gw

GwADLdapClient

ldapUser

Benutzer für die LDAP-Abfrage.

sadmin

gw

GwADLdapClient

ldapPassword

Passwort für die LDAP-Abfrage (verschlüsselt gespeichert).

*********

gw

GwADLdapClient

ldapBaseDn

Basis-DN(s), unter denen gesucht wird.

o=zeit

gw

GwADLdapClient

ldapSearchQuery

LDAP-Suchabfrage; {0} wird durch den Wert des Felds userMappingField ersetzt.

(&(objectclass=person)(uid={0}))

gw

GwADLdapClient

ldapSearchSubTree

Auch in Unterknoten der Basis-DN suchen.

true/false (Standard: true)

gw

GwADLdapClient

cutDomain

Bei true wird der Domänen-Anteil des Benutzernamens bei der LDAP-Suche nicht berücksichtigt.

true/false (Standard: true)

gw

GwLegacyLdapFieldNameConfiguration

ldapFieldNameHomeServer, ldapFieldNameMailboxName, ldapFieldNamePrincipalName, ldapFieldNameMailAddress

LDAP-Feldnamen für Homeserver, Mailbox/Maildatei, Principal-Name und Mail-Adresse (früher in der Bean GwADLdapClient). Werden nur verwendet, wenn alle vier Felder befüllt sind; sonst gelten die Standardwerte des jeweiligen Groupware-Systems (Exchange: msExchHomeServerName, mailNickname, userPrincipalName, mail; Notes: mailserver, mailfile, displayname, mail; Zimbra: zimbraMailHost, mail, mail, mail).

LDAP-Feldname (Standard: leer)

gw

GwServerParamListExchange2016Ws, GwServerParamListLotusNotes, GwServerParamListZimbra, GwServerParamListGroupwise

elements

Verbindungsdaten je Groupware-Server des jeweiligen Systems (früher Bean GwServerParamList), je Eintrag Servername;URL;Port;Benutzer;Passwort. Für Benutzer und Passwort können $generalUser und $generalPassword verwendet werden; das Passwort wird hier sonst unverschlüsselt gespeichert. Die Verbindungsdaten in den Groupware-Einstellungen des Mandanten (lokale Konfiguration) haben Vorrang.

z.B. server1;https://server1/EWS/Exchange.asmx;;$generalUser;$generalPassword

gw

GwCalendarServiceNotesImpl

deliverAllAppointmentTypes

Bei true werden alle Notes-Termintypen gelesen, bei false nur Termine, ganztägige Ereignisse und Besprechungen (keine Jahrestage und Erinnerungen).

true/false (Standard: true)

gw

GwCalendarServiceNotesImpl

freeBusyServerParams

Eigener Server für Frei/Belegt-Abfragen in Notes, im Format Servername;URL;Port;Benutzer;Passwort. Leer: Frei/Belegt wird über die normale Verbindung abgefragt.

Standard: leer

gw

GwCalendarServiceNotesImpl

secondsToLiveDominoFreeBusyCache

Dauer in Sekunden, bis der Free/busy Cache zwischen Abfragen erneuert wird; 0 oder leer schaltet den Cache aus.

900

gw

GwCalendarServiceExchangeImpl

absenceReasonsToSync, allowedEntriesPostfix, alternateFreeBusyServer, busyStatus, descPrefix, groupsToCheck, monthsToCheckInFuture, monthsToCheckInPast, notAllowedEntriesPostfix, personsNotToCheck, syncType, useSpecialMapiProperties

Entfernt. Die Anbindung an Exchange über WebDAV (Exchange 2000-2007) existiert nicht mehr. Exchange wird über ExchangeWS_v2 oder Microsoft Graph angebunden.

-

gw

GwCalendarServiceExchangeWSImpl

absenceReasonsToSync, allowedEntriesPostfix, busyStatus, descPrefix, disableChunkedEncoding, groupsToCheck, monthsToCheckInFuture, monthsToCheckInPast, notAllowedEntriesPostfix, ntlmDomain, ntlmDomainController, personsNotToCheck, recreateServiceStubOnEveryCall, syncType, useNtlmAuthenticationScheme, useOnlyBasicAuthenticationScheme, wfFlag

Entfernt. Die Anbindung an Exchange 2007-2013 über die alte Exchange-Webservice-Schnittstelle (System ExchangeWS) existiert nicht mehr. Exchange wird über ExchangeWS_v2 oder Microsoft Graph angebunden.

-

gw

GwCalendarServiceNotesImpl

absenceReasonsToSync, allowedEntriesPostfix, descPrefix, groupsToCheck, monthsToCheckInFuture, monthsToCheckInPast, notAllowedEntriesPostfix, personsNotToCheck, syncType, userdataLocation, wfFlag

Entfernt. Diese Parameter gibt es nicht mehr je Groupware-System. Ersatz: groupsToCheck, personsNotToCheck, monthsToCheckInPast, monthsToCheckInFuture und wfFlag (jetzt wfFlagValueForWrittenAppointments) in der Bean GwOptions; syncType, absenceReasonsToSync, descPrefix, allowedEntriesPostfix und notAllowedEntriesPostfix sind Parameter des Jobs "syncCalendarDates" (Standardwerte für descPrefix, allowedEntriesPostfix, notAllowedEntriesPostfix und die Fehlgründe in der Bean TaSyncCalendarDatesDefaultSettings). userdataLocation entfällt ersatzlos.

-

gw

GwRefreshableCalendarServiceTargetSource

beanId, defaultBeanId, generalInterface

Entfernt. Das Groupware-System wird über GwOptions.serviceImplementationDefault, GwOptions.mailDomainServiceImplementationMapping bzw. die Groupware-Einstellungen des Mandanten festgelegt.

-

Kommentare (0)