Breaking Changes

Ein Breaking Change erfordert unter Umständen manuelle Anpassungen durch den Administrator. Bitte lesen Sie dafür die Beschreibung.

9.0.2

Workbench - Server Configuration

Für die BPC-Portalanbindung muss der BPC API Key in INUBIT nun händisch eingetragen werden (z.B. via Copy/Paste).

Breaking Change

Bisher konnte der BPC API Key automatisch über die INUBIT Portalserverkonfiguration angelegt, ausgelesen und gespeichert werden. Diese Möglichkeit besteht mit BPC 5.0 nicht mehr. Der API-Key muss händisch im BPC angelegt und von ins INUBIT übertragen werden.

Betrifft:

Workbench - Server Configuration

Process Engine - REST API

Die INUBIT REST API wurde überarbeitet und konsolidiert. Dies führt zu einigen potentiell notwendigen Anpassungen.

Der Endpunkt "/ibis/servlet/IBISSoapServlet" wurde entfernt. In INUBIT müssen an allen relevanten Stellen nur noch Hostname und Port der zu erreichenden INUBIT-Instanz angegeben werden (z.B. Login, Deployment).
Der Endpunkt "/process/processes" kann nur noch ohne "/" (Slash) am Ende aufgerufen werden. Bisher wurde auch der Aufruf von "/process/processes/" unterstützt.
Fehler-Antworten werden nun im Format des Accept-Headers zurückgegeben. Standardmäßig ist dies "appplication/json".

Betrifft:

Process Engine - REST API

Connector - REST

Durch den Wechsel des zugrunde liegenden technischen REST-Frameworks ist es nicht mehr möglich, die Option „Fallback auf unsicheren Trust-Manager erlauben“ ist nicht mehr eigenständig auswählbar. Diese Option ist nur noch auswählbar, wenn die Option "Fallback auf unsichere Hostnamen-Verifikation erlauben" aktiviert wurde.

Breaking Change

Folgende Modulkonfigurationen können nicht mehr wie bisher angewendet werden:

Aktiviert: „Fallback auf unsicheren Trust-Manager erlauben“
Deaktiviert: „Fallback auf unsichere Hostnamen-Verfikation erlauben“

Inkorrekt konfigurierte Module können bei der Ausführung fehlschlagen und müssen dann manuell angepasst werden.

Vorübergehender Workaround

Mit dem Schalter -Dfeature.enable.restconnector.insecure.fallback=true im Process Engine Startskript können beide Fallback-Optionen aktiviert werden. Damit ist auch die Option für den unsicheren Hostnamen aktiviert. Nutzen Sie den Schalter nur im Ausnahmefall.

Wir empfehlen die Nutzung sicherer Verbindungen, die keine Art von Fallback benötigen.

Betrifft:

Connector - REST

Portal - General

BPC 5.0 unterstützt nicht mehr INUBIT als Identity Provider. Dieses Feature wurde daher in INUBIT entfernt.

Breaking Change

In der Portalkonfiguration in INUBIT kann kein BPC Identity Provider mehr konfiguriert werden. Dies muss nun direkt in BPC erfolgen.

Betrifft:

Portal - General

Converter - XSLT

Mit dem Wechsel auf JDK 21 funktionieren direkte Java-Aufrufe aus XSLT-Skripten heraus potentiell nicht mehr und müssen angepasst werden.

Breaking Change

Diese Verhaltensänderung ist im Wechsel von JDK 17 auf JDK 21 begründet und der damit verbundenen Änderung oder Entfernung von Java-Klassen. Saxon selbst leitet Javaaufrufe direkt ans JDK weiter und stellt keine Kompatibilität her. Dies obliegt dem Aufrufer aus dem XSLT-Skript.

Beispiel:

Mit JDK 21 wurde die Klasse Thread erweitert und eine neue Methode sleep(Duration) hinzufügt.

Bisher (JDK 17): Aufrufe von java:java.lang.Thread.sleep(1000) werden erfolgreich vom JDK ausgeführt. Die Klasse Thread enthält nur 1 Methode sleep, die als Parameter einen Wert vom Typ long erwartet.

Neu (JDK 21): Aufrufe von java:java.lang.Thread.sleep(1000)`schlagen fehlt. Die Klasse Thread enthält nun 2 Methoden `sleep, und das JDK weiß nicht, welche Methode genau aufgerufen werden soll.

Lösung: Der Aufruf von Sleep-Methode muss nun typisiert erfolgen: java:java.lang.Thread.sleep(xs:long(1000))

Betrifft:

Converter - XSLT

Application - Process Engine

Die Verwendung eines externen Identity Providers wirkt sich auch auf die Konfiguration des Prozessbenutzerservers in INUBIT aus.

Breaking Change

Wenn Keycloak als Identity Provider der INUBIT-Prozess-Engine verwendet wird, muss der Prozessbenutzerserver ebenfalls für die Verwendung desselben Keycloak konfiguriert werden, um eine erfolgreiche Authentifizierung zu gewährleisten.

Betrifft:

Application - Process Engine

9.0.1

Connector - BSI AS4

Betrifft:

Workbench - Server Configuration

Der Button zum Aktualisieren der INUBIT BPC Module wurde entfernt. Bitte stellen Sie sicher, dass im Verzeichnis deploy vom BPC die entsprechenden Module vorhanden sind. Wird das BPC über den Installer bereitgestellt, sollten die Module entsprechend vorhanden sein.

Betrifft:

Workbench - Server Configuration

Utility - Data Stream Analyser

Der Data Stream Analyser konnte über die spezielle Moduleigenschaft "datastreamanalyzer.mode" zur Verwendung des MimeUtil zum Herausfinden des MIME Types gezwungen werden. Diese Möglichkeit wurde nun entfernt. Zur Analyse wird nun immer Apache Tika verwendet.

Breaking Change

Wenn die Moduleigenschaft "datastreamanalyzer.mode" am Data Stream Analyser explizit gesetzt wird, hat sie keine Auswirkung mehr. Intern wird immer Apache Tika zur Analyse des Datenstroms ausgeführt. Dies kann zur Änderung des detektierten MIME Types führen.

Betrifft:

Utility - Data Stream Analyser

9.0.0

Application - Remote Connector, Connection Manager

Mit der INUBIT 9.0 wurde der Remote Connector angepasst.

Breaking Change

Der Remote Connector der INUBIT 9.0 lässt sich in INUBIT 8.1 und älter nicht mehr nutzen. Ein Hinzufügen im Connection Manager ist nicht mehr möglich und damit die Wartung und Überwachung erheblich eingeschränkt.

Betrifft:

Application - Remote Connector
Connection Manager

Connector - REST

Die in der Variable restConnector.responseStatusDescription verfügbare HTTP-Statusbeschreibung hat sich geändert. Wenn Sie den Wert dieser Variable benötigen, passen Sie Ihre Logik an die neuen Werte an.

Die folgende Tabelle veranschaulicht die neuen Werte:

HTTP status code	HTTP status description before 9.0	HTTP status description from 9.0 onwards
100	The client should continue with its request	Continue
101	The server is willing to change the application protocol being used on this connection	Switching Protocols
102	Interim response used to inform the client that the server has accepted the complete request, but has not yet completed it	Processing
200	The request has succeeded	OK
201	The request has been fulfilled and resulted in a new resource being created	Created
202	The request has been accepted for processing, but the processing has not been completed	Accepted
203	The returned meta-information is not the definitive set as available from the origin server	Non-Authoritative Information
204	The server has fulfilled the request but does not need to return an entity-body, and might want to return updated meta-information	No Content
205	The server has fulfilled the request and the user agent should reset the document view which caused the request to be sent	Reset Content
206	The server has fulfilled the partial get request for the resource	Partial Content
207	Provides status for multiple independent operations	Multi-Status
300	The requested resource corresponds to any one of a set of representations	Multiple Choices
301	The requested resource has been assigned a new permanent URI	Moved Permanently
302	The requested resource can be found under a different URI	Found
303	The response to the request can be found under a different URI	See Other
304	The client has performed a conditional GET request and the document has not been modified	Not Modified
305	The requested resource must be accessed through the proxy given by the location field	Use Proxy
307	The requested resource resides temporarily under a different URI	Temporary Redirect
400	The request could not be understood by the server due to malformed syntax	Bad Request
401	The request requires user authentication	Unauthorized
402	This code is reserved for future use	Payment Required
403	The server understood the request, but is refusing to fulfill it	Forbidden
404	The server has not found anything matching the request URI	Not Found
405	The method specified in the request is not allowed for the resource identified by the request URI	Method Not Allowed
406	The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request	Not Acceptable
407	This code is similar to Unauthorized, but indicates that the client must first authenticate itself with the proxy	Proxy Authentication Required
408	The client did not produce a request within the time that the server was prepared to wait	Request Timeout
409	The request could not be completed due to a conflict with the current state of the resource	Conflict
410	The requested resource is no longer available at the server and no forwarding address is known	Gone
411	The server refuses to accept the request without a defined content length	Length Required
412	The precondition given in one or more of the request header fields evaluated to false when it was tested on the server	Precondition Failed
413	The server is refusing to process a request because the request entity is larger than the server is willing or able to process	Payload Too Large
414	The server is refusing to service the request because the request URI is longer than the server is willing to interpret	URI Too Long
415	The server is refusing to service the request because the entity of the request is in a format not supported by the requested resource for the requested method	Unsupported Media Type
416	For byte ranges, this means that the first byte position were greater than the current length of the selected resource	Requested range not satisfiable
417	The expectation given in the request header could not be met by this server	Expectation Failed
422	The server understands the content type of the request entity and the syntax of the request entity is correct but was unable to process the contained instructions	Unprocessable Entity
423	The source or destination resource of a method is locked	Locked
424	The method could not be performed on the resource because the requested action depended on another action and that action failed	Failed Dependency
429	The server is refusing to service the request because the user has sent too many requests in a given amount of time (\"rate limiting\")	Too Many Requests
500	The server encountered an unexpected condition which prevented it from fulfilling the request	Internal Server Error
501	The server does not support the functionality required to fulfill the request	Not Implemented
502	The server, while acting as a gateway or proxy, received an invalid response from the upstream server it accessed in attempting to fulfill the request	Bad Gateway
503	The server is currently unable to handle the request due to a temporary overloading or maintenance of the server	Service Unavailable
504	The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server specified by the URI (e.g. HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed to access in attempting to complete the request	Gateway Timeout
505	The server does not support, or refuses to support, the protocol version that was used in the request message	HTTP Version not supported
507	The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request	Insufficient Storage

HTTP status code

HTTP status description before 9.0

HTTP status description from 9.0 onwards

100

The client should continue with its request

Continue

101

The server is willing to change the application protocol being used on this connection

Switching Protocols

102

Interim response used to inform the client that the server has accepted the complete request, but has not yet completed it

Processing

200

The request has succeeded

201

The request has been fulfilled and resulted in a new resource being created

Created

202

The request has been accepted for processing, but the processing has not been completed

Accepted

203

The returned meta-information is not the definitive set as available from the origin server

Non-Authoritative Information

204

The server has fulfilled the request but does not need to return an entity-body, and might want to return updated meta-information

No Content

205

The server has fulfilled the request and the user agent should reset the document view which caused the request to be sent

Reset Content

206

The server has fulfilled the partial get request for the resource

Partial Content

207

Provides status for multiple independent operations

Multi-Status

300

The requested resource corresponds to any one of a set of representations

Multiple Choices

301

The requested resource has been assigned a new permanent URI

Moved Permanently

302

The requested resource can be found under a different URI

Found

303

The response to the request can be found under a different URI

See Other

304

The client has performed a conditional GET request and the document has not been modified

Not Modified

305

The requested resource must be accessed through the proxy given by the location field

Use Proxy

307

The requested resource resides temporarily under a different URI

Temporary Redirect

400

The request could not be understood by the server due to malformed syntax

Bad Request

401

The request requires user authentication

Unauthorized

402

This code is reserved for future use

Payment Required

403

The server understood the request, but is refusing to fulfill it

Forbidden

404

The server has not found anything matching the request URI

Not Found

405

The method specified in the request is not allowed for the resource identified by the request URI

Method Not Allowed

406

The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request

Not Acceptable

407

This code is similar to Unauthorized, but indicates that the client must first authenticate itself with the proxy

Proxy Authentication Required

408

The client did not produce a request within the time that the server was prepared to wait

Request Timeout

409

The request could not be completed due to a conflict with the current state of the resource

Conflict

410

The requested resource is no longer available at the server and no forwarding address is known

Gone

411

The server refuses to accept the request without a defined content length

Length Required

412

The precondition given in one or more of the request header fields evaluated to false when it was tested on the server

Precondition Failed

413

The server is refusing to process a request because the request entity is larger than the server is willing or able to process

Payload Too Large

414

The server is refusing to service the request because the request URI is longer than the server is willing to interpret

URI Too Long

415

The server is refusing to service the request because the entity of the request is in a format not supported by the requested resource for the requested method

Unsupported Media Type

416

For byte ranges, this means that the first byte position were greater than the current length of the selected resource

Requested range not satisfiable

417

The expectation given in the request header could not be met by this server

Expectation Failed

422

The server understands the content type of the request entity and the syntax of the request entity is correct but was unable to process the contained instructions

Unprocessable Entity

423

The source or destination resource of a method is locked

Locked

424

The method could not be performed on the resource because the requested action depended on another action and that action failed

Failed Dependency

429

The server is refusing to service the request because the user has sent too many requests in a given amount of time (\"rate limiting\")

Too Many Requests

500

The server encountered an unexpected condition which prevented it from fulfilling the request

Internal Server Error

501

The server does not support the functionality required to fulfill the request

Not Implemented

502

The server, while acting as a gateway or proxy, received an invalid response from the upstream server it accessed in attempting to fulfill the request

Bad Gateway

503

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server

Service Unavailable

504

The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server specified by the URI (e.g. HTTP, FTP, LDAP) or some other auxiliary server (e.g. DNS) it needed to access in attempting to complete the request

Gateway Timeout

505

The server does not support, or refuses to support, the protocol version that was used in the request message

HTTP Version not supported

507

The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request

Insufficient Storage

Betrifft:

Connector - REST

Connector - REST

Betrifft:

Connector - REST

Connector - REST

Ab INUBIT 9.0 werden REST-Konnektoren, die mehrere Pfadparameter mit gleichem Namen enthalten, nicht mehr ausgeführt. Die folgenden Aktionen führen zu Fehlern in den entsprechenden Konnektoren:

Registrieren von Listener-Konnektoren beim Serverstart
Aktivieren
Veröffentlichen
Importieren
Deployment

Breaking Change

Pfadparameternamen dürfen nicht mehrfach verwendet werden. Korrigieren Sie Duplikate entsprechend.

Betrifft:

Connector - REST

Connector - REST

Ab INUBIT 9.0 werden REST-Konnektoren, deren Pfadparameter einen "." (Punkt) enthält, nicht mehr ausgeführt. Die folgenden Aktionen führen zu Fehlern in den entsprechenden Konnektoren:

Registrieren von Listener-Konnektoren beim Serverstart
Aktivieren
Veröffentlichen
Importieren
Deployment

Breaking Change

Pfadparameternamen dürfen keine Punkte mehr enthalten. Korrigieren Sie fehlerhafte Namen entsprechend.

Betrifft:

Connector - REST

Connector - REST

Die bis einschließlich INUBIT 8.1 verfügbare Funktion, die das Senden einer Anfrage mit dem Abfrageparameter „method=<HTTP-Methode>“ und damit das Überschreiben der HTTP-Methode am Endpunkt ermöglichte, wird eingestellt und ist nicht mehr verfügbar.

Breaking Change

Aufrufe an nicht existierende Endpunkte werden mit Status 405 abgewiesen.

Endpunkte müssen nun mit der HTTP-Methode aufgerufen werden, mit der sie in der API bereitgestellt werden. Das Überschreiben der HTTP-Methode ist nicht mehr möglich.

Betrifft:

Connector - REST