Workflow Management 2019

Workflow Management 2019 Release Notes

This document provides information about important features, resolved issues, and known issues for Workflow Management 2019. The product and the documentation are subject to change without notice.

In This Document

Installation Instructions

Upgrading to Workflow Management 2019

ISO Details

System Requirements

Product Compatibility

Key Features

General Enhancements

Improvements and Issues Resolved

Deprecations

Other Information

Installation Instructions

You can use the Workflow Management 2019 installer to install the Workflow Management 2019 product.

Before installing Workflow Management 2019, the installer installs the following prerequisites:

Microsoft .NET Framework 4.7.1
Microsoft .Net Core 2.2.1 - Windows Server Hosting
Microsoft SQL Server System CLR Types for SQL Server 2014
Microsoft Report Viewer Redistributable 2015
Microsoft SQL Server System CLR Types for SQL Server 2016
Microsoft SQL Server 2016 Management Objects
Common Licensing API Framework 3.5.1
Platform Common Services 4.3.3

Note:
- Ensure to install Workflow Management License version 6.0 or later.
- If you are planning to install any application on the same machine that installs earlier version of the above prerequisites, then ensure to install that application before installing Workflow Management 2019.

Installing Workflow Management 2019

Run Workflow Management 2019.exe on a 64-bit computer to install Workflow Management 2019.

For detailed installation instructions, see Installing Workflow Management section in the Administrator Guide.

Installing Workflow Management 2019 Connector for System Platform

Run Workflow Management 2019 Connector for System Platform.exe on a 64-bit computer to install Workflow Management 2019 Connector for System Platform.

For detailed installation instructions, see Workflow Management Connectors and Extensions Guide > Installation Guide > Workflow Management Connector for System Platform.

Installing Workflow Management 2019 Extension for System Platform

Run Workflow Management 2019 Extension for System Platform.exe on a 64-bit computer to install Workflow Management 2019 Extension for System Platform

For detailed installation instructions, see Workflow Management Connectors and Extensions Guide > Installation Guide > Workflow Management Extension for System Platform.

Installing Workflow Management 2019 Extension for OPC UA

Run Workflow Management 2019 Extension for OPC UA.exe on a 64-bit computer to install Workflow Management 2019 Extension for OPC UA.

For detailed installation instructions, see Workflow Management Connectors and Extensions Guide > Installation Guide > Workflow Management Extension for OPC UA.

Installing Workflow Management 2019 Add-in for Microsoft Office Outlook

Run Workflow Management 2019-Outlook Add-ins.exe on the 64-bit computer to install Workflow Management 2019 Add-in for Microsoft Office Outlook.

Note: The Workflow Management 2019 Add-in for Microsoft Office Outlook is supported only for Microsoft Office 2010, 2013, and 2016. Based on the installed version of Microsoft Office, the respective Add-in components will be installed on the system.

For detailed installation instructions, see Workflow Management Administrator Guide > Installing Workflow Management > Installing Workflow Management Add-in for Microsoft Outlook.

Upgrading to Workflow Management 2019

Upgrading Scenarios

You can upgrade to Workflow Management 2019 from any of the following version:
- Wonderware Skelta BPM 2017 R2
- Wonderware Skelta BPM 2017 R2 U1
- Wonderware Skelta BPM 2017 R2 U2

Upgrading to Workflow Management 2019

The upgrade will internally remove all the old files. Ensure to back up all the files you require before the upgrade.

While upgrading Wonderware Skelta BPM Websites, the existing files in all the Enterprise Console site folders are overwritten with the latest files. However, before overwriting, the installer takes a backup of the Actions.xml and SharePointActions.xml files, and the files are saved with .bak extension in the same folder. The Actions.xml and SharePointActions.xml files are available in the following path of Wonderware Skelta BPM installation:

..\WorkflowElements\Default\en-US\Actions\XML

We recommend you to back up the existing files and folders of the previous installation.

If the Workflow Management Farm is configured, then the CentralConfig.xml file is retained in the old Wonderware Skelta BPM install folder with a .bak suffix. All files and folders in the following folders of Wonderware Skelta BPM will be moved to the BPM2017_Backup folder under the old Wonderware Skelta BPM install folder.

Locales
Web
WorkflowElements

If you have customized any page in these folders, compare the pages with the existing pages, and then merge the changes. You must not replace the pages.

Note:
- While upgrading to Workflow Management 2019, if the installer finds unsupported Forms 2011 versions, the setup exits even before installing the prerequisites.

- Before running the Workflow Management 2019 installer, run the Workflow Management 2019 Forms 2011 Removal Tool.exe to remove unsupported Forms 2011 from all repositories.

- Ensure to copy the Workflow Management 2019 Forms 2011 Removal Tool.exe in <Workflow Management 2019 install path>\Bin and then run the tool. The tool is available in the Workflow Management 2019 - Forms 2011 Removal Tool folder after you extract the ISO file of Workflow Management 2019.

- Before running the tool, make sure the database connectivity is available for the existing DataSources, otherwise the tool will not launch.

- When Forms 2011 is used in Invoke Form Activity or is associated with a workflow, and if Forms 2011 is removed, then the existing workflow instances will give the message "Form not found".

- When a workflow has Invoke Form Activity with Forms 2011and if Forms 2011 is removed, edit the workflow to select the new form in Invoke Form Activity and then execute the workflow.

When you upgrade to Workflow Management 2019, the installer executable file internally uninstalls the previous product installation. The default location to install Workflow Management 2019 files is C:\Program Files\Wonderware\Workflow Management. If the previous version of Wonderware Skelta BPM is installed in a custom path, then the Workflow Management 2019 will be installed on the same custom path.

Note: While upgrading to Workflow Management 2019 from the earlier versions, the installer gives an alert message, "The installation process slows down when the installer backs up the Locales, Web, and WorkflowElements folders. Do you want the installer to take the backup?"

- If you select Yes, the installer takes the backup and the installation process slows down.
- If you select No, the installation process proceeds without taking the backup.
- If no action is performed, the installer will wait for 20 seconds and the installation process proceeds without taking the backup.

Steps to Upgrade

Extract the ISO file of Workflow Management 2019.
Copy Workflow Management 2019 executable and "ISSetupPrerequisites" folder from the Workflow Management 2019 folder.
Run Workflow Management 2019.exe on a 64-bit computer to upgrade to Workflow Management 2019.
1. If unsupported Forms 2011 versions are found, the installer exits. Before you run the installer again,
  - Copy the Workflow Management 2019 Forms 2011 Removal Tool.exe in <Workflow Management 2019 install path>\Bin. The tool is available in the Workflow Management 2019 - Forms 2011 Removal Tool folder after you extract the ISO file of Workflow Management 2019.
  - Run the tool to remove the unsupported Forms 2011 versions.
2. If unsupported Forms 2011 versions are not found,
  An alert message "The installation process slows down when the installer backs up the Locales, Web, and WorkflowElements folders. Do you want the installer to take the backup?" appears.
Click Yes if you want the installer to take the backup. Click No if you do not want the installer to take the backup.
The installer splash screen, and then the Related product found dialog box appears.
Click Next.
The Ready to Install the Program dialog box appears.
Click Install to begin the installation.
On the InstallShield Wizard Completed dialog box, click Finish.
Upgrade Manager automatically performs the following tasks:
- Stops the services and Application Pools.
- Deletes the SkeltaBPMTemp and BPM Cache files from the computer.
The Upgrade Manager Wizard appears after the above tasks are completed. For the steps to run the upgrade manager, see Running the Upgrade Manager.

Notes:
- Perform the above tasks manually, if the Upgrade Manager fails to automatically complete any of these tasks. After the upgrade is successfully completed, the Workflow Management services and Application Pools will start automatically. Ensure the user has Administrative privilege and the rights to delete files from the temporary folders.

- If the images do not appear properly in the upgraded Enterprise Console menu, ensure to update the images from the Navigation Details list.

a. Point to admin, and then click Repository Settings. The Repository Settings page appears.

b. Go to Advanced Settings, click Manage Navigation List. The Manage List appears.

c. Edit the ImageName in the NavigationLink Details window of the required Navigation Link item.

- In an IPV6 enabled environment upgrade, set the IPV6 multi-cast IP to enable Enterprise Server functionality.

ISO Details

The following folders are created after you extract the ISO file of Workflow Management 2019:

Release Folder

AVEVA Enterprise Licensing:
- Installer for AVEVA License Server
- Installer for AVEVA Enterprise License Manager
- Documentation for AVEVA Licensing
Workflow Management 2019:
- Installer for Workflow Management 2019 (includes installers for prerequisites)
- Installer for Workflow Management 2019 Add-in for Microsoft Office Outlook
- Installer for Workflow Management 2019 Extension for System Platform
- Installer for Workflow Management 2019 Extension for OPC UA
Workflow Management 2019 – Connectors: Installation executables for Workflow Management 2019 Connectors, such as Workflow Management 2019 Connector for System Platform
Workflow Management 2019 – Documentation
Installer for Workflow Management 2019 documentation which includes:
- Administrator Guide
- Developer Guide
- User Guide
- Forms and Lists User Guide
- Connectors and Extensions Guide
- Quickflow Guide
- API Scenarios Guide
- API Reference Guide
- Release Notes
Workflow Management 2019 - Forms 2011 Removal Tool: Tool for removing Forms 2011 before upgrading the product to Workflow Management 2019.
Workflow Management 2019 - Release Notes.htm: Release notes for the Workflow Management 2019 release.

System Requirements

The hardware and software requirements to install Workflow Management 2019 are as follows:

Hardware Requirements
Software Requirements
- Operating System Requirements
- Database Requirements
- Browser Requirements
Other Requirements

Hardware Requirements

Component	Requirement
Processor	Minimum: 1.4 GHz (x64 processor) Recommended: 2 GHz or faster, multi-core processor
Memory	Minimum: 4 GB RAM 64 GB (Enterprise) Maximum (64-bit systems): 2 TB (Enterprise) For Microsoft SharePoint Environment, Minimum: 8 GB RAM
Hard Disk	Minimum: 10 GB of available hard disk space Recommended: 100 GB or more of available hard disk space
Optical Drive	DVD-ROM drive (optional)
Display and Peripherals	SVGA (1366 x 768) to WXGA+ (1440x900) resolution monitor Keyboard Microsoft Mouse or compatible pointing device

Software Requirements

Operating System Requirements

Workflow Management runs on the following Windows operating system versions. We recommend applying all the critical updates pertaining to the version of the server.


Software Requirements Matrix	Windows				Windows Server
	10 Anniversary Edition Update (Version 1607)	10 Creators Update (Version 1703)	10 Fall Creators Update (Version 1709)	10 Windows Update (Version 1809)	2008 R2 SP1	2012	2012 R2*	2016	2019
					Standard or Enterprise	Standard or Data Center
	64-bit only
Workflow Management 2019	Y	Y	Y	Y	Y	Y	Y	Y	Y
Workflow Management 2019 Extension for System Platform	Y	Y	Y	Y	Y	Y	Y	Y	N
Workflow Management 2019 Connector for System Platform	Y	Y	Y	Y	Y	Y	Y	Y	N
Workflow Management 2019 Extension for OPC UA	Y	Y	Y	Y	Y	Y	Y	Y	N

* KB 2919355 is a prerequisite for Windows Server 2012 R2.

Database Requirements

Software
Requirements
Matrix

SQL
Server
2012

SQL
Server
2014

SQL
Server
2016

SQL
Server
2017

SP1

SP2

SP3

SP4

CU 14
(KB3158271)

SP1

SP2 CU 17
(KB4491540)

CU 9
(KB4058559)

SP1

SP2 CU 6
(KB4488536)

CU 14
(KB4484710)

Express
(SSME)

Standard or Enterprise

64-bit only

Workflow Management 2019

S

Y

Workflow Management 2019
Extension for
System
Platform

S

Y

Workflow Management 2019
Connector for
System
Platform

S

Y

Workflow Management 2019
Extension for
OPC UA

S

Y

Note:
The recommended collation for the databases is:
SQL_Latin1_General_CP1_CI_AS

The Farm and Repository databases support case sensitive collation:
SQL_Latin1_General_CP1_CS_AS

Browser Requirements

Software Requirements Matrix	Microsoft Internet Explorer	Microsoft Edge	Mozilla Firefox Quantum	Google Chrome	Apple Safari for Mac
Software Requirements Matrix	11.726.16299.0 11.0.90 (KB4462949)	42.17134.1.0 (EdgeHTML 17.17134)	66.0.5	73.0.3683.103	12.1
Workflow Management 2019	Y	Y	Y	Y	L
Workflow Management 2019 Extension for System Platform	Y	N	N	N	N
Workflow Management 2019 Connector for System Platform	Y	N	N	N	N
Workflow Management 2019 Extension for OPC UA	Y	N	N	N	N

Legends:

Small Configuration Only (Supports a maximum of five users and 20 active workflow instances.)	S
Supported	Y
Limited Support Only Inbox and Forms in Apple Safari for Mac	L
Not Supported	N

Other Requirements

Component	Requirement
Internet Information Services (IIS)	The appropriate version must be installed and configured.
Languages Supported for Workflow Management 2019	US English Chinese (Simplified) French German Japanese Portuguese (Brazilian)
Supported Operating Systems for Work Tasks Pro	iOS iOS 11.0 to iOS 12.x Android Marshmallow Nougat Oreo Pie
Languages Supported for Work Tasks Pro	US English Chinese (Simplified) French German Hindi Italian Korean Portuguese (Brazilian) Spanish

Product Compatibility

Workflow Management 2019 with SQL Server is compatible with the following virtualization environments:
- VMware ESXi 5.0: Virtualization with High Availability and Disaster Recovery
- VMware vSphere 5
Workflow Management 2019 is compatible with SQL Server AlwaysOn Availability Groups for SQL Server 2012 and SQL Server 2016.

Workflow Management 2019 is compatible and can coexist with the following connectors and extensions:

Connectors and Extensions	Compatibility	Coexistence	Can be Applied on
Workflow Management 2019 Add-in for Microsoft Office Outlook	Y	Y	Microsoft Office Outlook 2010 (64-bit) Microsoft Office Outlook 2013 (64-bit) Microsoft Office Outlook 2016 (64-bit)
Workflow Management 2019 Extension for OPC UA	Y	Y	Workflow Management 2019 (64-bit)

Workflow Management 2019 Connectors for System Platform is compatible and can coexist with the following products:

Product	Version	Compatibility	Coexistence
Application Server	2017 Update 3 2017 Update 2 2017 Update 1	Y	Y
InTouch HMI	2017 Update 3 2017 Update 2 2017 Update 1	Y	Y
InTouch OMI	2017 Update 3 2017 Update 2 2017 Update 1	Y	Y
InBatch Server	2017 Update 1 2017 2014 R3 SP1	Y	Y
Recipe Manager Plus	2017 Update 2 2017 SP1 2017	Y*	Y

*For single sign-on to work, ensure the casing of AIM URL in web.config of Recipe Manager Plus matches that of the discovery document exposed by AIM.

Key Features

Workflow Management 2019 offers several features and activities that help business users to create simple and process driven composite applications rapidly.

Quickflow - Transient and efficient workflow engine which uses fewer resources with a portable processing engine
Two-way communication support for AMQP based Message Brokers
Support for passing contextual information in Forms using the Navigation App from InTouch OMI
Support for Read-Only Domain Controller (RODC)
Support for Queue in Work Tasks Pro app

Forms

User interface and user experience are the most important aspects of business applications. Forms help you to create complex user interfaces with responsive design, adaptive layout, and cross-browser compatibility. Forms integrate with lists and workflows to enable rapid deployment of business applications.

Workflow Management 2019 comes with the following new features, enhancements, and changes:

Enhancements and New Features

Support for configuring Data Type and JSON Path in MQTT Topic Configuration.
Handwritten Signature control
Action Bar Item and Invoke Workflow control's XML Schema configuration can also be mapped to controls inside the Embed From.
Enhanced search behavior on parameters for controls like Report Viewer, Data Grid, Data Lookup, etc.
Upgraded third party control frameworks to the following versions:
- codemirror - 5.44.0
- jshint - 2.10.2
- jsonpath - 1.0.0
- jszip - 3.1.5
- kendo UI - 2019.1.220
- pako deflate - 1.0.10

Work Tasks Pro App

Business professionals need to know the status of critical processes and make quick decisions on the go. Work Tasks Pro is a premium mobile application for Workflow Management that allows authenticated users to securely access and act upon work items from their mobile phones or tablet devices.

Workflow Management 2019 comes with the following new features, enhancements, and changes.

Enhancements and New Features

Support for Queue when the app has connectivity to the server
Improved layout for work items
Auto refresh of work items
Swipe actions for acting on work items
Group work items based on the value of work item field
Sort work items based on priority
Improved usability for Attachment control based on app permissions (in Android)

Quickflow

Quickflow helps you to create a system that executes the business logic faster using "micro workflow execution engines" running parallel to the workflow engine.

Workflow Management 2019 comes with the following features.

Features

Design and execute non-transient workflows
Associate Quickflow with various event providers like Forms, LogicApp, FileWatcher, Scheduler, and RabbitMQ
Enable the activity status persistence
Integrate with ArchestrA Identity Manager (AIM)

General Enhancements

This section lists the other enhancements for Workflow Management 2019 release.

Support for Read-Only Domain Controller (RODC)
Support for XML and JSON based messages in the Message Broker
Option to send and receive messages from the Message Broker
Package support for
- Logic App artifacts
- Message Queue artifacts
- Forms with MQTT
- Quickflow
Work Item priority to have numeric values between 0-99
List infrastructure to support Breadcrumb based navigation
Support for Web APIs with TLS 1.0 and 1.1
Maximum limit for Auto Log Off Settings increased to 360 minutes

Improvements and Issues Resolved

The following are the improvements and important issues resolved in the Workflow Management 2019 release:

Continuous Improvements

The Invoke Web API Activity does not work for the POST methods.
Web API for impersonated user does not work with POST operations.
The Device ID API does not work for Work Tasks Pro app.
When using a template with more fields for Create-Open-Office-Document Activity in the workflow, the xml variable node selection window moves out of the screen.
Giving less height to Grid does not show the vertical scroll in case the page size is more.
Multiple logger messages “Unable to fetch the properties. There are no mapping fields set for the provider” logged when the primary provider does not have proper mapping.
The Pop-Up form does not get displayed when clicked on Pop-Up control present in the Embed Form, which is the part of a form containing a Panel Form.
The Report Viewer control does not show an option for exporting the report to an excel format.

Issues Resolved

The "File not found" error appears while executing SOA methods for the Update Variable Activity.
Accessing Enterprise Console site configured with anonymous authentication requires user credentials.
Child workflows fails to update Parent status due to syntax error.
The error message appears when editing a Control in an unpublished version of form where the Control is not part of the published version of the form.
The column "Created on" of Workflow version history grid shows last updated date instead of created date.
System hangs when web service registered in SOA are unavailable or inaccessible.
Deprecated Grid view menu option appears on upgrading from Skelta BPM 2014 R2 version of the product.
When a Tabs container has many tabs and the Default Tab Index property is set to a value other than 0, then when opening the Form in design mode, the Tab contents for the selected Tab index in the UI are not visible.
Consider a Form with Data Grid Control with the Extended Information as True and a few rows selected. When the grid controls value is set to empty via script, the Extended Information of the grid is not an empty array.
Long table names are not fully visible in Select Table textbox in List creation page.
Web APIs with TLS 1.0 and 1.1 are not working.

Deprecations

The following features have been deprecated:

Support for Workflow Management installation on 32-bit operating system
Support for Forms 2011
Support for Work Tasks Pro on Universal Windows Platform (UWP)

Other Information

This section contains important information about the known issues and limitations for Workflow Management 2019.

Documentation

Technical documentation for Workflow Management is best viewed in Microsoft Edge or Mozilla Firefox browsers.

Known Issues

You might come across the following issues when you work with Workflow Management 2019:

Entering or editing values in Rich Text control is not supported in Mozilla Firefox browser.
Adding records in Base Form is not supported for Chart, Slider and Hierarchical List controls.
When Quickflow application is integrated with Workflow Management, the enabling and disabling persistence of exceptions and warnings into the database needs restart of the Quickflow Status Monitor service to apply the changes.
The list associated to Form 2011 does not work after upgrade. The form needs to be regenerated.
Workflow Management Connector for Microsoft Sharepoint is not part of this release.

Workflow Management 2019