======================================================================================================================================== INUBIT 7.4 ======================================================================================================================================== Inhalt: - Installation - Migration eines vorhandenen Systems - Hinweise für Betreiber der inubit-Software als Appliance - Bekannte Inkompatibilitäten - Abkündigungen -------------------------------------------------------------------------------------------------------------------------------------- INSTALLATION -------------------------------------------------------------------------------------------------------------------------------------- HINWEIS: Die unterstützten Hardware-Plattformen, Betriebssysteme, Datenbanken, Web-Browser und Portale finden Sie in der Installationsanleitung: https://files.virtimo.net/Userportal/Inubit/7.4/Docs/online-help/de/index.htm#Installation.SystemRequirements.html HINWEIS: Um die kontextsensitive inubit-Onlinehilfe der inubit Workbench in Google Chrome zu öffnen, müssen Sie im inubit-Applikationsprofil für den Browser den Chrome-Aufruf um die folgende Option ergänzen: --allow-file-access-from-files Siehe: - https://files.virtimo.net/Userportal/Inubit/7.4/Docs/online-help/de/index.htm#Configuration.ApplicationProfiles.html - https://files.virtimo.net/Userportal/Inubit/7.4/Docs/online-help/de/index.htm#features_online_help.html 1. Vorbereitung: Lesen Sie die Installationsanleitung aufmerksam durch: https://files.virtimo.net/Userportal/Inubit/7.4/Docs/online-help/de/index.htm#installation_guide.html 2. Installation: Starten Sie die zu Ihrem Betriebssystem passende Setup-Datei, um die Installation zu starten. -FO Converter: Wegen vieler Verbesserungen für das Erstellen von PDF-Dateien mit Apache FOP 2.3 gibt es eine Inkompatibilität mit früheren Versionen von Apache FOP: Wenn es im XSLT-Stylesheet ein leeres -Element gibt, unterscheidet sich das Layout der PDF-Datei, weil die neue FOP-Version 2.3 leere Blöcke nicht berücksichtigt. Um dieses Problem zu lösen, fügen Sie jedem -Abschnitt ein -Element hinzu, damit es kein leeres Element mehr ist, z. B. wie folgt: Informationen über weitere Änderungen finden Sie in der Änderungshistorie für Apache FOP 2.3: https://xmlgraphics.apache.org/fop/2.3/changes_2.3.html -------------------------------------------------------------------------------------------------------------------------------------- MIGRATION EINES VORHANDENEN SYSTEMS -------------------------------------------------------------------------------------------------------------------------------------- Eine ausführliche Migrationsanleitung finden Sie im Software Innovations User Portal unter https://files.virtimo.net/Userportal. Siehe: https://files.virtimo.net/Userportal/Inubit/7.4/Docs/online-help/de/index.htm#Migration_Guide.html Bei Fragen zur Migration wenden Sie sich an den Support der Virtimo AG: - Phone: +49 30 555 744 044 - Support-System: https://support.virtimo.de -------------------------------------------------------------------------------------------------------------------------------------- HINWEIS FÜR BETREIBER DER INUBIT-SOFTWARE ALS APPLIANCE -------------------------------------------------------------------------------------------------------------------------------------- Aktualisieren Sie die Appliance-Versionen nicht selbständig! Bitte nehmen Sie Kontakt mit der Virtimo AG auf. -------------------------------------------------------------------------------------------------------------------------------------- BEKANNTE INKOMPATIBILITÄTEN ZU INUBIT 7.1 UND FRÜHER -------------------------------------------------------------------------------------------------------------------------------------- - Variablenmappings mit einer Passwortvariablen oder einer Password-Moduleigenschaft als Mapping-Quelle und mit einem Mapping-Ziel, das einen XPath enthält, führen jetzt zu einem Fehler, wenn die Property "RestrictedPasswordPropertyAccess" der Server-Konfiguration auf "true" gesetzt ist, was seit inubit 6.0 der Standard ist. Ab inubit 6.0 ist es unmöglich, solche Mappings zu erstellen. Wenn Workflows solch ein in einer früheren inubit-Version erstelltes Mapping verwenden, müssen diese Workflows angepasst werden, so dass als Mapping-Quelle eine Variable des Typs "is:maskedString" verwendet wird. -------------------------------------------------------------------------------------------------------------------------------------- BEKANNTE INKOMPATIBILITÄTEN ZU INUBIT 7.3 -------------------------------------------------------------------------------------------------------------------------------------- - Die Authentifizierung der REST-Schnittstelle wurde geändert. Der Benutzer sollte entweder den Parameter "userType=processEngineUser" oder "userType=processUser" im Request hinzufügen, um sich gegenüber dem Process Engine Benutzer oder dem Prozessbenutzer zu authentifizieren. Standardmäßig werden Requests gegenüber dem Prozessbenutzer authentifiziert, wenn der Parameter "userType" nicht gesetzt wurde. - File Connector: Es wurden neue Sortiermöglichkeiten hinzugefügt, standardmäßig wird in aufsteigender Reihenfolge sortiert. - Configuration Panel: Für einige Konfigurationseigenschaften wurde Validierung hinzugefügt, sodass ungültige Einträge nicht mehr eingegeben werden können. - Process Data Logger: Es wird nur noch XPath 2.0 unterstützt, XPath 1.0 kann in diesem Modul nicht mehr verwendet werden. - REST Interface: Der Zugriff wurde beschränkt auf USER REST API (http://:/ibis/rest/user/*), abhängig von der Benutzerrolle. - Process-Engine-Benutzer: Benutzer mit der Rolle System Administrator sind berechtigt. - Liferay/IM-Benutzer: Benutzer mit der Rolle System Administrator sind berechtigt. - LDAP-Benutzer: LDAP-Benutzer, die in inubit importiert wurden und die Rolle System Administrator besitzen, sind berechtigt. - Anpassungen: Verwenden Sie Benutzer mit einer berechtigten Rolle oder weisen Sie dem Benutzer diese Rolle zu. - Workbench: - Das Fenster-Menü wurde entfernt, da seine Funktion redundant war. - Anpassungen: Um auf die verschiedenen Fenster zuzugreifen, nutzen Sie die Register. - Im Dialog inubit Workbench-Einstellungen (Datei > Einstellungen) wurden die Abschnitte konsolidiert und teilweise umbenannt. - Der Ordner "Verschiedenes" wurde in "Caching und Performance" umbenannt. - Der Ordner "Editor" wurde in "Editor-Optionen" umbenannt. - Die Ordner "Auto-Speichern" und "Auto-Aktualisieren" wurden gelöscht und die Optionen "Auto-Speichern von Artefakten", "Auto-Speichern-Intervall" und "Auto-Aktualisierungsintervall der Workbench" in den Ordner "Caching und Performance" verschoben. - Die Ordner "XPath-Assistent", "XSLT-Auto-Speichern" und " Autovervollständigen" wurde gelöscht und die Optionen "Individuelle Funktionen (Liste von Klassenamen)", "Quell- und Zieldateien in der Process Engine speichern", and "Autovervollständigen", in den Ordner "Editor-Optionen" verschoben. - Technical Workflows und BPEL-Diagramme können weder gelöscht noch publiziert werden, wenn ein Moduleditor-Dialog geöffnet ist. Eine Warnmeldung wird angezeigt, dass das Löschen/Publizieren von Technical Workflows und BPEL-Diagramme erst dann möglich ist, wenn alle Moduleditor-Dialoge geschlossen sind. - Andere Diagramme können gelöscht oder publiziert werden, auch wenn ein Moduleditor-Dialog geöffnet ist. - Das Hilfe-Menü wurde geändert: - Der bisherige Menüpunkt "Onlinehilfe" wurde in "Hilfe" umbenannt und mit der lokalen HTML-Hilfe verlinkt. - Der neue Menüpunkt Onlinehilfe" wurde hinzugefügt und mit der Online-Dokumentation verknüpft. - Die beiden Menüpunkte "Überblick Systemkonnektoren/Module" und "Online-Versionsprüfung" wurden aus dem Hilfe-Menü entfernt. - Der neue Menüpunkt "User Portal" wurde dem Hilfe-Menü hinzugefügt und mit dem "Bosch Software Innovations User Portal" verknüpft. - CLI/User Management: Das CLI-Login wurde auf den "System Administrator" beschränkt. Andere Benutzerrollen können das individuelle Recht zum Zugriff auf das CLI über das neue Recht "CLI Login Access" erhalten, dass im Bereich "Sonstige Rechte" gesetzt wird. - User Management: Das bisherige Recht "Bearbeiten" wurde beschränkt und ist durch die Rechte "Erstellen" und "Löschen" vervollständigt. - Monitoring: Im Kontextmenü des Queue Manager ist der Menüpunkt "Prozess löschen" deaktiviert für Einträge mit dem Status "Retry". - Designer: - Tooltips werden in der globalen Suche auf 100 Zeichen beschränkt, wenn man mit der Maus über den Text fährt. - Anpassungen: Ist der Tooltip länger als 100 Zeichen, öffnen Sie das Variablenfenster, um den vollständigen Namen anzuzeigen. - Das Verschieben von Modulen zwischen Benutzergruppen wurde eingeschränkt, um eine höhere Datenintegrität zu bieten. Im Moduleditor sollten Module von der Kind zur Elterngruppe verschoben werden. Im umgekehrten Fall sollten Validierungen von irgendeinem anderen Benutzer/Benutzergruppe vorgenommen werden. Wurde ein Workflow unter einem Ziel-Benutzer oder einer Ziel-Benutzergruppe gefunden, kann das Modul nicht verschoben werden. Gibt es irgendeinen anderen Benutzer als Kinder des Ziels, in dem der Workflow vorhanden ist, kann das Modul nicht verschoben werden. - Benutzer/ Benutzergruppennamen können nicht durch das Ändern der Groß-/Kleinschreibung in einen vorhandenen Namen umbenannt werden, um Namenskonflikte zu vermeiden. - Workflows können nicht denselben Namen für ein Diagramm und eine Gruppe verwenden. Anderenfalls wird die Fehlermeldung "Gruppennamen dürfen nicht denselben Namen haben wie das Diagramm" angezeigt. - Wenn ein Workflow mit identischem Diagramm- und Gruppennamen aus einer früheren Version noch inubit 7.4 migriert wird, erfolgt die Validierung des Namens erst beim Bearbeiten der Workflow-Eigenschaften. Wenn Sie im Wizard beim Bearbeiten der Workflow-Eigenschaften auf den "Weiter"-Button klicken, wird die Fehlermeldung "Gruppennamen dürfen nicht denselben Namen haben wie das Diagramm" angezeigt. - JRE: inubit wird nicht länger mit JRE/JVM ausgeliefert. - Anpassungen: JAVA 11 oder OpenJDK 11 muss auf dem System installiert sein und die Variable JAVA_HOME must vor der Einrichtung von inubit entsprechend gesetzt sein. - Import/Export/Deployment: - Werden mehrere Diagramme oder Module von mehreren Benutzern oder Benutzergruppen importiert oder deployt, wird der Ziel-Benutzer oder die Ziel-Benutzergruppe analog zu dem Quell-Benutzer oder die Quell-Benutzergruppe verwendet, sofern sie vorhanden sind. Anderenfalls werden sie in den ausgewählten Benutzer oder die Benutzergruppe importiert oder deployt. - Anpassungen: Diese Verhalten muss insbesondere beim automatisierten Importieren/Deployen beachtet werden, wenn mehrere Diagramme oder Module von mehreren Benutzern oder Benutzergruppen importiert oder deployt werden. - Der Test importierter Dateien wurde verfeinert, z. B. um zu verhindern, dass eine Datei *.user.zip anstelle einer Datei *.diagram.zip importiert wird. Dies wird verhindert und eine Fehlermeldung angezeigt. - Anpassungen: Sie müssen ggf. das automatisierte Importieren von Artefakten anpassen. - Das Behandeln des Aktivierungsstatus von Workflows wurde geändert. Da es jetzt möglich ist, alle Workflows während des Imports zu aktivieren oder zu deaktivieren; letzteres ist nicht länger der Standard. Beim Importieren neuer Workflows in ein System müssen Sie den Aktivierungsstatus, erhalten sie den Aktivierungsstatus der Importdatei. - Stellen Sie sicher, dass Sie den Aktivierungsstatus auf "Aktivieren" oder "Deaktivieren" gesetzt haben, abhängig davon, welchen Status Sie nach dem Import benötigen. - LDAP Connector: Wenn Sie eine sichere Verbindung (ldaps) verwenden, tritt nach einer JDK-Aktualisierung der Fehler "No subject alternative names present" auf. - Anpassungen: Der Hostname oder die IP-Adresse müssen unter SAN category im Zertifikat hinzugefügt werden. - AS2 Connector: - Der MDN-Report wurde um folgende Werte erweitert und deshalb die Reihenfolge im Report geändert: - MDN-From (Sender) - MDN-To (Empfänger) - MDN-Message-ID (MDN-Nachrichten-ID) - MDN-Message-Date (MDN-Nachrichten-Datum) -------------------------------------------------------------------------------------------------------------------------------------- BEKANNTE PROBLEME -------------------------------------------------------------------------------------------------------------------------------------- - Workbench: - Verknüpfte Zeichenkatten (z. B. Dateipfade), die länger als 255 Zeichen werden, können Probleme in Zeitplanern (Schedulers) und beim Absenden in Web-Applikationen auftreten. - Umgehung: Begrenzen Sie die Namen, z. B. von Dateien, Workflows und Modulen auf eine angemessene Länge. - Workbench-Icons und Fonts erscheinen unscharf. - Umgehung: Öffnen Sie die "Anzeigeeinstellungen". Reduzieren Sie Skalierung auf 100%. Die Icons will erscheinen normal, nur die Größe der Workbench erscheint kleiner. - TCP/IP Connector: Die maximale Anzahl von TCP/IP-Verbindungen ist auf 30 beschränkt. Stellen Sie sicher, dass nicht mehr als 30 Verbindungen zu inubit BPM hergestellt werden, ansonsten gehen diese Daten verloren. Bis zur maximalen Anzahl von TCP/IP-Verbindungen sind die bearbeiteten Einträge im Queue Manager sichtbar. - Offline-Modus: - Cryptographer Module: Verschlüsselungstypen HMAC-Algorithmen sind nicht verfügbar, das Modul die die Schlüssel-Verschlüsselung der Process Engine verwendet. - Process Data Logger: Tabellendetails sind nicht editierbar (Tabelle kann nicht ohne Serververbindung gefunden werden). - Allgemeine Moduleigenschaften: Auf der Wizard-Seite " Allgemeine Moduleigenschaften" sind die Drop-down-Listen "Eingabe" und "Ausgabe" leer. - Die Zeichensätze CP850 und CP437 sind nicht verfügbar, weil sie in der Process Engine geprüft werden. - Wenn die Process Engine neu gestartet wird, erkennt die Workbench dies, bleibt aber inaktiv bis zum Neustart der Process Engine. - Instant-Nachrichten werden im Offline-Modus nicht angezeigt. - Moduleigenschaften sind nur für Module verfügbar, die schon einmal im Online-Modus geöffnet wurden, z. B. über die Option "Eigenschaften anzeigen". - In einigen Fällen kann sich der Mauszeiger vorübergehend in eine Sanduhr verwandeln und das fehlerfreie Arbeiten mit der Workbench behindern. - Globale Suche: Derzeit werden mehrsprachige Einstellungen nicht unterstützt und Begriffe in zusätzlichen Sprachen werden nicht gefunden. - BPMN-Import und -Export: - Allgemein: - Nachrichtenartefakte, bei denen das Initiieren nicht ausgewählt wurde, müssen geprüft werden, da dies kein BPM-Attribut repräsentiert. - Die Elemente "Choreographieaufgabe" und "Aufruf-Choreographieaktivität" werden in BPMN nicht unterschieden. - BPMN-Export: - Ereignisse mit unterschiedlichen Ereignisdefinitionen werden als Standardelemente betrachtet. - Die Elemente "Bild" und "Black Box Pool" werden von BPMN nicht unterstützt und werden nicht exportiert. - Wenn ein Diagramm importierte wurde, das eine Lane ohne Pool enthält, kann es so exportiert werden wie es importiert wurde. - BPMN-Import: - Die Variable "isExecutable" wird standardmäßig auf den Wert "false" gesetzt. - Wenn ein Sub-Prozess kein Kind-Element enthält, werden die Grenzelemente nicht angezeigt. - Verbindungen zwischen einem Nachrichtenfluss und den Elementen eines Sub-Prozesses werden nicht übernommen. - Wenn das zu importierende Diagramm eine Lane ohne Pool enthält, wird es nicht angezeigt. - Nachrichtenelemente, die mit einem Choreographie-Participant verknüpft sind, sollten nach dem Import geprüft werden. - Aufrufaktivitäten sollten nach dem Import geprüft werden. - Der XSLT-Konverter entfernt beim Parsen der Eingangsnachricht das CR aus der CRLF-Kombination. Dies ist auf den internen Parse-Prozess von dom4j.jar zurückzuführen, der von W3C empfohlen wird. - Globale Variablen: - Die Benutzung einer globalen Variablen kann nicht überwacht werden, wenn die globale Variable in den Einstellungen folgender Module verwendet wird: - Data Converter: Complex Lookup Table, Lookup Table, Task Generator - Utilities: Process Data Logger - FTP Connector: Die Auswahl entfernter Dateien wird nur für das FTP-Protokoll unterstützt und wurde für die Protokolle SFTP und FTPS deaktiviert, die wie bisher benutzt werden können. Hinzu kommt, dass die Auswahl entfernter Dateien für Linux and Windows 7 aktiviert wurde. Für Windows 10 wurde die Auswahl entfernter Dateien für alle Protokolle deaktiviert. - MongoDB Connector: Bestehende MongoDB Connector-Module haben QueryType-Werte wie "Find_All" oder "Find_using_filter". Wenn inubit von der Version 7.4.0.13 oder kleiner auf die aktuelle Version gepatcht wurde, werden die Werte für neu angelegte Module als "FindAll" oder "FindUsingFilter" angezeigt. Für bestehende MongoDB Connector-Module werden die konfigurierten Werte für die Moduleigenschaft angezeigt und die Module arbeiten wie erwartet. Die Werte der Moduleigenschaft werden jedoch geändert, sobald das Modul im Modul-Wizard geöffnet und gespeichert wurde - Database Connector: - Wenn Sie den Typ "call" in einer Database Connector-Query verwenden, wird das Attribut "queryId" ignoriert. Wenn vor diesem "call" eine "SELECT"-Query ausgeführt wurde, wird stattdessen die vorherige "queryId" verwendet. Daher funktioniert ein paralleler "call" zweier StoredProcedures/Functions nicht korrekt, weil die "resultSets" nicht zugeordnet werden können. - EDI Adapter: - Ab inubit BPM 7.0 erfordert der EDI Adapter unformatierten Text als Eingangsnachricht. Das Verarbeiten von Eingangsnachrichten in anderen Formaten kann fehlschlagen. -------------------------------------------------------------------------------------------------------------------------------------- ABKÜNDIGUNGEN IN INUBIT 7.4 -------------------------------------------------------------------------------------------------------------------------------------- - AS1 Connector - Baan Connector - Exchange Connector - GAEB Adapter - ITA Connector - JAAS Connector - MSMQ Connector - OFTP Connector - RFID Connector - ICR Connector - Solaris-Support - 32-Bit-Installer (Linux, Windows) - Liferay 6.x-Support