Update auf 2024.5.x

Die Update-Dokumentation beschreibt die Schritte, die aus technischer Sicht zum Update einer Major-Version notwendig sind und gibt Hinweise, worauf aus technischer Sicht geachtet werden muss.

Voraussetzungen

Vorgehensweise

1. Bei dem Update ist unbedingt darauf zu achten, die einzelnen Schritte in der angegebenen Reihenfolge komplett abzuarbeiten und sich dabei exakt an die Anleitung zu halten. Im Fehlerfall ist die im Update Verzeichnis liegende Update und Update_Debug Textdatei zu sichern und mit dem Support Rücksprache zu halten.

2. Wenn Sie die Update-Prozedur erfolgreich abgeschlossen haben, teilen Sie uns bitte mit (support@cursor.de), welche Systeme (z.B. Test- oder Produktiv-System) Sie auf welche Version aktualisiert haben. Nur so können wir im Falle einer Support-Frage Ihr Problem möglichst schnell in unserem Haus prüfen.

Versionen

Versionsvoraussetzungen für das CRM:

Tipp

Generell sollte immer der aktuelle Patch für die alte Version eingespielt werden, um Probleme beim Update zu vermeiden.
Wird der Customizing Transport verwendet, empfehlen wir den Transport aller Pakete vor dem Update und auch eine Spiegelung der Datenbank (Prod in Test und QS). Auch sollte das Update über ein Wartungsfenster durchgeführt werden.

Prüfung der Metadaten

Beim Update auf Version werden die Metadaten der Installation geprüft. In kritischen Fällen kann es sein, dass diese Prüfung das Fortführen des Update verhindert.

Systemvoraussetzungen und Softwarekomponenten

Beachten Sie die Dokumentation, welche Systemvoraussetzungen und Softwarekomponenten erforderlich sind.

Systemvoraussetzungen für Update

Software-Voraussetzungen

Die Systemvoraussetzungen können unter Systemvoraussetzungen  eingesehen werden. Erforderliche Portfreigaben zwischen Rich Client und Applikationsserver finden Sie ebenfalls in dem Dokument.

Update-Vorbereitungen

Download der Version

Um die für Update-Zwecke benötigte Programm-Version zu erhalten, melden Sie sich bitte im Kundenbereich von www.cursor.de an. Dort können Sie im Downloadbereich das entsprechende Paket beziehen. Bei Rückfragen wenden Sie sich bitte an den Support der CURSOR Software AG (support@cursor.de). Nachdem Sie die gezippte Datei heruntergeladen haben, entpacken Sie diese auf dem Applikationsserver.

Verzeichnisstruktur des Update- bzw. Installationspakets

Nachdem Sie die gezippte Datei für beispielsweise CURSOR-CRM 2024.5 (24.5.x) entpackt haben, ergibt sich (unter anderem) folgende ähnliche Verzeichnisstruktur:

Hauptverzeichnis: CURSOR-CRM_24.5.X (Im Folgenden <INSTALL-DIR> genannt).

Unterverzeichnis:

• client (CURSOR-CRM-Client)

• clientlog (Verzeichnis/Freigabe für Clientlogs)

• cti (Dateien für einen CTI Server)

• db (Datenbankskripte)

• installer (Die Dateien des Update- bzw. Installationstools)

• jdk (Open JDK für Windows und Linux)

• server (Applikationsserver JBoss)

• tools (Tools für die Installation)
  

  

Wartungsfenster einrichten, um alle Benutzer abmelden

Bevor Sie mit dem Update beginnen, stellen Sie sicher, dass keine User im System angemeldet sind. Angemeldete User können im Windows Client über das Menü Extras / Aktive Benutzer oder im Webclient über Benutzermenü / Aktive Benutzer angezeigt werden. Aktive Benutzer können per "Mail senden" Aktion eine E-Mail erhalten.

Eine deutlich einfachere Variante ist die Anlage eines Wartungsfensters. Hierbei können die Benutzer informiert werden, dass eine Wartung ansteht und sie werden zum definierten Zeitpunkt vom System abgemeldet.

Unter Administration / Datenfluss einen neuen Wartungsfenster - Datensatz anlegen und dort die Informationen pflegen. Der Benutzer, der dort hinterlegt wird, muss auch das Update ausführen, da nur dieser Benutzer sich im Zeitraum des Wartungsfensters am System anmelden kann.
Es werden alle Timer für diese Zeit ausgesetzt, laufende Prozesse werden aber nicht unterbrochen. Es ist daher sinnvoll, wenn etwas Zeit vor dem eigentlichen Update für den Wartungszeitraum reserviert wird.

Externe Datenbankschnittstellen sollten ebenfalls während eines Updates deaktiviert werden.

Massendatenserver prüfen

Unter Optionen / Systemeinstellungen / Allgemein / Adresse des Anwendungsservers prüfen Sie, ob ein Massendatenserver eingerichtet wurde. Dieser darf zum Zeitpunkt des Updates nicht aktiv sein. Falls Sie das Update am Massendatenserver ausführen, erhalten Sie im Verlauf der Aktualisierung einen Hinweis.

Datenbank sichern

• Microsoft SQL Server: Über Microsoft SQL Server Management Studio.

• ORACLE: Auf dem Datenbankserver über EXPDP das aktuelle Schema exportieren.

Für beide Datenbanksysteme werden hierfür in der Regel Skripte bei der Installation bereitgestellt. Den genauen Pfad entnehmen Sie der bei der Installation mitgelieferten Installationsübersicht im Feld Skriptverzeichnis. Dies befindet sich im Abschnitt Datenbanken (DB).

Bei Produktivsystemen kann es sinnvoll sein, die Sicherung vor dem Update manuell durchzuführen. Die Updateroutine kann die Sicherung allerdings auch durchführen. Wird die Sicherung vorher manuell erstellt, empfiehlt es sich, die Sicherung im Rahmen des Updates zu deaktivieren.

Alternativ ist es ab Version 21.2 nun möglich unseren neuen Spiegelungsassistenten zu nutzen:

Voraussetzungen des Spiegelungsassistenten:

• Verfügbar ab Version CRM Version 21.2

• Der ausführende Anwender muss Admin Berechtigungen haben.

• Es muss mindestens eine 2 System Landschaft mit gleicher CRM Version geben.

• Es dürfen keine offenen Customizing Pakete in den Zielsystemen existieren (dies wird vom Assistenten geprüft).

Datenbank-Skripte sichern

Bei einigen Kunden wurden Änderungen an den Datenbank-Scripten in db\scripts oder im Verzeichnis db\scripts\stmts vorgenommen. Häufig ist die Datei propertymapper.sql angepasst oder auch die Datei RenewIndexes.sql um kundenspezifische Indizes erweitert.

Geplante Tasks deaktivieren

Bei einigen Kunden werden z.B. stündlich automatisch Tasks gestartet, die z.B. einen Import in die Datenbank ausführen. Diese Tasks müssen vor dem Update beendet werden, da es sonst Konflikte während der Aktualisierung der Datenbankstrukturen gibt.

Update-Vorgehensweise

Im folgenden Kapitel wird das Update einer CURSOR-CRM-Installation beschrieben. Hierbei müssen die folgenden drei Komponenten aktualisiert werden:

1. Datenbank

2. Applikationsserver

3. Windows Client

Automatisierter Updatevorgang

Voraussetzungen:

• Das Update muss auf dem Applikationsserver ausgeführt werden.

• Auf dem Applikationsserver muss auch der Rich Client installiert sein.

• Der Applikationsserver ist als Dienst gestartet und der aktuelle Benutzer der Maschine hat die Berechtigung, den Dienst zu beenden/starten, Dienste zu löschen und Dienste zu installieren

• Der Benutzer muss auch Powershell-Skripte ausführen dürfen, da diese genutzt werden, um die Datenbankverbindung im JBoss bekannt zu machen.
  (Lesen der aktuellen ExecutionPolicy: Get-ExecutionPolicy
  Setzen der ExecutionPolicy: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted

  Die ExecutionPolicy kann vom Administrator per Richtlinie auch fest auf einen Wert gesetzt werden, so dass nur er diese ändern kann.

Im Folgenden wird der Updatevorgang unter diesen Voraussetzungen beschrieben.

Bei einem Update müssen sowohl der Applikations-Server als auch der Rich Client aktualisiert werden. Der Web Client ist im Applikationsserver enthalten. Zunächst müssen sich alle Anwender vom System abmelden.

1. Erstellen Sie innerhalb des Installationsverzeichnisses der Anwendung ein Unterverzeichnis namens "update", z.B. D:\CURSOR\EVI\update

2. Entpacken Sie das Installationspaket in dieses Verzeichnis.

3. Die folgende Datei ausführen: "update.bat". Es ist auch möglich, das Installationsverzeichnis als Parameter zu übergeben, z.B. update.bat "D:\CURSOR\EVI\update"
   Unter Linux starten Sie das Update mit ./update.sh

D:\InstallDir\update>.\update.bat

Wenn Sie die Datei update.bat ausgeführt haben, erscheint (nach Auswahl der Installationssprache) ein Willkommensbildschirm:

Die Installation Klicken Sie auf "Weiter". Sie werden folgenden Dialog sehen:

Wechseln Sie zum folgenden Dialog. Sie werden aufgefordert, die Verzeichnisse ...server/JBoss und ...client/JBoss auszuwählen - im Standard wird dies automatisch erkannt, wenn Sie den Update-Ordner in ihr JBoss-Verzeichnis gelegt haben.

Im nächsten Schritt müssen Sie die Daten eines administrativen Kontos angeben, mit dem das Update durchgeführt werden wird, sowie das Sicherungsverzeichnis auswählen.

Wenn Sie jetzt auf Weiter klicken, wird automatisch mit dem nächsten Schritt fortgefahren (zunächst Datenbank-Backup) und danach der Server- bzw. Client-Backup-Vorgang entsprechend Ihrer Angaben ausgeführt.

Nun erfolgt die SSL Konfiguration (SSL-Kommunikationsstrecken & Zertifikate ):

Nach dem Klick auf Starte SSLUpdateTool erscheint folgender Dialog:

Danach kann der Installationsassistent mit weiter fortgeführt werden:

SSL Konfiguration (Sicherheitszertifikate)

• Ab Version 16.1 erfolgt die Konfiguration mit dem Updater und der integrierten Anwendung "CURSOR Key- und Trustore Tool":

Weiterführende Informationen zur Thematik Sicherheitszertifikate finden Sie im Installationshandbuch unter dem Abschnitt Installation des Applikationsservers im Kapitel SSL-Installation und -Konfiguration (Das Installationshandbuch erhalten Sie auf Anfrage).

Danach erfolgt eine Zusammenfassung des Updates.

Sie müssen nun abwarten, bis der gesamte Updatevorgang automatisch zu Ende geführt wird.

Wenn Sie in den nächsten Schritt wechseln, werden Sie noch einmal aufgefordert, die Konfiguration entsprechend vorzubereiten, wie es hier zuvor beschrieben wurde. Prüfen Sie dies noch einmal und fahren Sie dann fort. Der Vorgang wird einige Zeit in Anspruch nehmen. Anschließend erhalten Sie einen ähnlichen Bestätigungsbildschirm wie folgt:

Mit einem Klick auf Beenden kann der Installationsassistent nun geschlossen werden.

Masterclient aktualisieren

Um nicht bei jedem Update oder Patch den Client neu verteilen zu müssen, bietet CURSOR-CRM die Möglichkeit, einen Master-Client zu verwenden. Das Installationsverzeichnis des Master-Clients entnehmen Sie der Installationsübersicht (Feld Auto-Update-Verzeichnis). Änderungen müssen somit nur an diesem einen Client durchgeführt werden. Bei der Anmeldung an CURSOR-CRM wird zunächst geprüft, ob Änderungen vorliegen. Sind Änderungen vorhanden, wird das Update des Clients voll automatisch durchgeführt. Somit ist mit minimalem Aufwand sichergestellt, dass alle Benutzer von CURSOR-CRM mit dem aktuellsten Client arbeiten.

Die zuvor konfigurierte Datei ..\client\jboss\custom\configuration.bat aus der neuen Version muss ebenfalls in den Master-Client übernommen werden. In der Datei ...\Client\jboss\custom\update.properties werden die Einstellungen zum automatischen Aktualisieren der einzelnen Verzeichnisse vorgenommen.

In dem Verzeichnis custom öffnen Sie die Datei update.properties mit einem Texteditor. Ändern Sie die folgenden Schlüssel auf das aktuelle Tagesdatum und die aktuelle Uhrzeit.

LAST-UPDATE=26.10.25 14\:00

BIN-DIR=26.10.25 14\:00
CONF-DIR=26.10.25 14\:00
EXT-DIR=26.10.25 14\:00
LIB-DIR=26.10.25 14\:00
CUSTOM-DIR=26.10.25 14\:00
UPDATE-TOOL-DIR=26.10.25 14\:00
JRE-DIR=26.10.25 14\:00

Der Eintrag LAST-UPDATE gibt die letzte Änderung an dem Master-Client an. Für jedes Verzeichnis gibt es einen Eintrag in der Datei update.properties (EXT-DIR, BIN-DIR, CONF-DIR, LIB-DIR, CUST-EXT-DIR usw.). Zum Aktualisieren muss das Datum und die Uhrzeit für jedes Verzeichnis und bei dem Eintrag LAST-UPDATE aktualisiert werden.

Aktivierung des automatischen Client-Updatetools

Der Master-Client muss in der Datei Client\jboss\custom\configuration.bat aktiviert sein. Hierzu gibt es in der Datei-Zeile 64 den Eintrag SET USE_UPDATE_TOOL=true. Dieser muss zum Aktivieren auf 'true' gesetzt sein.

Starten des Client-Updatetools

Beim Starten eines noch nicht aktualisierten Clients wird die folgende Fortschrittsanzeige angezeigt, die das Kopieren diverser Dateien visualisiert.

Datenbank-Statistiken aktualisieren

• Bei ORACLE-Datenbanken: Ausführen der Datei db\scripts\analyzeTables.bat (bei Linux db\scripts\linux\analyzeTables.sh). Hierdurch wird auch die SQL-Datei RenewIndexes.sql, die bei einigen Kunden erweitert wurde, ausgeführt.

• Bei MS-SQL eine Datenbankoptimierung durchführen.

Weitere Hinweise

Turnus zum Neustart des Applikationsservers

Tipp

Es wird empfohlen, den Applikationsserver in einem monatlichen Turnus neu zu starten. Häufigere Neustarts würden dazu führen, dass aus Performance-Sicht wertvolle Cache-Informationen temporär verloren gehen und damit neu aufzubauen wären.

Falls das Zusatzmodul CTI Schnittstelle im Einsatz ist, sollte der zusätzliche Dienst des CTI-Applikationsservers mindestens 1 Mal wöchentlich oder noch besser nächtlich neu gestartet werden, damit die CTI-Schnittstellen neu initialisiert werden können.

Dokumentenbearbeitung und externe Aufrufe im Web Client

Zur Nutzung der erweiterten Dateibehandlung und der externen Aufrufe im Web Client ist die Nutzung der "CURSOR Browser-Erweiterung" und des zugehörigen "Communication Host für die CURSOR Browser-Erweiterung" zwingend erforderlich.

Besonderheiten beim Einsatz eines CTI Servers.

Wenn die CTI-Schnittstelle im Einsatz ist, muss der dafür vorhandene JBoss ebenfalls aktualisiert werden.

Behobene Bugs

Informationen finden Sie in der Patch-Dokumentation im Kundenportal.

Schriftarten

Die ausgelieferten Reports verwenden als Standardschriftart Tahoma, welche im TrueType Format auf dem Applikationsserver installiert sein muss. Läuft der Applikationsserver unter Linux, bietet es sich an, zunächst die MS TrueType CoreFonts zu installieren und anschließend noch den Tahoma Font hinzuzufügen. 

Sofern Sie eine gültige Windows-Lizenz haben, kopieren Sie die Datei tahoma.ttf aus dem Verzeichnis C:\Windows\Fonts

Bei SuSE Linux

# als Benutzer root:
# Kopieren Sie die Datei tahoma.ttf in das fonts Verzeichnis
cp tahoma.ttf /usr/share/fonts/truetype
 
# Font-Cache neu laden
fc-cache

Bei Ubuntu Linux

# MS TrueType CoreFonts installieren
sudo apt-get -y install ttf-mscorefonts-installer
 
# Schriftart Tahoma installieren
cd /tmp
wget http://download.microsoft.com/download/ie6sp1/finrel/6_sp1/w98nt42kmexp/en-us/ielpkth.cab
cabextract --lowercase ielpkth.cab
 
# Kopieren der Datei tahoma.ttf in das fonts Verzeichnis
sudo cp tahoma.ttf /usr/share/fonts/truetype/msttcorefonts
 
# Font-Cache neu laden
sudo fc-cache

Alternative Schriftart-Bibliothek

Ist eine Installation der Schriftarten auf dem Server nicht möglich, können auch im Applikationsserver alle benötigten Schriftarten als Bibliothek installiert werden. Wie auch die Datenbank-Treiber wird die Datei cursor-font.jar im Verzeichnis ./custExt abgelegt

Eine vorkonfigurierte Bibliothek mit den Windows-Schriftarten Calibri und Tahoma können Sie von der CURSOR-Website herunterladen.

Link: https://www.cursor.de/software_mgmt/install/cursor-font.jar

2024.5

Systemrelevante Informationen für Administratoren

ToDo DMA

Hinweise auf neue Funktionalitäten

Internationale Darstellung von Telefonnummern

Die Darstellung von internationalen von Telefonnummern wurde im CRM-System nach den Vorgaben der DIN 5008 umgestellt.

Bisher:
+39 (039) 657 - 81

Neu (nach DIN 5008):
+39 39 657-81

• Klammern der Vorwahl wurden entfernt

• Der Bindestrich zwischen der Telefonnummer und der Durchwahl wird jeweils ohne Leerzeichen dargestellt

Dieselben Vorgaben gelten für Mobilfunknummern.

Bisher:
+49 (170) 7654321

Neu (nach DIN 5008):
+49 170 7654321

Überarbeitung der Branding-Bar und Anzeige des Stellvertreter-Modus

Die bisherige Breite der Branding-Bar führte dazu, dass die Darstellung des Stellvertreters nicht korrekt angezeigt werden konnte. Aus diesem Grund wurden die Funktionen gruppiert und anders organisiert.

Profil im Blickpunkt

• Bild im Profil: Neben dem Namen ist auch das Profilbild sichtbar. Ist keins vorhanden, wird der Anfangsbuchstabe des Vor- und Nachnamens angezeigt.

• Stellvertretermodus: direkt im Profil ist sichtbar, ob gerade im Stellvertretermodus gearbeitet wird. Das Symbol zeigt an, wenn der Anwender in dieser Rolle agiert. So hat man ständig den Überblick darüber, welche Berechtigungen gerade gelten.

Werkzeugleiste

• Alles auf einen Blick: Die Schaltflächen sind jetzt noch übersichtlicher angeordnet

• Neue Icons: Es wurden einige Icons ausgetauscht, damit du die Funktionen noch besser zugeordnet werden können.

  • Die Benachrichtigungen werden jetzt durch eine Glocke angezeigt.

  • Weitere Funktionen wurden in einem Menü-Punkt gesammelt und sind dor aufrufbar

    

• Das Wichtigste im Blick: Mit der Überarbeitung der Branding-Bar, wurde die Benutzeroption Call-Center Modus in Mandantensystemen standardmäßig auf aktiv gesetzt.

Vorgangsmanagement

Im Vorgangsmanagement wurde der Vorgangsstatus um einen neuen Schlüssel erweitert.

PK: W-C0TICKET_STATUS
WARTEND - Wartend

Das betrifft die Bereiche "Vorgänge" und "Anliegen", hier wird jeweils der neue Schlüssel "Wartend" im Feld-Status angezeigt.

Hinweise auf veraltete Funktionalitäten

-

2024.4

Systemrelevante Informationen für Administratoren

Metadatenvalidierung bei Erreichung/Überschreitung des Max-Counts in der Datenbank

Die Anlage von neuen Feldern auf Entitäten wird begrenzt, damit die Oracle-Begrenzungen nicht überschritten werden. Vorher wird aber noch eine Warnung bei der Metadatenvalidierung beim Update nach Count-Prüfung ausgegeben.

Maximalwerte für C0-Entitäten:

• 350 C0-Felder

• 200 C1-Felder

• 200 C2-Felder

Maximalwerte für C1-Entitäten:

• 350 C1-Felder

• 200 C2-Felder

Maximalwerte für C2-Entitäten:

• 500 C2-Felder

Oracle

-- Validation.C0FieldsInC0Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	UPPER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT ut.table_name, COUNT(*) 
FROM
	user_tab_columns ut, sub_crmTabs s
WHERE
	NOT REGEXP_LIKE ( ut.Column_Name, 'C[0-9]{1,2}' ) 
	AND NOT REGEXP_LIKE ( ut.table_name, 'C[0-9]{1,2}' ) 
	AND s.table_name = ut.table_name
GROUP BY
	ut.table_name
	HAVING COUNT(*) > 350;

-- Validation.C1FieldsInC0Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	UPPER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT ut.table_name, COUNT(*) 
FROM
	user_tab_columns ut, sub_crmTabs s
WHERE
	REGEXP_LIKE ( ut.Column_Name, 'C[0-9]{2}' ) 
	AND NOT REGEXP_LIKE ( ut.table_name, 'C[0-9]{1,2}' ) 
	AND s.table_name = ut.table_name
GROUP BY
	ut.table_name
	HAVING COUNT(*) > 200;

-- Validation.C2FieldsInC0Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	UPPER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT ut.table_name, COUNT(*) 
FROM
	user_tab_columns ut, sub_crmTabs s
WHERE
	ut.Column_Name LIKE 'C2%' 
	AND NOT REGEXP_LIKE ( ut.table_name, 'C[0-9]{1,2}' ) 
	AND s.table_name = ut.table_name
GROUP BY
	ut.table_name
	HAVING COUNT(*) > 200;

-- Validation.C1FieldsInC1Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	UPPER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT ut.table_name, COUNT(*) 
FROM
	user_tab_columns ut, sub_crmTabs s
WHERE
	ut.Column_Name NOT LIKE 'C2%' 
	AND REGEXP_LIKE ( ut.table_name, 'C[0-9]{2}' ) 
	AND s.table_name = ut.table_name
GROUP BY
	ut.table_name
	HAVING COUNT(*) > 350;

-- Validation.C2FieldsInC1Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	UPPER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT ut.table_name, COUNT(*) 
FROM
	user_tab_columns ut, sub_crmTabs s
WHERE
	ut.Column_Name LIKE 'C2%' 
	AND REGEXP_LIKE ( ut.table_name, 'C[0-9]{2}' ) 
	AND s.table_name = ut.table_name
GROUP BY
	ut.table_name
	HAVING COUNT(*) > 200;

-- Validation.C2FieldsInC2Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	UPPER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT ut.table_name, COUNT(*) 
FROM
	user_tab_columns ut, sub_crmTabs s
WHERE
	ut.table_name LIKE 'C2%' 
	AND s.table_name = ut.table_name
GROUP BY
	ut.table_name
	HAVING COUNT(*) > 500;

MSSQL

-- Validation.C0FieldsInC0Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	LOWER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT so.name, COUNT(*) 
FROM
	sysobjects so, syscolumns sc, sub_crmTabs s
WHERE
	NOT ( sc.name  LIKE 'C[0-9][0-9]%' OR sc.name LIKE 'C2%' ) 
	AND NOT ( so.name LIKE 'C[0-9][0-9]%' OR so.name LIKE 'C2%' ) 
	AND s.table_name = so.name
	AND so.uid = 1 
	AND so.xtype = 'U' 
	AND so.id = sc.id
GROUP BY
	so.name
	HAVING COUNT(*) > 350

-- Validation.C1FieldsInC0Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	LOWER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT so.name, COUNT(*) 
FROM
	sysobjects so, syscolumns sc, sub_crmTabs s
WHERE
	sc.name  LIKE 'C[0-9][0-9]%' 
	AND NOT ( so.name LIKE 'C[0-9][0-9]%' OR so.name LIKE 'C2%' ) 
	AND s.table_name = so.name
	AND so.uid = 1 
	AND so.xtype = 'U' 
	AND so.id = sc.id
GROUP BY
	so.name
	HAVING COUNT(*) > 200

-- Validation.C2FieldsInC0Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	LOWER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT so.name, COUNT(*) 
FROM
	sysobjects so, syscolumns sc, sub_crmTabs s
WHERE
	sc.name LIKE 'C2%' 
	AND NOT ( so.name LIKE 'C[0-9][0-9]%' OR so.name LIKE 'C2%' ) 
	AND s.table_name = so.name
	AND so.uid = 1 
	AND so.xtype = 'U' 
	AND so.id = sc.id
GROUP BY
	so.name
	HAVING COUNT(*) > 200

-- Validation.C1FieldsInC1Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	LOWER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT so.name, COUNT(*) 
FROM
	sysobjects so, syscolumns sc, sub_crmTabs s
WHERE
	sc.name NOT LIKE 'C2%' 
	AND so.name LIKE 'C[0-9][0-9]%' 
	AND s.table_name = so.name
	AND so.uid = 1 
	AND so.xtype = 'U' 
	AND so.id = sc.id
GROUP BY
	so.name
	HAVING COUNT(*) > 350

-- Validation.C2FieldsInC1Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	LOWER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT so.name, COUNT(*) 
FROM
	sysobjects so, syscolumns sc, sub_crmTabs s
WHERE
	sc.name LIKE 'C2%' 
	AND so.name LIKE 'C[0-9][0-9]%' 
	AND s.table_name = so.name
	AND so.uid = 1 
	AND so.xtype = 'U' 
	AND so.id = sc.id
GROUP BY
	so.name
	HAVING COUNT(*) > 200

-- Validation.C2FieldsInC2Entities
WITH sub_crmTabs AS ( 
SELECT DISTINCT
	LOWER( RowPk) AS table_name
FROM
	emdVarchar
WHERE
	FieldName = 'ShortCut' ) 
	
SELECT so.name, COUNT(*) 
FROM
	sysobjects so, syscolumns sc, sub_crmTabs s
WHERE
	so.name LIKE 'C2%' 
	AND s.table_name = so.name
	AND so.uid = 1 
	AND so.xtype = 'U' 
	AND so.id = sc.id
GROUP BY
	so.name
	HAVING COUNT(*) > 500

Infoboard "Key Performance Indicator (KPI)": Refaktorisierung in Kachelbau 2.0

Alte KPI-Kacheln werden automatisch zu neuen KPI-Kacheln V.2 migriert. In seltenen Fällen müssen optische Anpassungen vorgenommen werden (bspw. die Kacheln größer/kleiner ziehen), daher empfehlen wir nach dem Update, vorher vorhandene KPI-Kacheln manuell zu überprüfen.

Details finden Sie im Kapitel → Infokachel - KPI.

Hinweise auf veraltete Funktionalitäten

Umbenennung der Feldeigenschaft "Nur lesen" anstelle von "Schreibgeschützt"

Die Feldeigenschaft "Schreibgeschützt" wurde bei administrativen Aufgaben in "Nur lesen" umbenannt, da die Benennung klarer Wirkungsweise der Feldeigenschaft beschreibt.

In den CURSOR-Dokumentationen wird jetzt die Feldeigenschaft einheitlich “Nur lesen” genannt.

2024.3

Systemrelevante Informationen für Administratoren

HTTP/2

Beginnend mit CRM-Version 24.3 wird HTTP/2 für einen reibungslosen Betrieb vorausgesetzt und ist im CRM-Applikationsserver standardmäßig aktiviert. Ohne HTTP/2 treten in bestimmten Situationen deutlich verzögerte Reaktionszeiten im Web Client auf. Der Web Client reagiert für eine gewisse Zeit gar nicht mehr auf Eingaben oder Klicks.

Wichtige Hinweise beim Betrieb des CRMs hinter einem Reverse-Proxy/Web-Application-Firewall (WAF)

Mit CRM-seitig aktiviertem HTTP/2 wird nur noch ein Reverse-Proxy oder eine Web-Application-Firewall (WAF) unterstützt, die TLS-Sessions terminiert (Layer 7) und HTTP/2 unterstützt. Damit ist weiterhin der Einsatz von "Single IP" (für den Reverse-Proxy / Web-Application-Firewall) und Wildcard oder Multi-Domain (SAN) Zertifikaten möglich.

Der Hintergrund wurde hier beschrieben: https://help.cursor.de/de/hub/current/ssl-kommunikationsstrecken-zertifikate#id-(de)SSL-Kommunikationsstrecken&Zertifikate-EinsatzvonReverse-Proxy/Loadbalancer/WAF(WebApplicationFirewall)

Single Sign-On mit SAML 2.0: Änderung der Url

Bisher:

• EntityID bzw. Relying Party Identifier: /webclient also zum Beispiel: https://crm.example.com:18443/webclient

• Assertion Consumer Endpoint URL, POST-Back URL oder Callback-URL: /webclient/samlLogin, also zum Beispiel: https://crm.example.com:18443/webclient/samlLogin

Neu:

• EntityID bzw. Relying Party Identifier: /login/ also zum Beispiel: https://crm.example.com:18443/login

• Assertion Consumer Endpoint URL, POST-Back URL oder Callback-URL: /login/saml/callback, also zum Beispiel: https://crm.example.com:18443/login/saml/callback

Feldlänge von Feldern mit URL-Inhalt wurde erhöht

Es konnte vorkommen, dass die Feldlänge zu kurz war und es kam zu Fehlern.

Bei den betroffenen Feldern soll die Eingabemaske geprüft werden, ob die Eingabemaske eine Übersteuerung in C2 hat (Feldeigenschaften). Diese müsste dann auf .{0,1000} angepasst werden.

Folgende Felder wurden auf 1000 Zeichen erhöht:

• DocuLink.Request --> von 255 -> 1000

• CallUrl.SocialMedia --> von 255 -> 1000

• MSTeamsLink.Activity --> ist bereits 1000 Zeichen

• Url.CampContent --> von 255 -> 1000

• Website.ContactPerson --> von 255 -> 1000, Einschränkung auf 60 Zeichen in der Maske in C0 entfernt, kann noch in C2 vorhanden sein

• Website.Customer --> von 255 -> 1000

• Website.Employee --> von 255 -> 1000

• Website.Person --> von 255 -> 1000, Einschränkung auf 60 Zeichen in der Maske in C0 entfernt, kann noch in C2 vorhanden sein

• Website.Telecom --> von 255 -> 1000

• WebsitePrivate.ContactPerson --> von 255 -> 1000

• WebsitePrivate.Employee --> von 255 -> 1000

weitere Url-Felder in der Anwendung:

• ExternalLink1.Ticket --> waren bereits 1000 Zeichen

• ExternalLink2.Ticket --> waren bereits 1000 Zeichen

Aktionsrechte

“Suchen administrieren”

Benutzer mit der Berechtigung “Fachadmin” durften Suchen als System-Schnellsuchen nicht markieren.

Das ist jetzt möglich.

"Erstelle Consent" und "Lösche Consent"

Aktionsrechte "Erstelle Consent" und "Lösche Consent" haben das Recht AdminOnlyManage bekommen.

Im Zuge des neuen Consent-Management-Moduls ist die Neuanlage und das Löschen von Consent-Datensätzen (ehem. OptIn) im Standard deaktiviert worden. Um Kunden-Systemadministratoren zu ermöglichen, die Rechte im Bedarfsfall zu aktivieren, wurden die beiden Aktionsrechte "Erstelle Consent" (create.element.permission.OptIn) und "Lösche Consent" (remove.element.permission.OptIn) mit dem Recht "AdminOnlyManage" ausgestattet.

Tabmanagement: Änderung der Reihenfolge von offenen Tabs

Offene Tabs können in einer gewünschten Reihenfolge per Drag and Drop platziert werden, um so in einem intuitiv vertrauten System zu arbeiten.

Der Tab "Mein Cockpit" bleibt dagegen immer an erster Stelle und ist nicht verschiebbar.

Die Funktionalität, einen Datensatz per Drag and Drop in myCRM zu ziehen entfällt

Nach dem Verschieben rücken die bisherigen geöffneten Tabs zusammen. Sind so viele Tabs geöffnet, dass zwei Zeilen entstehen, verhält sich dies so, wie wenn es einzeilig wäre. War in der zweiten Zeile nur ein weiterer Tab geöffnet und man möchte diesen verschieben, werden die Zeilen je nach Position einspaltig oder zweispaltig. Zieht man einen Tab an eine Position, an der ein Umbruch zur zweiten Zeile erfolgen würde, so wird entsprechend auch eine zweite Zeile angezeigt

Aufnahme der IBAN und BIC in die Standardsuche für den Unterbereich Bankverbindungen

Bisher wurde in dem Unterbereich bei der Bankverbindung bei eingetragener IBAN und BIC keine Bankleizahl und Kontonummer generiert.
Die Felder ‘Bankleizahl’ und ‘Kontonummer’ werden aus dem Unterbereich entfernt, da sie auf der Maske nicht mehr vorhanden sind. Es wurde keine Suche angepasst, da es sich bei der Suche um die "Generierte Standardsuche" handelt.

Änderungen der Feldeigenschaften:

• Kontonummer (AccountNumber.BankData)
  Feldeigenschaften: Suchfeld, Suchergebnisfeld und IdFeld wurden entfernt
  Sortierung wurde deaktiviert

• Bankleitzahl (BankCode.BankData)
  Feldeigenschaften: Suchfeld und Suchergebnisfeld wurden entfernt

• IBAN IBAN.BankData
  Feldeigenschaften: Suchfeld, Suchergebnisfeld und IdFeld wurden gesetzt
  Sortierung wurde aktiviert

• BIC BIC.BankData
  Feldeigenschaften: Suchfeld und Suchergebnisfeld wurden gesetzt

Beziehungstyp auswählen

Wenn man bisher z.B. bei einer Anfrage über den Unterbereich einen Geschäftspartner verknüpfte, erschien hier der Dialog, um einen Beziehungstyp zu setzen.

Der Dialog wird nun nicht im Zuordnungsbrowser angeboten, wenn es zwar ein Beziehungstyp ‘Schlüsselfeld’ gibt, es dort aber keine aktiven, sichtbaren bzw. selektierbaren Schlüssel gibt.

Dies betrifft jegliche Beziehung bei der Zuordnung auf allen relevanten Entitäten (z.B. Ansprechpartner und Mitarbeiter unterhalb der Aktivität).

Die Funktionalität, hier „Ist Hauptgeschäftspartner“ auszuwählen, ist entfallen, das kann man auch im Anschluss noch über den Unterbereich setzen (Beziehungstyp bearbeiten).

Wenn man den Beziehungstyp über den Unterbereich bearbeitet, wird das entsprechende Feld der Schlüssel deaktiviert bzw. ausgegraut dargestellt, wie es auch bei boolean-Attributen der Fall ist.

Tipp

Details zur Bedienung finden Sie im Kapitel Beziehungen des Anwender-Handbuchs.

Darstellung von Schlüsseln und Beschreibung in Tooltips

Bisher wurde in dem Tooltip beim Hovern lediglich die Schlüsselbeschreibung angezeigt.

Der Tooltip setzt sich nun wie folgt zusammen: ‘Schlüsselwert - Schlüsselbeschreibung’

Diese Darstellung ist als System-Standard ausgewählt.

Feld "Funktionsbeschreibung" auf Mitarbeiter-Maske

Für die Maske des Mitarbeiters (Employee) wurde ein neues Feld hinzugefügt: Funktionsbeschreibung ("Function.Employee").

Das Verhalten des Feldes:

• Wird in dem Feld "Funktion" ("FunctionKey.Employee") ein Wert ausgewählt, wird dieser initial ebenfalls in das neue Feld Funktionsbeschreibung ("FunctionDesc.Employee") geschrieben.

• Der Wert des neuen Feldes kann angepasst werden (Freitext). Hierbei hat das Ändern keine Auswirkungen auf ein anderes Feld.

Bei DepartmentKey.Employee und Department.Employee wurde es auch dementsprechend angeglichen.

Suchen-Kachel: Sortierreihenfolge wird durch die Einstellungen definiert

Die angezeigten Aktivitäten waren bisher nach dem Anlagedatum (CreateDate.Activity) sortiert.

Sortierung nach "Beginn am" (StartDate.Activity) ist für manche Kunden relevant, für manche aber auch C2-Felder innerhalb der Aktivitäten.

Deswegen wird eine neue Konfigurationseinstellung mit aufgenommen, welche für die Sortierung der Aktivitäten als Grundlage verwendet. Es findet keine Differenzierung zwischen den verschiedenen Aktivitätstypen statt, d.h. das vorgegebene Datumsfeld greift global für die Sortierung alle Aktivitäten. Der aktuelle Standard (CreateDate.Activity) wird als Standardwert der neuen Einstellung mitgegeben.

Eine weitere Konfigurationseinstellung wird mit aufgenommen, welche für die Datums-Anzeige der Aktivitäten maßgeblich ist. Der aktuelle Standard (CreateDate.Activity) wird als Standardwert der neuen Einstellung mitgegeben.

Hinweise auf veraltete Funktionalitäten

Prüfung der Datenbank-Version

Ab Version 2024.3 wird beim Update geprüft, ob mindestens eine Oracle 19c Datenbank genutzt wird.

Der JBoss Server startet nicht mehr, wenn eine ältere Version genutzt wird.

2024.2

Systemrelevante Informationen für Administratoren

Aufnahme der Mitarbeiterkategorie zur Abbildung von Benutzern ohne Client-Anmeldung

Bisher wurde das Flag "Ist technischer Benutzer" auf dem Mitarbeiter dafür verwendet, um diesen Benutzern einen Login zu verwehren. Häufig handelte es sich dabei allerdings nicht um technische Benutzer, sondern Ressourcen. Da diese fälschlicherweise dann auch in BPM-Prozessen als ausführender Benutzer ausgewählt werden konnten, wurde eine sinnvolle Trennung der technischen Benutzer von den Ressourcen vorgenommen.

Um allerdings nicht für jeden Mitarbeitertyp eigene Felder aufzunehmen und eine Erweiterbarkeit sicherzustellen, wurde im Standard ein neues Schlüsselfeld aufgenommen:

• Feld: Mitarbeiterkategorie
  Feldname: CategoryKey.Employee
  Feldtyp: Schlüsselfeld
  Keyrange: C0CategoryKey (DE: Mitarbeiterkategorie; EN: Employee Type
  Key 1: C0UserCat (DE: Benutzer, EN: User)
  Key 2: C0ResourceCat (DE: Ressource, EN: Resource)
  Standardwert (Vorbelegung): C0UserCat

Das Feld TechnicalUser.Employee wurde wie folgt migriert:

• Ist technischer Benutzer = true, dann C0ResourceCat

• Ist technischer Benutzer = false, dann C0UserCat

Für die "Mitarbeiter", die als Ressource angelegt waren, ist nun keine Anmeldung am Client (Web/App) mehr möglich (analog zum bisherigen Flag "technischer Benutzer").

Für die "Mitarbeiter", die NICHT als Ressource angelegt waren, ist die Anmeldung am Client möglich. Dies gilt auch für Mitarbeiterkategorien, die zukünftig in der Kunden-Schicht C2 angelegt werden.

Bestandskunden wird empfohlen, die technischen Benutzer zu überprüfen und zu aktualisieren. Mitarbeiterdatensätze, die lediglich als Ressource genutzt werden sollen (wie bspw. Räume), können als technischer Benutzer = false gesetzt werden. So werden die Listen technischer User bspw. in BPM für die Ausführung von Prozessen übersichtlicher.

Wurde bei Bestandskunden die Suche für den Mitarbeiterabgleich (C0EMPLOYEES_TO_MERGE) übersteuert, sollte das neue Feld in der Suche aufgenommen werden, damit auch diese Information im Rahmen des Abgleichs übertragen wird.

Außerdem wurde das Feld Mitarbeiterkategorie in die Standardmaske aufgenommen. Übersteuerte Mitarbeitermasken sollten um diese Information ergänzt werden. Der Standardwert für neu angelegte Mitarbeiter ist immer "Benutzer".

Überführen von Skriptlogik nach BPM mit Skriptbibliotheksfunktionen im Bereich der Aktivitäten

Die geänderte Serverlogik überschreibt eventuelle Logiken, die ein Kunde im C2-Maskenskript eingestellt hat. Wenn der Kunde individuelle Logiken im Maskenskript definiert hatte, muss er die neue zentrale Logik in der Skriptbibliothek übersteuern und seine Logik dort hinterlegen. Der Ort hat sich geändert und der neue Ort überschreibt den alten Ort.

Vor dem Speichern einer Aktivität werden das Datum "Ende" und evtl. "Erinnerungsdatum" berechnet. Die Daten werden nur berechnet, wenn sie beim Speichern nicht vorher verändert wurden oder leer sind. Anpassungen der Datumslogik erfolgen im Maskenskript der Aktivität oder in SC0EntityLogic.beforeSave().

Allgemein können in SC0EntityLogic.beforeSave() bzw. SC0EntityLogic.doStartBeforeSave() Logiken für weitere Bereiche hinterlegt werden.

Hinweise auf neue Funktionalitäten

Tabmanagement: Öffnen von Datensätzen in neuer Ebene im Hintergrund

Wenn man einen Eintrag über das Kontextmenü “in einer neuen Ebene öffnen” anklickt, öffnet sich eine neue Ebene, der Fokus bleibt aber in der Listenansicht bestehen.

Umbenennung OptIn in Consent

Die Entität OptIn wurde damals für das alte Optin-Modul angelegt. Mit der Zeit stellte sich immer mehr heraus, dass die Bezeichnung "OptIn" für die Entität unpassend ist, da man für fachliche OptOuts im CRM Optins mit dem Status Ablehnung anlegen musste. Das hat zu Mißverständnissen geführt.

Daher wurde die Entität “OptIn” in "Consent" umbenannt, sodass in der Oberfläche dieser Begriff zu sehen ist (z.B. Unterbereich).

In Konsequenz wurden die beiden Schlüsselbereiche "OptIn-Herkunft" und "OptIn-Status" in "Consent-Herkunft" und "Consent-Status" umbenannt, damit auch dort die zugehörigen Schlüssel gefunden werden können.

Analog dazu wurde der Name des Opt-In-Moduls auf “Consent Management” angepasst. Die ID blieb naturgemäß unverändert.

Weitere Anpassungen wurden nicht vorgenommen.

Einschränkung der Rechte zum Anlegen und Löschen von Consent-Datensätzen

Da es aus Datenschutzgründen nicht zu empfehlen ist, OptIns manuell im CRM-System anzulegen oder zu löschen, ist im Zuge des neuen Consent-Management-Moduls die Neuanlage und das Löschen von Consent-Datensätzen (ehem. OptIn) im Standard deaktiviert worden. Da es sich bei der Consent-Entität um eine Standard-Entität handelt, hat diese Anpassung auch Auswirkungen auf Systeme, die das Consent Management-Modul zwar nicht lizensiert haben, aber die Entität zur Verwaltung von OptIns und OptOuts nutzen.

Um Kunden-Systemadministratoren zu ermöglichen, die Rechte im Bedarfsfall zu aktivieren, wurden die beiden Aktionsrechte "Erstelle Consent" (create.element.permission.OptIn) und "Lösche Consent" (remove.element.permission.OptIn) mit dem Recht "AdminOnlyManage" ausgestattet. Insofern ist es möglich, dass kundenindividuell definiert wird, ob und wer Consent-Datensätze anlegen und löschen darf.

Die Neuanlage oder das Löschen von Consent-Datensätzen über Schnittstellen sind hiervon nicht betroffen.

Hinweise auf veraltete Funktionalitäten

-

2024.1

Systemrelevante Informationen für Administratoren

MS SQL-Server Datenbank

Ab CURSOR-CRM Release 24.1 werden im Falle einer MS SQL-Server Datenbank nur noch die Versionen 2022 und 2019 unterstützt.

Das Tool “CURSOR DDAddin” welches für den Firefox vor Version 115 notwendig war, wird für das Drag&Drop von E-Mails aus Outlook auf den Webclient im Firefox ab Version 115 des Firefox nicht mehr benötigt. Die Browser Chrome und Edge haben dieses Tool noch nie benötigt.

Aktualisierung der MSSQL Reindizierungs-Skripte

Die bislang ausgelieferten MS SQL Skripte nutzen die Funktion "DBCC DBREINDEX", um die Indizes und Statistiken für alle Tabellen neu zu erstellen. Diese Funktion ist veraltet und wird in zukünftigen MS SQL Server Versionen entfernt. Hier muss der Befehl "ALTER INDEX ALL ON @tablename REBUILD" genutzt werden.

Im Installationspaket ist das aktuelle Reindizierungs-Skript enthalten und sollte bei Nutzung getauscht werden. Sind MS SQL Server Wartungspläne im Einsatz, sind keine Maßnahmen erforderlich.

Deaktivieren der Neuanlage von V1-Kacheln

Die Neuanlage neuer V1-Kacheln ist mit der Version 24.1 nicht mehr möglich. Es können nur noch V2-Kacheln erstellt werden. Die Bearbeitung bestehender V1-Kacheln ist weiterhin möglich:

• Freigabe des Kacheleditors V2 mit 23.3

• Ende des Windows Clients nach 25.1

• Entfernung der V1-Kacheln mit 26.1

Darstellung von Angebotspositionen im Unterbereich

Im Unterbereich der Angebote wurden in den Angebotspositionen aktuell die Positionswerte nur in der Fremdwährung angezeigt. Zusätzlich zur Fremdwährung werden jetzt im Standard die Angebotspositionswerte in Hauswährung angezeigt.

Austausch des Hilfe-Links

Mit der Abschaffung der PDF-Dokumentation der Handbücher mit 23.3 verweist nun auch der Link in der CRM-Toolbar (rechts oben) auf die neue Online-Hilfe verweisen:

• Klick auf den Menüpunkt führt auf http://help.cursor.de

• Taste F1 führt auf http://help.cursor.de

Angebotspositionen werden mit der Genauigkeit der in den Feldern hinterlegten Editiergenauigkeit berechnet

Die Berechnug der Angebotspositionen wird wie folgt angepasst:

• Die interne Berechnung erfolgt mit BigDecimal-Werten mit einer Genauigkeit von 11.

• Das Schreiben von Werten erfolgt mit der Genauigkeit, die in den Metadaten in der Nachkommastellen (Editieren) hinterlegt wurde.

Im Standard sind diese Werte für die folgenden relevanten Felder so konfiguriert:

• Rabatt (Discount.QuoteItem) 4 Stellen

• Einzelpreis (Unitprice.QuoteItem) 2 Stellen

• Einzelpreis (FW) (UnitpriceFC.QuoteItem) 2 Stellen

• Gesamtpreis (Totalprice.QuoteItem) 2 Stellen

• Gesamtpreis (FW) (TotalpricFC.QuoteItem) 2 Stellen

• Brutto (Gross.QuoteItem) 2 Stellen

Für die Vertragspositionen gilt die Logik analog. Aus diesem Grund wird auch die Editiergenauigkeit im Standard und den Rabattfeldern auf 4 gestellt.

Dieses Vorgehen soll Rundungsfehler in der bisherigen Logik verhindern.

Erweiterung der Logik des Personen-Rollen-Modells um die vor- und nachgestellten Titel

Anpassung und Erweiterung der Namenstitelfelder

Mit dem Release 2024.1 wurden Änderungen an dem Datenmodell in Bezug auf die Titel einer natürlichen Person (z.B. nachgestellte Namenstitel) vorgenommen. Dabei wurden neue Felder aufgenommen, welche z.T. vorher bestehende (nicht-delegierte Felder) ersetzt haben, um eine einheitliche Verhaltensweise und -logik der Titelfelder zu schaffen.

Die Zusammenhänge der Titelfelder auf den Entitäten Person, Geschäftspartner, Ansprechpartner und Mitarbeiter sind in der folgenden Tabelle aufgeführt, die geänderten Felder sind eingefärbt:

Besondere Änderungen hat das Feld "Suffix.ContactPerson" erhalten. Das vorher nicht-delegierte Feld wurde durch ein neues delegiertes Feld ersetzt, damit der Namenssuffix zwischen Ansprechpartnerrollen zukünftig synchronisiert wird. 

Aus diesem Grund wurde eine Migration geschaffen, welche die Werte aus bestehenden Rollen übernimmt, wenn es sich um Personen vom Typ Frau (Schlüssel-PK: 'PersonType-F'), Mann (Schlüssel-PK: 'PersonType-M') oder Divers (Schlüssel-PK: 'PersonType-D') handelt. Die Migration erfolgt nach folgender Logik:

• Zuerst Übernahme des Wertes aus dem Ansprechpartner

  • wenn zu einer Person nur ein Ansprechpartner existiert, wird dieser Wert übernommen

  • wenn zu einer Person mehrere Ansprechpartner existieren, wird der Wert des aktuellsten Ansprechpartners übernommen (nach dem Datum der letzten Änderung)

• Wenn kein Wert in dem/in den Ansprechpartner(n) hinterlegt ist, wird geprüft, ob ein Wert im Mitarbeiter vorhanden ist und dieser übernommen

Es erfolgt keine Migration von Werten bei inaktiven Datensätzen.

Es wird empfohlen, die betroffenen Ansprechpartner mit einem Konflikt vor dem Update zu identifizieren und den Namenssuffix zu korrigieren. Mithilfe der folgenden Datenbank-Statements können alle Daten selektiert werden, die einen Suffix enthalten und damit auf Konflikte geprüft werden sollten:

MS SQL

SELECT 'ContactPerson' as source, c.pk as sourcePk, c.suffix, p.pk AS personPk
FROM person p, contactPerson c
WHERE c.personPk = p.pk
   AND p.active = 1
   AND c.active = 1
   AND p.PersonTypeKey IN ('PersonType-F', 'PersonType-M', 'PersonType-D')
   AND c.suffix is NOT null
   AND c.suffix != ''
union all
SELECT 'Employee' as source, e.pk as sourcePk, e.suffix, p.pk AS personPk
FROM person p, employee e
WHERE e.personPk = p.pk
   AND p.active = 1
   AND e.active = 1
   AND p.PersonTypeKey IN ('PersonType-F', 'PersonType-M', 'PersonType-D')
   AND e.suffix is NOT null
   AND e.suffix != ''
order by personpk

ORACLE

SELECT 'ContactPerson' as source, c.pk as sourcePk, c.suffix, p.pk AS personPk
FROM person p, contactPerson c
WHERE c.personPk = p.pk
   AND p.active = 1
   AND c.active = 1
   AND p.PersonTypeKey IN ('PersonType-F', 'PersonType-M', 'PersonType-D')
   AND c.suffix is NOT null
   AND c.suffix != ''
union all
SELECT 'Employee' as source, e.pk as sourcePk, e.suffix, p.pk AS personPk
FROM person p, employee e
WHERE e.personPk = p.pk
   AND p.active = 1
   AND e.active = 1
   AND p.PersonTypeKey IN ('PersonType-F', 'PersonType-M', 'PersonType-D')
   AND e.suffix is NOT null
   AND e.suffix != ''
order by personpk

Hinweise auf veraltete Funktionalitäten

-

2023.3

Systemrelevante Informationen für Administratoren

OptIn: Erweiterung der Entitätenverknüpfung
Die Relation zwischen den Entitäten ContactPerson und OptIn wurde um eine n:m-Relation erweitert. Die 1:n-Relation zwischen Ansprechpartner und OptIn besteht nach der Anpassung weiterhin, jedoch ist diese Relation über die Maskenkonfiguration nun im Standard ausgeblendet. Stattdessen ist die neue n:m-Relation eingeblendet, welche aber auch die 1:n-Relation enthält.
Kunden, welche die Entität OptIn bereits nutzen, sollten die Konfiguration nach dem Update überprüfen und gegebenenfalls anpassen, um das gewünschte Verhalten zu erreichen.

Hinweise auf neue Funktionalitäten

Verhalten von NotificationEntityManager.createOrUpdateNotification und der dazugehörigen Methode in BPM

Die neue Arbeitsweise

• Der Eskalations-Timer erzeugt für jede Stufe (Eskalation, Erinnerung und Ablauf) eine eigene Benachrichtigung

• Die bisherigen Benachrichtigungen werden nicht mehr gelöscht bzw. überschrieben

• Die Datenbanksperre tritt nun nicht mehr auf

• Die Methode überschreibt nur noch eine Benachrichtigung, wenn der Primärschlüssel gepflegt ist, nicht mehr nur anhand von den Feldern EntityName und EntityPk. Denn zu einem Ticket kann es mehrere Benachrichtigungen geben.

Zuvor hat diese Methode einen Benachrichtigungs-Datensatz vom Typ ENTITY anhand der Werte EntityName und EntityPk gesucht. Gab es dort mehrere Einträge, wurden diese bis auf einen gelöscht und der letzte verbliebene geändert. Gab es keinen passenden Eintrag, wurde ein neuer Satz angelegt.

Diese Löschung wurde nun entfernt. Diese Verhaltensänderung existiert zwar theoretisch, praktisch führte sie aber zu dieser Endlosschleife und konnte somit nicht korrekt durchgeführt worden sein.

Das neue Update verhält sich nun wie alle anderen BPM-Methoden. Das Update findet anhand des Primärschlüssels statt. Dies hat nun Auswirkungen auf dem Eskalationstimer selbst, da hier evtl. zwei Benachrichtigungen erzeugt werden, einmal zur Erinnerung und einige Zeit (Tage, Wochen) evtl. eine für das Ablaufdatum des Tickets. Diese Verhaltensänderung betrifft alle Kunden, die die Tickets mit dem Timer schon einsetzen. Aber es ist dann evtl. nur einen Eintrag in der Taskliste mehr, den der Anwender wie gewohnt auf erledigt setzen muss.

2023.2

Systemrelevante Informationen für Administratoren

Lese- und Bearbeitungsmodus auf Masken

Durch die Einführung des Lese- und Bearbeitungsmodus sowie der Feldeigenschaft zur Darstellung von Nachschlagefeldern im Web Client und das Entfernen der Leerschlüssel aus der Anwendungsoberfläche ergeben sich unter Umständen Handlungsbedarfe für Systemadministratoren im Rahmen des Updates auf die Version 23.2, die nachfolgend themenspezifisch aufgeführt werden.

Eine fachliche Beschreibung der Änderungen befindet sich in der Release-Dokumentation. Die neue Benutzeroberfläche ist nur im Web Client verfügbar und kann nicht abgeschaltet werden (keine System- oder Benutzereinstellung vorhanden). Nach dem Update werden die Masken automatisch im neuen Lese- und Bearbeitungsmodus dargestellt.

Prüfung von Masken / Maskenskript

Für eine optimierte Benutzererfahrung im Lese- und Bearbeitungsmodus wurden Anpassung an allen C0-Standardmasken vorgenommen. Die Anpassungen beziehen sich hauptsächlich auf

• die Anpassung von Spalten, Collapsibles und Tabs für eine bessere Lesbarkeit im Lesemodus

• die Einführung einer Maximalbreite von 1500px (2-/3-spaltige Layouts) bzw. 900px (1-spaltiges Layout) für eine Anwenderfokus-Zentrierung

• die Optimierung von Abständen (z.B. auf einer Karte) für eine luftigere Darstellung von Inhalten

• eine sprechende Benennung von Tabs, Collapsibles etc. zur besseren Verwendbarkeit in Maskenskripten oder Prozessen

Die Standardmasken erscheinen mit einem Update auf die Version 2023.2 automatisch im Layout und können nicht mehr zurückgesetzt werden. Wenn die Masken im alten Layout beibehalten werden sollen, müssen diese vor dem Update durch den Administrator übersteuert werden.

Mit einem Statement kann man eine Übersicht der betreffenden Standardmasken erhalten:

Oracle und MS SQL

SELECT t1.MaskId, t1.EntityName, t1.CustLayer, t2.ConfigGroup FROM
    (SELECT MaskId, EntityName, CustLayer FROM Mask WHERE CustLayer IN ('C2', 'C1')) t1
LEFT JOIN
    (SELECT ConfigGroup, MaskId, EntityName FROM MaskConfig WHERE MaskId IS NOT null) t2
ON (t1.MaskId = t2.MaskId AND t1.EntityName = t2.EntityName)

Eine Aufstellung der größeren Änderungen pro Maske zur Prüfung von Maskenskripten, Prozessen oder Testfällen ist auf Anfrage erhältlich. Auch eine Überarbeitung von Masken in C1 (EVI/TINA) hat stattgefunden, Informationen dazu befinden sich in den entsprechenden Releasenotes.

Es wird empfohlen, nach dem Update alle Individualmasken mit dem Lese- und Bearbeitungsmodus zu testen. Notwendige Anpassungen können beinhalten:

• Anordnung von Spalten / Feldern: Spalten sollten sinnhaft genutzt bzw. Felder nebeneinander nur gezielt eingesetzt werden, ohne Verwirrung zu stiften.

• Verwendung von Tabs vs. Collapsibles: Insbesondere im Lesemodus lassen sich Kartenüberschriften mit Tabs besser erkennen. Durch die Annäherung von Labels und Feldern an die Darstellung von Collapsible-Überschriften, nimmt der Anwender die Tabüberschriften einfacher wahr.

• Maximalbreiten: Damit sich Komponenten nicht unendlich ausbreiten, empfiehlt sich die Konfiguration von Maximalbreiten.

• Ausrichtung von Zahlenfeldern: Zahlenfelder sollten entsprechend dem Kontext sinnhaft ausgerichtet werden, um einheitliche Fluchten zu schaffen und Sprünge in der Maske zu vermeiden.
  (siehe hierzu auch Abschnitt "Prüfung der Feldeigenschaften")

• Beschränkung des vertikalen Vergrößerns von Komponenten: Aufgrund des Ausblendens leerer Felder können sich bei häufiger Nutzung große leere Flächen / Karten ergeben.

• Ein- und Ausblenden von Feldlabels: Zu einem Feld zugehörige Labels werden im Lesemodus ein- und ausgeblendet, wenn das Feld leer ist. Erfahrungsgemäß kommt es an einzelnen Stellen vor, dass das Label vor dem Feld tatsächlich nicht dem Feld zugeordnet ist und korrigiert werden muss.

Mehr Details und Empfehlungen für die optimale Konfiguration von Masken für den Lese- und Bearbeitungsmodus sind auf Anfrage erhältlich.

Die Methoden setTabEnabled und setTabVisible deaktivieren Tabs im Windows Client. Im Web Client war es bisher so, dass setTabEnabled das Tab de-/aktiviert (Deaktivierung = ausgegraut und nicht klickbar) hat, während setTabVisible das Tab un-/sichtbar gemacht hat. Im Rahmen der UI/UX-Umsetzungen wurde setTabEnabled im Web Client auf setTabVisible umgestellt, sodass zukünftig setTabEnabled und setTabVisible im Web Client die gleiche Auswirkung haben (un-/sichtbar). Eine Anpassung des Maskenskripts ist aktuell nicht notwendig. Perspektivisch wird mit dem EOL des Windows Clients auch setTabEnabled als Skriptmethode entfernt.

Prüfung der Feldeigenschaften

Nun ist es insbesondere bei der Überarbeitung der Maskendarstellung von Vorteil, dort eine aufgeräumte UI zu präsentieren und die Mehrheit der Nachschlagefelder ohne Schlüssel nur mit Beschreibung anzuzeigen. Hierfür wurde eine Möglichkeit geschaffen, die Darstellung explizit im Webclient anzupassen, ohne die Darstellung und Arbeit in den anderen Clients zu beeinflussen. Da es fachlich nur im Kontext sinnvoll entschieden werden kann, ob die Darstellung eines Schlüssels benötigt wird, ist die Darstellung pro Feld einstellbar. Die vormals dafür zuständige Systemeinstellung wurde entfernt.

Die Feldeigenschaft findet sich in einem Auswahlfeld mit folgenden Optionen:

• Nur Beschreibung

• Nur Schlüssel

• Schlüssel und Beschreibung

Der Default dieser Feldeinstellung für alle Nachschlagefelder ist "Nur Beschreibung". Eine Ausnahme stellen numerische Schlüsselfelder dar: Der Default von Schlüsselfelder mit numerischen Schlüsseln wird auf "Schlüssel und Beschreibung" stehen. Die Feldeigenschaften der Anzeige von Icons sowie der Listendarstellungen bleibt davon unberührt.

Da die neue Feldeigenschaft jegliche vorigen Einstellungen (insb. die ehemalige Systemeinstellung bzw. die Feldeigenschaften "Schlüsselfeld anzeigen" und "Beschreibung anzeigen") überschreibt, ist empfohlen, nach Abschluss des Updates die Anzeige im Web Client zu überprüfen und die Darstellung der Beschreibungen im Einzelfall anzupassen.

Wenn trotz Feldeinstellung "Nur Beschreibung" auch der Schlüssel angezeigt wird, kann es daran liegen, dass die Beschreibung so konfiguriert ist, dass der Schlüssel in der Beschreibung angezeigt wird. Die Beschreibung muss in diesem Fall angepasst werden.

Der häufigste Störfaktor für eine homogene Darstellung von Informationen im Lese- und Bearbeitungsmodus ist die Ausrichtung von Zahlenfeldern. Standardmäßig sind alle Zahlenfelder rechtsbündig eingestellt. Je nach Kontext kann es vorkommen, dass sich ein rechtsbündiges Zahlenfeld im Umfeld von linksbündigen Textfeldern befindet. Im Lesemodus hat es dann den Anschein, als wäre das Zahlenfeld in der Maske "verrutscht". Daher sollten Zahlenfelder nach dem Update überprüft und entsprechend dem Kontext sinnhaft ausgerichtet werden, um einheitliche Fluchten zu schaffen und Sprünge in der Maske zu vermeiden.

Sollen eine größere Anzahl an Zahlenfelder linksbündig umgestellt werden, kann eine Unterstützung auf Anfrage erfolgen und entsprechende Statements zur Verfügung gestellt werden.

Damit die Pflichtfeldeigenschaft zukünftig ihren eigentlichen Sinn erfüllen kann, wurde weiterhin die Feldeigenschaft "Leerschlüssel erlauben" entfernt. Ab der Version 23.2 gibt es somit nur noch die Unterscheidung zwischen Pflichtfeld ja/nein. Handelt es sich um ein Pflichtfeld, muss ein sinnhafter Wert eingetragen werden. Soll weiterhin eine Art Platzhalter für undefinierte Werte verwendet werden, muss dieser als Schlüssel manuell angelegt werden (z.B. "nicht zutreffend" / "keine Aussage möglich" / "undefiniert").

Ist ein Feld (vor der Umstellung) als Pflichtfeld definiert, aber mit einem erlaubten Leerschlüssel, muss dieses Feld zukünftig (nach der Umstellung) bei der nächsten Änderung durch den User nachgepflegt werden. Bei der Bearbeitung eines Datensatzes, bei dem in einem Pflichtfeld ein Leerschlüssel eingetragen war, kommt spätestens beim Speichern der Hinweis auf das noch zu befüllende Pflichtfeld (siehe Fall 2 in untenstehender Aufstellung).

Die Migration der Feldeigenschaften ist wie folgt:

Zur Identifizierung der betreffenden Felder des oben genannten zweiten Falles steht ein Statement zur Verfügung, welches vor dem Update ausgeführt werden muss. Sollen diese Felder zukünftig keine Pflichtfelder sein, muss die Eigenschaft Pflichtfeld = true vor oder nach dem Update auf Pflichtfeld = false geändert werden.

Oracle und MS SQL

SELECT Pk FROM AttributeMetaData 
WHERE TableName in (SELECT Pk FROM EntityMetaData)
       AND EmptyKeyAllowed = 0 AND LookupField = 1 AND NotNullField = 0
ORDER BY Pk

Anpassung von BPM-Prozessen

Prozesse, welche neue Datensätze anlegen und diese mit einem Prozess-Ende-Ereignis vom Typ "Öffnen" für den Anwender in der Detailansicht öffnen, damit der Anwender noch fehlende Informationen (wie z.B. Pflichtfelder) ergänzen kann, werden grundsätzlich im Lesemodus geöffnet. Die betreffenden Prozesse sollten auf ein Prozess-Ende-Ereignis vom Typ "Neuanlage" umgestellt werden, um eine nahtlose Benutzererfahrung zu gewährleisten.

Anpassungen von Testfällen (Test-Studio)

Datensätze werden in der Detailansicht grundsätzlich im lesenden Modus geöffnet. Hierbei muss zukünftig beachtet werden, dass leere Felder ausgeblendet sind. Insofern können Testfälle, welche auf potentiell leere Felder referenzieren, auf Fehler laufen und müssen angepasst werden. Hierfür gibt es mit der neuen Version des Test-Studios 2.x ein neues Keyword enter edit mode, welches für den Aufruf des Bearbeitungs-Modus verwendet wird. 

Beispiel: Ein Test führt eine Suche aus und springt aus der Suchergebnis-Liste in die Detailansicht eines Datensatzes. Möchte man hier verlässlich auf leere Felder prüfen bzw. leere Felder befüllen, muss in den Bearbeitungs-Modus gewechselt werden. 

Beispiel: Werden innerhalb eines Tests BPM-Prozesse ausgeführt werden, die mit einem Nachrichten-Ende-Ereignis vom Typ "Öffnen" in der Detailansicht weiterarbeiten, um leere Felder zu prüfen bzw. leere Felder zu befüllen, muss in den Bearbeitungsmodus gewechselt werden.

Weiterhin ist die Einzelbearbeitung aktuell noch nicht zugänglich für das Test-Studio. Jegliche Änderungen am Datensatz müssen im Bearbeitungs-Modus durchgeführt werden. 

Hinweise auf betroffene Testfälle geben die Keywords execute search und open [nth] dataset bzw. open {nth] dataset from subdata. 
In der Praxis hat sich bewährt, vor einer Detailprüfung der fehlerhaften Testfälle und der Suche nach der expliziten Fehlerursache das Keyword enter edit mode vor der Fehler-Stelle einzufügen. Dies schafft häufig in einem Großteil der betroffenen Testfälle bereits Abhilfe, sodass sich in diesen Testfällen die Detailprüfung und der damit zusammenhängende Aufwand gespart werden kann.

Durch das Ausblenden von leeren Tabs kann es weiterhin in Spezialfällen dazu kommen, dass man innerhalb eines Testfalls nach dem Wechsel in den Bearbeitungs-Modus zusätzlich das betreffende Tab öffnen muss, um dort Inhalte zu prüfen oder zu manipulieren.

Beispiel: In einer Tabgruppe ist das erste Tab im Lesemodus ausgeblendet, da alle Felder auf diesem Tab leer sind. Es ist im Lesemodus lediglich das zweite Tab sichtbar. Nach dem Wechsel in den Bearbeitungsmodus ist weiterhin das vorher sichtbare Tab (zweite) geöffnet. Sollen innerhalb des Testfalls Felder auf dem ersten Tab geprüft oder manipuliert werden, ist ein expliziter Wechsel auf das erste Tab notwendig.

Aufgrund von Änderungen an den Standardmasken sind einzelne Felder nicht mehr auf den ursprünglichen Tabs oder Collapsibles zu finden. Referenzieren Testfälle auf die betroffenen Tabs / Collapsibles / Felder, müssen diese angepasst werden.

Beispiel: Auf der Standard-Aktivitätenmaske wurden die Felder des Kampagnen-Tabs "C0CampaignTab" auf ein eigenes Kampagnen-Collapsible "C0CampaignCollapsible" verschoben, welches in der rechten Spalte immer sichtbar ist. Der Schritt in einem Testfall zum Öffnen des Kampagnen-Tabs, um dort beispielsweise eine Kampagne und Kampagnenphase zu verknüpfen, ist nun nicht mehr anwendbar und muss angepasst werden.

Mit dem Entfernen der Leerschlüssel aus der Anwendungsoberfläche sind unter Umständen weitere Anpassungen an Testfällen im Test-Studio notwendig. Der Wert emptykey ist nun nicht mehr als Parameter für das Überprüfen von Nachschlagefeldern oder Datumsfeldern verfügbar und muss durch einen gültigen Wert ersetzt werden.

Zuletzt kommt es aufgrund der neuen Feldeigenschaft für Nachschlagefelder "Anzeige im Web Client" dazu, dass eine Prüfung auf den Inhalt eines Feldes fehlschlagen kann.

Beispiel: Innerhalb eines Testfalls erfolgt die Feldprüfung >>"ActTypeKey.Activity" should be "ERINNERUNG"<<. Nun steht im Standardfall nach dem Update die Feldeigenschaft zur Anzeige im Web Client in diesem Feld auf "Nur Beschreibung", sodass der Testfall zukünftig auf >>"ActTypeKey.Activity" should be "Erinnerung (kein Abgleich mit Groupware)"<< prüfen muss.

Aktualisierung Datenbank-Treiber und Aktivierung der Verschlüsselung unter MSSQL

Für CURSOR-CRM wurden die Datenbank Treiber auf den aktuellen Stand gebracht. Microsoft hat im Rahmen seiner Cloud-Strategie Änderungen am SQL-Treiber vorgenommen und die Verschlüsselung zur Datenbank im Standard aktiviert. Da OnPremise Installationen üblicherweise auf eine selbstsigniertes Zertifikat setzen, schlägt die Verbindung zur MSSQL Datenbank mit dem Update auf Version 23.2 fehl. Siehe https://github.com/dotnet/SqlClient/blob/main/release-notes/4.0/4.0.0.md#breaking-changes.

Um das Problem zu umgehen, wird die Prüfung des Server-Zertifikates im Standard deaktiviert. Für Cloud-Umgebungen kann Prüfung wieder aktiviert werden.
Dazu muss in der MS SQL Server URL der Parameter "trustServerCertificate=true" ergänzt werden. In Cloud Installationen kann der Parameter deaktiviert werden (;trustServerCertificate=false).

Beispiel:

jdbc:sqlserver://<server>:1433;databaseName=<database>;trustServerCertificate=true

Hinweise auf neue Funktionalitäten

Entität 'Produkte'

Die Produkt-Maske wurde um ein neues Feld erweitert, so dass ein Produktbild hinzugefügt werden kann.

Desktop-Benachrichtigungen anzeigen

Die Option ist nun standardmäßig aktiv. Es stellt eine Änderung der Benutzereinstellungen dar, die jeden betrifft. Jedoch kann sie jederzeit wieder zurück genommen werden. Der Grund ist: viele haben die Benachrichtigungen deaktiviert oder wissen gar nicht, dass es sie gibt. Nun werden sie sichtbar, insbesondere, da sie optisch aufgewertet wurden.

Rich Client-Favoriten (myHelvis)

Im Rich Client gibt es einen Ordner für die Favoriten in der Kopfzeile. Die Favoriten im Web Client sind allerdings unabhängig von den Favoriten im Rich Client.

Nach dem Update werden Favoriten inkl. Unterordner einmalig in den Ordner "Favoriten-Import" im Hauptordner von MyHelVIS angehängt.  Ordner und Favoriten heißen identisch zum Favoriten-Menü. Favoriten im Menü sind unverändert und funktionieren ebenfalls.

Vorgangsmanagement: Rückbau des Schreibschutz bei die Vorgangstypen

Es wurden Feldeigenschaften und Patterns geändert, damit der Vorgangstyp auch nach der Neuanlage geändert werden kann.

Mit folgenden Anpassungen ist es nun wieder möglich:

• Auf dem Vorgang: Vorgangs-Nr. (TicketNo.Ticket)
  Alter Pattern Wert (für Bestandskunden): #PATTERN#[$!!$VALUE--TicketType$!!$-$!!$NUMBER7]
  Neuer Pattern Wert: #PATTERN#[$!!$NUMBER7]

• Auf dem Vorgang: Typ (TicketType.Ticket)
  Die Feldeigenschaft "Initial schreiben" ist im Standard wieder deaktiviert

Ausblenden der Anruf-Buttons via MS-Teams

Bisher konnte man die Teams-Integration per Systemeinstellung "aktivieren". Diese führte dazu, dass die Teams-Buttons in Feldern und Toollbars freigeschaltet werden. Es kommt aber vor, dass die Nutzung von Teams nur für interne Anrufe freigegeben ist und die Teams-Buttons im CRM (Anrufen über die E-Mail-Adresse) bei Ansprech- und Geschäftspartnern keine Funktion haben bzw. bei Aufruf zu einer Meldung in Teams führen.
Die Systemeinstellung soll "Externe Anrufe mit MS Teams aktivieren" legt fest, ob die Anruf-Buttons von Teams systemweit ausgeblendet werden.

Dies betrifft folgende Stellen:

• Geschäftspartner E-Mail-Feld

• Geschäftspartner Toolbar

• Ansprechpartner E-Mail-Feld

• Ansprechpartner Toolbar

• Nachschlagefeld Ansprechpartner (z.B. Aktivität mit)
  Die Funktion "Microsoft-Teams Besprechung erstellen" kann weiterhin genutzt werden. Alle Buttons bei Mitarbeitern bleiben bestehen.

Anpassung an den Prozessmasken

Um für den Anwender einen optimalen Workflow in BPM-Prozessen zu ermöglichen, sind Anpassungen an den Prozessmasken-Buttons (insb. "Fortfahren") durchgeführt worden. Der Anwender kann die notwendigen Infomationen im Formular nacheinander ausfüllen und direkt im Anschluss am unteren rechten Rand des jeweiligen Formulars den Prozess fortführen. Voraussetzung hierfür ist, dass die Prozessmaske auf erster Ebene in einer Spalte mit Maximalbreite konfiguriert ist. Ist keine Maximalbreite konfiguriert, wird der Fortfahren-Button am unteren rechten Rand angezeigt der Maske angezeigt. Wird in der Maske die Eigenschaft "vertikal vergrößern" nicht genutzt, kann sich der Fortfahren-Button direkt ans untere Ende des Formular anschließen, auch wenn die Komponente (z.B. Karte) nicht bis ans untere Ende des Fensters reicht.

Abbildung: BPM-Maske im Card-Layout und Positionierung des Fortfahren-Buttons in BPM-Prozessen

Die Funktionen "Prozess abbrechen" und "Prozess pausieren" sind nun im Schließen des Tabs platziert. Ein Klick auf den Schließen-Button des Tabs führt zu einer Abfrage, ob der Prozess unterbrochen (= Maske schließen, Variablen werden gespeichert, Benachrichtung im Benachrichtigungsmenü erscheint) oder abgebrochen (= Löschen der gesamten Instanz, räumt aber ggf. vorher angelegte Daten nicht auf) werden soll.

Weiterhin wurden nun auch alle BPM-Masken von C0-Prozessen überarbeitet und in das neue Card-Layout überführt. Die neuen BPM Standardmasken werden in nicht übersteuerten C0-Prozessen automatisch veröffentlicht und sind somit in der Anwendung sichtbar.
Wurde ein C0-Prozess übersteuert, aber es wird noch weiterhin die C0-BPM Maske verwendet, muss der Prozess einmal neu veröffentlicht werden, damit die neue C0-BPM-Maske in der Anwendung sichtbar ist.

Fehlermeldung bei einem Berechtigungsproblem in der REST-Schnittstelle

Wird versucht ein schreibgeschütztes Feld per Rest-Schnittstelle zu ändern, kommt es nun zu einer Sicherheits-Fehlermeldung und das Speichern wird abgebrochen. Dies Anpassung ist eine Verhaltensänderung, die bei bestehenden Rest-Schnittstellen-Aufrufen zu einem Fehler führen konnte, wenn Felder nicht beschrieben werden können.

Für CURSOR-BPM wird die Methode WorkSpaceScriptUtils.saveEntry() um den optionalen Parameter errorOnChangedReadonlyFields erweitert, der zur selben Verhaltensänderung wie oben führt.

errorOnChangedNotWriteableFields

• true, wenn schreibgeschützte Felder geändert wurden, wird eine ScriptingException geworfen.

• false, es werden schreibgeschützt Felder beim Speichern ignoriert. false ist der Standardwert.

Bereichsranking für die COMMAND Suchergebnisse

Das Ranking der unterschiedlichen Bereiche kann über eine Konfigurationseinstellung verändert werden, so dass man einzelne Bereiche höher gewichten kann und damit die Treffer aus diesem Bereich weiter oben angezeigt werden.

Abbildung: Konfiguration der Gewichtung

In der Anwendungsvariable EnhancedIndexSearcher kann die Gewichtung für Bereiche konfiguriert werden.

Die Gewichtung erfolgt prinzipiell nach folgender Logik: 

• Wenn kein Eintrag für einen Bereich vorhanden ist der Score 1.0

• Alles unter 1.0 wertet den Bereich ab

• Alles über 1.0 wertet den Bereich auf

Folgende Scoring-Einstellungen werden ausgeliefert:

• Geschäftspartner: 1.5

• Ansprechpartner: 1.3

• Mitarbeiter: 1.2

• Aktivität: 0.25

• Dokumente: 0.1

• Projekte: 0.25

• Vorgang: 0.25

Berücksichtigung des "Callback URL"-Aufbaus mit Port 443

Beim Aufbau der OAuth-Callback-URL wird HTTPS berücksichtigt und somit der 443-Port aus der URL entfernt wird.

Wurden in Drittsystemen URLs mit Bezug auf das CRM hinterlegt, kann es nötig sein, diese anzupassen.

• Wurden bislang die Portangaben x8443 genutzt, so ändert sich nichts.

• Wurde bislang die Portangabe 443 genutzt, so kann oder muss (abhängig vom Drittsystem) die Portangabe entfallen.

Workflows für automatischen Groupware-Abgleich und E-Mail-Import als Timer

Mit der Version 2023.2 wurden die Workflows für den BCC-Importer durch einen Timer ersetzt. Der Standard Workflow WKF_ImportMailsByBCC wurde automatisch migriert.

Abbildung: Timer "Automatischer Groupware-Abgleich"

• Der Timer wird alle 10 Minuten ausgeführt

• Im Auslieferungsstandard ist der Timer deaktiviert

• Beim Update wird der Timer automatisch aktiviert, wenn beim Kunden eine entsprechende Timer-Aktion konfiguriert war

Für eigene Workflows sind folgende manuelle Schritte notwendig:

• Änderung an der Mail-Konfiguration

  • Der Haken automatisch importieren, muss bei allen Mail-Konfigurationen manuell gesetzt werden, die zuvor über den Workflow importiert wurden.

• Anpassung Skriptbibliothek SC0MailMailUtils

  • Übersteuern der Methode getMailConfigToUpdateAfterImport: In der Methode müssen alle Mail-Konfigurationen aufgenommen werden, die für die BCC-Importer-Workflow Logiken
    verwendet wurden.

  • Übersteuern der Methode getValuesToSetAfterImport: Für jede Mail-Konfigurationen werden hier die Feldvorbelegungen für die Aktivität konfiguriert. Z.B. den Status auf erledigt setzen, die Aktivitätenart ändern...

• Anpassen des Timer Zeitraums

  • Ggf. ist der Zeitraum des Timers "Automatischer Mail-Import von E-Mail-Konfigurationen" anzupassen. Der Default-Wert für den Zeitraum beträgt 10 Minuten.

Automatisch Mails bei Nachrichten erhalten

Anwender können einstellen und entscheiden, ob zusätzlich zu den Nachrichten im CRM-System noch Mail-Benachrichtigungen für Erwähnungen, Delegationen, Mitteilungen oder Veränderungen in beobachteten Datensätzen automatisch versendet werden sollen, um einen korrekten Informationsfluss zu gewährleisten und sicherzustellen, dass keine Informationen verloren gehen.

Abbildung: Benutzereinstellungen für Mail-Benachrichtigungen

Abbildung: Mailvorlage für eine CRM-Benachrichtigung

Hinweise auf veraltete Funktionalitäten

Der Workflow SWKF_calculateIBAN wird im CURSOR-Standard entfernt

Der Workflow SWKF_calculateIBAN wird im CURSOR Standard entfernt. Dieser adressiert einen ganz spezifischen Prozess und wird von neuen Kunden und den meisten Bestandskunden nicht mehr eingesetzt. Der Prozess wird für Neukunden und Bestandskunden gelöscht. Kommt der Prozess bei Bestandskunden als Timer Aktion zum Einsatz, wird der Workflow in die Kundenschicht verschoben und muss später im Projekt als Prozess migriert werden.

Erlauben von "ForRead"-Methoden

Die "ForRead"-Methoden der WorkSpaceScriptUtils wurden für die Nutzung im EventRuleScript freigeschaltet und in der Autovervollständigung aufgenommen.
Die WorkSpaceScriptUtils Methoden, die einen IScriptWorkSpace benötigen, werden aktiv unterbunden, sie werfen dann eine NotSupportedRuntimeException.
Bisher war die Nutzung der Methoden im EventRuleScript nicht erlaubt, sie wurden allerdings nicht explizit geprüft.

Liste "ForRead"-Methoden:

• WorkSpaceScriptUtils.searchCount

• WorkSpaceScriptUtils.searchForRead

• WorkSpaceScriptUtils.searchForReadOrderedBy

• WorkSpaceScriptUtils.searchEntryForRead

Einige Methoden, die einen IScriptWorkSpace nutzen (ggf. auch nur intern), die Methoden sind auch nicht unterstützt im EventRuleScript:

• WorkSpaceScriptUtils.calculateItem(AttributeContainer)

• WorkSpaceScriptUtils.copyEntry(WorkSpace,int,String)

• WorkSpaceScriptUtils.createEmptyWorkSpace(String)

• WorkSpaceScriptUtils.createEntry(WorkSpace,int,AttributeContainer)

• WorkSpaceScriptUtils.search(String)

• WorkSpaceScriptUtils.searchDoublets(AttributeContainer, String)

• WorkSpaceScriptUtils.deleteEntry(String, String)

• WorkSpaceScriptUtils.createDefaultEntry(String)

• WorkSpaceScriptUtils.linkEntries(AttributeContainer, String, List<AttributeContainer>)

• WorkSpaceScriptUtils.unlinkEntries(AttributeContainer, String, List<AttributeContainer>)

WattIsLos-Kachel

WattIsLos-Kachel wurde aus dem Standard entfernt.