Chapter 2. Migrating business processes to the new process designer


The legacy process designer in Business Central is deprecated in Red Hat Process Automation Manager 7.8.0. It will be removed in a future Red Hat Process Automation Manager release. The legacy process designer will not receive any new enhancements or features. If you intend to use the new process designer, start migrating your processes to the new designer. Create all new processes in the new process designer.

Note

The process engine will continue to support the execution and deployment of business processes generated with the legacy designer in to the KIE Server. If you have a legacy business process that is functioning and that you do not intend to change, it is not mandatory to migrate to the new designer at this time.

You can only migrate business processes that contain supported business process nodes in the new designer. More nodes will be added in future versions of Red Hat Process Automation Manager.

Note

To enable or disable the legacy process designer in Business Central, in the upper-right corner of the window click Settings Roles, select a role from the left panel, click Editors Select Editor (Legacy) Process Designer Read, and then click Save to save the changes.

Prerequisites

  • You have an existing project that contains a business process asset that was created with the legacy process designer.

Procedure

  1. In Business Central, click Menu Design Projects.
  2. Click the project you want to migrate, for example Mortgage_Process.
  3. Click Ok to open the project’s asset list.
  4. Click the project’s Business Process asset to open it in the legacy process designer.
  5. Click Migrate Migrate Diagram.

    Figure 2.1. Migration confirmation message

    Migration confirmation message
  6. Select Yes or No to confirm if you made changes. This option is only available if you have made changes to your legacy business process.

    Figure 2.2. Save diagram changes confirmation

    Save diagram changes confirmation

If the migration is successful, the business process opens in the new process designer and the business process name’s extension changes from *.bpmn2 to *.bpmn.

If the migration is unsuccessful due to an unsupported node type, Business Central displays the following error message:

Figure 2.3. Migration failure message

Migration failure message
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.