New Features in ADONIS 14.1
ADONIS 14.1 is a feature update to ADONIS 14.0 LTS. It includes a number of improvements and new features that are listed below.
Furthermore, this update includes fixes for problems discovered since the release of ADONIS 14.0 LTS.
New Features for All Users
Share and Invite
Sharing repository content with other ADONIS users has never been easier! The new Share button is bright blue and you can access it from everywhere with one click:
You can easily share links with multiple people. Just start typing a username or email address, and then choose the user you want to share with from the list that appears.
If the recipient is not an ADONIS user or has no email address associated, you need to enter the full email address. You can even add a personal message if you want.
For details, please refer to the section "Share Models, Objects and Analyses" in the User Manual.
Matrix Charts: Sort by Order
You can sort a matrix chart to show objects based on their order.
Previously, objects could only be sorted alphabetically (A to Z or Z to A) by name. In ADONIS 14.1, a new sorting option is available for matrix charts containing process diagram objects: Objects can be sorted according to their order in a model.
For details, please refer to the section "Adjust Charts" in the User Manual.
Additional Improvements to Existing Features
In addition to these more major changes, ADONIS 14.1 also includes numerous minor improvements, including:
Accessibility Improvements
We are committed to increasing accessibility for people with disabilities. We view accessibility as an ongoing effort and carry out accessibility tests at regular intervals. In ADONIS 14.1, we focused on improving keyboard navigation in several places and optimised alternative texts for buttons and icons.
BPD Insights: Process Hierarchy Visualisation Improvements
The Process Hierarchy widget is part of the Insights dashboard for 
Business Process Diagrams. It shows the parent processes as well as the child processes of a Business Process Diagram in the process hierarchy of the organisation.
To increase user experience and performance in case of very large hierarchies, ADONIS 14.1 only displays processes with a direct connection to the central node by default. An arrow next to a node shows that a branch can be further extended. Just click on the node to expand (or collapse) a branch.
In addition, the central node now has a grey background so that you don't lose track of things, particularly with very large hierarchies.
Simulation: Resource Costs Added to Non-personnel Costs
When a 
Resource is assigned to a 
Task (Technical resource relation in the Notebook chapter "Systems/Products"), its costs will now be added to the non-personnel costs of the process.
Resource costs are calculated by multiplying the Execution time of the Task by the Hourly wages of the assigned Resource.
The Execution time of a Task in a process is 15 minutes (= ¼ hour). The hourly wages for using a Resource which is assigned to this Task is "60 EUR" (currency is implicit) per hour. The total resource cost per process is 15 EUR (¼ x 60).
To calculate the total amount of non-personnel costs of a process, the resource costs are added to the costs of executing activities.
New Features for Users of the ADONIS BPMS Application Library
Process Synchronisation Extended
You already have master data stored in a 
Process object and want to activate synchronisation with a Business Process Diagram? A transfer from the Process object to the Business Process Diagram is now possible during the initial data exchange. Previously, data could only be taken from the Business Process Diagram.
After the initial data copy is performed, ADONIS will keep common properties between the Process and the referenced Business Process Diagram synchronised. From now on, data only flows from the model to the object. Common properties are displayed read-only in the Notebook of the Process and can be edited in the Notebook of the Business Process Diagram.
For details, please refer to the section "Synchronise Process Attributes" in the User Manual.
Methodical Improvements in the ADONIS BPMS Library 14.1
Responsible Organisational Unit Relation Can Have Multiple Targets
With this version of the ADONIS BPMS Application Library, the Responsible organisational unit relation in the Notebook of 
Applications can have an arbitrary number of targets instead of one.
This improvement allows you to model responsibilities more naturally. In addition, the synchronisation of objects between ADONIS and ADOIT is more accurate now. When an ArchiMate element is imported from ADOIT, all listed responsible organisational units can now be faithfully replicated on the ADONIS side.
Text Annotations: Use Legacy Formatting
ADONIS 14.0 introduced an inline editor for 
Text Annotations and 
Notes in models, which allows users to format annotation text as needed. This change slightly altered the appearance of these objects in models.
To ensure that models containing Text Annotations look the same as they did before the change, as of ADONIS 14.1.8, the Use legacy formatting option has been added to the Text Annotation Notebook (found in the "General information" chapter). This option is similar to the one introduced for Notes in ADONIS 14.0 and allows users to revert to the previous appearance instead of using the new inline editor.
The Use legacy formatting option can be enabled for all existing Text Annotations and Notes in the repository by running a script when upgrading from an earlier version of ADONIS to ADONIS 14.1.8 or higher.
Migration from an Earlier Version of ADONIS to ADONIS 14.1
Changes to Software Requirements
Please note the following changes to the software requirements for running ADONIS when migrating from previous versions:
- ADONIS Now Supports PostgreSQL
As of ADONIS 14.1.4, as an alternative to SQL Server and Oracle, ADONIS supports the powerful open source database system PostgreSQL. ADONIS is compatible with PostgreSQL 12.2 or higher.
You can create the database automatically using the tool Database Administration (adbinstws.exe) or create the database manually using pgAdmin or create the database from script.
You can find a guide on how to create a PostgreSQL database for ADONIS in the online help (see "Creating a PostgreSQL Database").
- Java Logging: Switch to Logback from Log4j
Due the recent well-documented security issues related to the usage of older versions of the log4j Java logging library, BOC Group has decided to switch to the alternative Java logging framework logback (https://logback.qos.ch/). A new standard logging configuration is delivered with the product. Custom logging configurations need to be migrated.
Migration from ADONIS 14.0 to ADONIS 14.1
If you upgrade from ADONIS 14.0 to ADONIS 14.1, you do not have to create a new database and import a migration package if you are using the ADONIS BPMS Application Library.
This approach is also valid if you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library. Please contact your ADONIS consultant to clarify if a new version of your application library is required before you proceed.
Prerequisites
- You will need the installation package for a successful and complete migration.
- Before you start the migration, we strongly recommend creating a backup of the database.
Migration
The migration consists of the following steps:
Stop the ADONIS 14.0 application server and the Apache Tomcat web server.
Export the library-specific component settings.
Back up comments and deployment-specific configuration settings.
Install ADONIS 14.1 according to the ADONIS 14.1 Installation Manual:
a. Install the rich client for use as an application server and for using the Administration Toolkit.
b. Install the web client to host ADONIS 14.1 as a web application.
Start the ADONIS 14.1 Administration Toolkit and log in to the ADONIS database.
Update the application library:
- If you are using the ADONIS BPMS Application Library: Databases created with ADONIS 14.0 can still be used with ADONIS 14.1. However, you will not have access to improvements in the ADONIS BPMS Application Library. (Optionally) Update the library in the ADONIS database. A new version of the ADONIS BPMS Application Library can be found in the folder "04 Sample Data\Library" in the installation package.
- If you are using an ADONIS BPMS Application Library with changes in the metamodel: Databases created with ADONIS 14.0 can still be used with ADONIS 14.1. However, you will not have access to improvements in the ADONIS BPMS Application Library. (Optionally) Contact your ADONIS consultant to upgrade your application library.
- If you are using an ADONIS BPMS Application Library with functional extensions or another specific library: Please contact your ADONIS consultant to clarify if a new version of your specific library is required before you proceed. Update the library in the ADONIS NP database if you received a new library file.
(Optionally) Import the library-specific component settings if you updated the application library.
Migrate comments and deployment-specific configuration settings.
Start the ADONIS 14.1 application server and the Apache Tomcat web server. If ADONIS 14.1 is working properly, you can uninstall ADONIS 14.0.
For further information and details on the above steps, please refer to the Installation Manual and to the sections "Make a Manual Backup", "Restore a Manual Backup" and "Update Library" in the Administration Manual.
Migration from ADONIS 13.0 to ADONIS 14.1
If you upgrade from ADONIS 13.0 to ADONIS 14.1, you do not have to create a new database and import a migration package if you are using the ADONIS BPMS Application Library.
This approach is also valid if you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library. Please contact your ADONIS consultant to clarify if a new version of your application library is required before you proceed.
Prerequisites
- You will need the installation package for a successful and complete migration.
- Before you start the migration, we strongly recommend creating a backup of the database.
Migration
The migration consists of the following steps:
Stop the ADONIS 13.0 application server and the Apache Tomcat web server.
Export the library-specific component settings.
Back up comments and deployment-specific configuration settings.
Install ADONIS 14.1 according to the ADONIS 14.1 Installation Manual:
a. Install the rich client for use as an application server and for using the Administration Toolkit.
b. Install the web client to host ADONIS 14.1 as a web application.
Start the ADONIS 14.1 Administration Toolkit and log in to the ADONIS database.
Update the application library:
- If you are using the ADONIS BPMS Application Library: Databases created with ADONIS 13.0 can still be used with ADONIS 14.1. However, you will not have access to improvements in the ADONIS BPMS Application Library. (Optionally) Update the library in the ADONIS database. A new version of the ADONIS BPMS Application Library can be found in the folder "04 Sample Data\Library" in the installation package.
- If you are using an ADONIS BPMS Application Library with changes in the metamodel: Databases created with ADONIS 13.0 can still be used with ADONIS 14.1. However, you will not have access to improvements in the ADONIS BPMS Application Library. (Optionally) Contact your ADONIS consultant to upgrade your application library.
- If you are using an ADONIS BPMS Application Library with functional extensions or another specific library: Please contact your ADONIS consultant to clarify if a new version of your specific library is required before you proceed. Update the library in the ADONIS NP database if you received a new library file.
(Optionally) Import the library-specific component settings if you updated the application library.
Migrate comments and deployment-specific configuration settings.
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 14.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "14.0 - repo.js".
Start the ADONIS 14.1 application server and the Apache Tomcat web server. If ADONIS 14.1 is working properly, you can uninstall ADONIS 13.0.
For further information and details on the above steps, please refer to the Installation Manual and to the sections "Make a Manual Backup", "Restore a Manual Backup" and "Update Library" in the Administration Manual.
Migration from ADONIS 12.0 to ADONIS 14.1
A migration from ADONIS 12.0 to ADONIS 14.1 without further assistance by BOC is possible if you are using the ADONIS BPMS Application Library. You will have to create a new database and import a migration package.
If you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library, you will need a new version of your library. Please contact your ADONIS consultant to upgrade your library.
Prerequisites
- You will need the installation package for a successful and complete migration.
Migration
The migration consists of the following steps:
Stop the ADONIS 12.0 application server and the Apache Tomcat web server.
Export the library-specific component settings and a migration package.
Backup comments and deployment-specific configuration settings.
Install ADONIS 14.1 according to the ADONIS 14.1 Installation Manual:
a. Install the rich client for use as an application server and for using the Administration Toolkit.
b. Install the web client to host ADONIS 14.1 as a web application.
Create a database:
If you are using the ADONIS BPMS Application Library: A new version of the ADONIS BPMS Application Library can be found in the folder "04 Sample Data\Library" in the installation package. Initialize the new ADONIS database with this library file.
If you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library: Please contact your ADONIS consultant to upgrade your application library. Initialize the new ADONIS database with the new library file you have received from your ADONIS consultant.
Start the ADONIS 14.1 Administration Toolkit and log in to the new database.
Import the migration package and the library-specific component settings.
Migrate comments and deployment-specific configuration settings.
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 14.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "14.0 - repo.js".
Start the ADONIS 14.1 application server and the Apache Tomcat web server. If ADONIS 14.1 is working properly, you can uninstall ADONIS 12.0.
For further information and details on the above steps, please refer to the Installation Manual and to the sections "Make a Manual Backup" and "Restore a Manual Backup" in the Administration Manual.
Migration from ADONIS NP 11.0/11.1 to ADONIS 14.1
A migration from ADONIS NP 11.0/11.1 to ADONIS 14.1 without further assistance by BOC is possible if you are using the ADONIS BPMS Application Library. You will have to create a new database and import a migration package.
If you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library, you will need a new version of your library. Please contact your ADONIS consultant to upgrade your library.
Prerequisites
- You will need the installation package for a successful and complete migration.
Migration
The migration consists of the following steps:
Stop the ADONIS NP 11.0/11.1 application server and the Apache Tomcat web server.
Export the library-specific component settings and a migration package.
Backup comments and deployment-specific configuration settings.
Install ADONIS 14.1 according to the ADONIS 14.1 Installation Manual:
a. Install the rich client for use as an application server and for using the Administration Toolkit.
b. Install the web client to host ADONIS 14.1 as a web application.
Create a database:
If you are using the ADONIS BPMS Application Library: A new version of the ADONIS BPMS Application Library can be found in the folder "04 Sample Data\Library" in the installation package. Initialize the new ADONIS database with this library file.
If you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library: Please contact your ADONIS consultant to upgrade your application library. Initialize the new ADONIS database with the new library file you have received from your ADONIS consultant.
Start the ADONIS 14.1 Administration Toolkit and log in to the new database.
Import the migration package and the library-specific component settings.
Migrate comments and deployment-specific configuration settings.
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 12.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "12.0 - repo.js".
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 14.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "14.0 - repo.js".
Start the ADONIS 14.1 application server and the Apache Tomcat web server. If ADONIS 14.1 is working properly, you can uninstall ADONIS NP 11.0/11.1.
For further information and details on the above steps, please refer to the Installation Manual and to the sections "Make a Manual Backup" and "Restore a Manual Backup" in the Administration Manual.
Migration from ADONIS NP 10.0/10.1 to ADONIS 14.1
A migration from ADONIS NP 10.0/10.1 to ADONIS 14.1 without further assistance by BOC is possible if you are using the ADONIS BPMS Application Library. You will have to create a new database and import a migration package.
If you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library, you will need a new version of your library. Please contact your ADONIS consultant to upgrade your library.
Prerequisites
- You will need the installation package for a successful and complete migration.
Migration
The migration consists of the following steps:
Stop the ADONIS NP 10.0/10.1 application server and the Apache Tomcat web server.
Export the library-specific component settings and a migration package.
Backup comments and deployment-specific configuration settings.
Install ADONIS 14.1 according to the ADONIS 14.1 Installation Manual:
a. Install the rich client for use as an application server and for using the Administration Toolkit.
b. Install the web client to host ADONIS 14.1 as a web application.
Create a database:
If you are using the ADONIS BPMS Application Library: A new version of the ADONIS BPMS Application Library can be found in the folder "04 Sample Data\Library" in the installation package. Initialize the new ADONIS database with this library file.
If you are using an ADONIS BPMS Application Library with changes in the metamodel or functional extensions or another specific library: Please contact your ADONIS consultant to upgrade your application library. Initialize the new ADONIS database with the new library file you have received from your ADONIS consultant.
Start the ADONIS 14.1 Administration Toolkit and log in to the new database.
Import the migration package and the library-specific component settings.
Migrate comments and deployment-specific configuration settings.
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 11.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "11.0 - repo.js".
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 12.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "12.0 - repo.js".
Are you using the ADONIS BPMS Application Library? If yes, in the ADONIS 14.1 Administration Toolkit, execute the script 14.0 - repo.js (menu Settings -- Execute JavaScript file). The respective file can be found in the folder "05 Migration" on the installation medium. For details on this script, see Executing the Script "14.0 - repo.js".
Start the ADONIS 14.1 application server and the Apache Tomcat web server. If ADONIS 14.1 is working properly, you can uninstall ADONIS NP 10.0/10.1.
For further information and details on the above steps, please refer to the Installation Manual and to the sections "Make a Manual Backup" and "Restore a Manual Backup" in the Administration Manual.
Migration from All Other Versions to ADONIS 14.1
If you are using ADONIS NP 9.0 or earlier versions, the migration to ADONIS 14.1 requires support by BOC.
For details on the necessary steps to migrate your version of ADONIS NP to ADONIS 14.1, please contact your ADONIS consultant.
How to Install a Hotfix for ADONIS 14.1
Hotfixes resolve software errors and security issues. Please note that the most current hotfix always includes the modifications of previous hotfixes. Only the latest hotfix has to be installed to get all fixes.
If you install a hotfix for ADONIS 14.1, you do not have to create a new database and import a migration package.
Downloading a Hotfix
In the majority of cases, you are notified of hotfixes by your ADONIS consultant.
The version format of a hotfix is 14.1.x (for example: 14.1.1 or 14.1.2).
Download the hotfix from the BOC website (your ADONIS consultant will email you a link).
The installation utilizes a full, standalone release package.
Installing a Hotfix
Installing a hotfix consists of the following steps:
Stop the ADONIS 14.1 application server and the Apache Tomcat web server.
Backup comments and deployment-specific configuration settings.
Install ADONIS 14.1.x according to the ADONIS 14.1 Installation Manual:
a. Install the rich client for use as an application server and for using the Administration Toolkit.
b. Install the web client to host ADONIS 14.1.x as a web application.
Migrate comments and deployment-specific configuration settings.
Start the ADONIS 14.1.x application server and the Apache Tomcat web server. If ADONIS 14.1.x is working properly, you can uninstall ADONIS 14.1.
For further information and details on the above steps, please refer to the Installation Manual and to the sections "Make a Manual Backup" and "Restore a Manual Backup" in the Administration Manual.
Update Scripts
Executing the Script "14.0 - repo.js"
This script updates the repository. The following changes are made:
- Note and Text Annotation
Enables the option Use legacy formatting for all Notes and Text Annotations that have been migrated to ADONIS 14.1.8 or higher. This will ensure that all models containing Notes and Text Annotations will look as they did before.
Newly created Notes and Text Annotations use the new and improved formatting options in ADONIS 14.0 or higher. To also use the improved formatting options for migrated Notes and Text Annotations, Use legacy formatting needs to be turned off (in the Notebook chapter "General information").
- Relation Referenced by Products
For all Business Process Diagrams, this script converts Referenced products relations into Referenced by products relations.
Executing the Script "12.0 - repo.js"
This script updates the repository. The following changes are made:
- Relations "Responsible Person" and "Responsibility"
Converts Responsibility relations between 
Performance Indicators and 
Performers or 
Roles into Responsible Person relations.
- IT System Model Relations
Converts relations between object types from the 
IT system model ( Application, 
Application Service, 
Node and 
Application Interface).
Has, 
Uses and 
Is dependent on relations become 
Association, 
Composition, 
Realisation and
Serving relations.
Executing the Script "11.0 - repo.js"
This script updates the repository. The following changes are made:
- Relations Process customers and Process suppliers
For all Processes and Business Process Diagrams, this script converts all existing record attributes Process customers - requirements and Process suppliers - requirements into the new relations Process customers and Process suppliers.
- Relation Has Performance Indicators
This script converts all existing Owns connectors between Performance Indicator objects and other repository objects into the new Has Performance Indicator reference that is displayed in the Notebook as well.