The 2025.2 release introduces three new features and one fix, along with metamodel changes.
JSON – Single Item Array Conversion to Object
The standard API JSON output converts arrays with a single element into arrays containing a single element. However, a recent requirement from our partner led to the introduction of a new feature. The Data Structure Entity now includes a new property, SerializeAsSingleJsonObject. This property controls JSON serialization in the API:
If set to false, it always serializes as an array of objects.
If set to true, it serializes as a single JSON object and returns an error if multiple objects exist.
IMAP Loader Improvements
The IMAP loader previously struggled with messages containing characters that were invalid for XML processing. Improvements have been made to enhance resilience and stability. The improved loader now moves such messages to a badmail folder, with an option to sanitize invalid characters. For more details, refer to the loader’s documentation.
Improved Authentication Support for External Applications
We have enhanced support for the authentication process of external applications.
Changing the language on the login screen no longer causes the authentication context to be lost. Previously, changing the language redirected the authentication process to the main Origam application instead of the intended external application.
The reset password workflow now preserves the authentication context, ensuring users are redirected to the external application after completing the process.
Workflow Commands Ordering
Previously, there was no way to control the order of commands and action buttons on work queue screens. In this version, the system now uses the Order field as the basis for ordering buttons.
The issue affected data processing in workflows and other components, such as the IMAP loader, where invalid XML characters caused processing failures. A sanitisation procedure has been implemented to replace these invalid characters with a safe substitute, specifically \uE000.
Improved Visibility for Password Recovery Link
The password recovery link lacked an underline decoration, making it indistinguishable from surrounding text. This has now been corrected for better visibility.
Removal of XML Declaration in API HTML Output
The HTML output generated by the Origam API incorrectly included an XML declaration, leading to rendering issues in browsers. This declaration has now been removed to ensure proper display.
Like the previous patch, this update also resolves three issues.
Interaction Between Multiple Checkboxes and Action Buttons
Two problems were identified regarding the interaction between row selection and action button availability: work queue action buttons were disappearing when selecting all records, and action buttons on lazily loaded screens were also affected. The issue stemmed from how row states were delivered to the frontend and processed. The current solution is to ignore row states for this type of action (MultipleCheckboxes), expecting that the action workflow itself will validate the selection.
Serialization of Array Types in Workflows
Array types were not being properly serialized when processed in workflows, which caused errors, particularly when working with an array of GUIDs. This issue has now been resolved.
Improvements to German Localisation
The German localisation of the reset password form was incomplete, with missing translations and wording inconsistencies. These have now been corrected.