v5.1.1-v5.2

Migration considerations from Qflow 5.1.1

Method signature change in Flow and Attachment controllers

In version 5.2 several Flow and Attachment controller signatures were changed to asynchronous calls. In this way, instead of returning a T object, a Task<T> object will be returned. Special care must be taken if custom forms were developed. All the references to these methods may need some adjustment.

The list of changed methods in the Flow controller is the following:

  • Start

  • Edit

  • DisplayTask

  • StartFlow

  • StartFlowAndGetSimpleData

  • EditFlow

  • RespondTask

The list of changed methods in the Attachment controller is the following:

  • UploadAttachment

  • AddFlowAttachment

  • Download

Unified session across sites

In version 5.2 of Qflow, sites can have a unified session, meaning that when a user logs in to Qflow Design and has permissions in Qflow Team, accessing Qflow Team goes directly to the home page without going through the login. If you want to avoid this behavior on some sites, you simply have to add two appsettings to the corresponding web.config file.

These are:

  • UseUnifiedSession: if you don’t want to use it, it must have the value ‘false’

  • OwinCookieName: this is the name of the cookie that will be used by the site, it can be assigned any value other than the unified session cookie value (QflowAuth). For example: QflowDesignerAuth, QflowTeamAuth, etc.

New system parameters

Some system parameters have been added in this version that change the behavior of Qflow. The value of each of these should be reviewed to verify that everything works correctly.

The parameters are the following:

  • QflowBPMWebLink/QflowOMMLink/QflowSAMWebLink/QflowWebSiteLink: These parameters must be adjusted to the urls used by the different Qflow tools. Without them, the navigation between sites that can be found in the right section of the headers will not work correctly.

  • NotifyUserOnCreation: If this parameter is True, Qflow will send a welcome message to the mail box of the created user.

  • UserWelcomeLink: It is the link that is sent to new users if the NotifyUserOnCreation parameter is enabled. If you want to use it, it must be adjusted to the url of the desired site. It is recommended to use the Qflow Access url.

  • Logo/LogoLightVersion/TaskMiniLogo/TaskLogo: Different parameters corresponding to the tools logos have been added. Now the ‘Logo’ parameter corresponds to the Qflow logo and will be shown in the login of each tool, as well as in the upper left part of Qflow Access. If you want to change the Qflow Task logo, now you must change the TaskLogo parameter.