Remote Approval is now an integrated feature in WorkflowGen, and is no longer a separate module.
For instructions on configuring Remote Approval, see the Remote Approval section in the WorkflowGen Administration Guide.
If you have the former Remote Approval module configured, you can keep using it, but if you want to migrate to the new integrated feature, you must perform the following steps.
Uninstall the Remote Approval module (it's recommended that you make a backup of all previous Remote Approval files and folders beforehand):
Open the Windows Services list and stop the Remote Approval service, usually named WorkflowGen RemoteApproval or WorkflowGen EmailListener.
Delete the DRIVE:\Program Files (x86)\Advantys\WorkflowGen\RemApp\ folder.
In \wfgen\App_Data\CustomMenus\admin.xml, remove the Remote Approval menuItem node (you can delete the file entirely if it contains only this node).
Check Activate on the Remote Approval tab in the Administration Module Configuration panel.
Verify your Remote Approval settings, which should be the same as in the former module, since they're inherited with the WorkflowGen upgrade.
Remote Approval no longer requires WorkflowGen application-specific credentials, since it now uses the WorkflowGen Engine service.
The following workflow applications have been integrated as built-in or assembly applications. The corresponding web applications can be disabled and removed in IIS and file system folders since they're no longer used.
EFORMASPX: \wfgen\WfApps\WebApps\EFormASPX
GETUSERSFROMDIR: \wfgen\WfApps\WebServices\GetUsersFromDir
RAISEEXCEPTION: \wfgen\WfApps\WebServices\RaiseException
To create a clean WorkflowGen database, you must use the full WorkflowGen manual installation pack, which is available at .
\wfgen\bin\RemoteApprovalConfig.dll and \wfgen\admin\RemoteApprovalConfig.aspx files.Optional: Remove the following web.config settings, which are no longer used as of WorkflowGen 7.3.0 (you should make a backup of the existing web.config file beforehand):
RemoteApprovalWorkflowGenAppDomain RemoteApprovalEmailListenerServiceName RemoteApprovalWorkflowGenAppUsername RemoteApprovalWorkflowGenAppPassword
Optional: Test Remote Approval with an existing process for which Remote Approval was configured using the former module. You can also use the Remote Approval sample process available on the WorkflowGen Forum & Knowledge Base.
XMLTODATABASE: \wfgen\WfApps\WebServices\XmlToDatabase
XMLTRANS: \wfgen\WfApps\WebServices\XmlTrans
It's important to clear your browser cache before connecting to the upgraded WorkflowGen website. This will remove the CSS, JavaScript, and image files used in previous versions of WorkflowGen.
Use the following URLs with the wfgen_admin user account:
User Portal: http://[yoursite]/wfgen
Administration Module: http://[yoursite]/wfgen/admin
You must be administrator of the web server. You must know:
The physical path on the web server where WorkflowGen web application is installed.
The physical path on the web server where WorkflowGen Windows Services are installed.
The URL of the web server where WorkflowGen is installed.
MS SQL Server database:
The name of the MS SQL server.
The credentials of the SA account.
The file path of the SQL server database files on the SQL server machine.
You'll need to perform the following actions:
Update the web application files.
Update the Windows Services files.
Update the web configuration file.
Update the Directory Synchronization and Engine Service files, and move the XMLTODATABASE transaction file.
If you're upgrading from WorkflowGen version 5, you must request a new license (trial, unlimited, or per user) and a new serial number for each of your WorkflowGen servers.
The new license file must be copied to the \wfgen\bin folder.
Define the new serial number in the \wfgen\web.config file (e.g. <add key="ApplicationSerialNumber" value="WFG-ENT-XXXXX-XXXXX-XXXX-XXXX" />).
Be sure to back up your previous license file and serial number.
Update the database structure and contents.
This upgrade guide covers all of the procedures involved in upgrading WorkflowGen to version 9.2.5. It's aimed at system administrators who'll be updating the existing application.
Apply the changes to the web configuration file based on the version from which you're upgrading. Once you've applied these changes, return to the Update configuration files section in the main upgrade section and continue with the changes there.
When upgrading from version 6.5.0, apply the changes in the When upgrading from version 6.5.0 section to the When upgrading from all 7.x.x versions and earlier section.
When upgrading from version 7.22.1, apply the changes in the When upgrading from all 7.x.x versions and earlier section only.
You must remove the xmlns attribute from the web configuration file regardless of the version from which you're upgrading. See for instructions on how to do this.
Check the following parameters in your \wfgen\web.config and add them if they aren't already there.
WorkflowGen.My and WorkflowGen.My.Web.UI.WebControls (WorkflowFileUpload) version 3.0 or later are required in all your Visual Studio Web Forms if the ApplicationSecurityEnableWebAppsSecureMode security feature is enabled. For more information, see the WorkflowGen Knowledge Base article.
Remove the following deprecated parameters from <appSettings>:
Define the following nodes in <configuration>:
Define or update the following node in <configuration>/<system.web>:
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings>:
Add or modify the AdministrationFormDataProviderName parameter as follows:
Add the following new parameters to <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings> to configure the SENDHTTPPOST workflow application log file, replacing the value n with 0 to disable logging, 1 for simple logs, or 2 for debug logs:
Remove the following deprecated parameters from <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameters to <appSettings>:
If you're using folders for GraphQL and/or incoming webhooks file operations (such as sending a file action parameter), you must update the values of the GraphqlInputFileAllowedFolders and HooksInputFileAllowedFolders parameters. See the and sections in the for more information.
Add the following new parameter to <appSettings>:
Add the following new parameters to <appSettings>:
If you're using HTTP URLs for GraphQL and/or incoming webhooks file operations (such as sending a file action parameter), you must update the values of the GraphqlInputFileAllowedHttpUrls and HooksInputFileAllowedHttpUrls parameters. See the and sections in the for more information.
Remove the following deprecated parameters from <appSettings>:
Add the following nodes after the existing <location> nodes in \wfgen\web.config:
Remove the node below from \wfgen\auth\web.config, \wfgen\hooks\web.config, and \wfgen\scim\web.config, if present:
Add the following new parameter to <appSettings>:
As of version 7.15.5, the optional BACKURL_SUBMIT and BACKURL_CANCEL HTTP parameters used in custom WorkflowGen URLs (for example, ) ONLY support absolute URLs (starting with http:// or https://), relative URLs (starting with /), or URLs defined in the PortalRedirectAllowedHttpUrls configuration parameter (e.g. value='blank.htm, myPage.htm').
Add the following node after the existing <location> nodes in \wfgen\web.config:
Change the default value of RestApiClientRequestTimeout from 3000 to 30000 milliseconds.
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings>:
Add the following new parameter to <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings>:
As of WorkflowGen 7.22.0, the log level values for the existing GETUSERSFROMDIR, MERGEFORM, SENDHTTPPOST, and RESTAPICLIENT workflow applications have changed to 0 for no logs (default), 2 for information, and 3 for debugging. You can set (or reset) the log levels by updating the values of the following parameters accordingly:
Remove the existing Access-Control-Allow-* custom header nodes from location path="graphql" (as shown below), since they are deprecated as of version 7.22.1:
If you want to configure CORS to allow GraphQL API access from a third-party application, you must now follow the instructions in the section in the .
Add the following new parameters to <appSettings>:
Remove the following parameters from <appSettings>:
Add the following to the <configuration> node:
Run the SQL scripts listed below in order, starting with your current version of WorkflowGen, then continue running the scripts in the section in the main upgrade chapter.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-2-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-3-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-4-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-1.sqldatabase update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-2.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-5-5.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-2.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-3.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-6-4.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-7-1.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V5-7-2.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-0-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-1-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-1-3.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-1-4.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-2-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-5-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V6-6-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-0-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-1-1.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-2-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-3-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-6-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-10-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-11-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-12-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-13-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-14-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-15-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-15-2.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-16-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-17-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V7-22-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V8-0-0.sql database update script in your SQL Server Management Studio tool.
A new configuration parameter is required when upgrading from version 5.1.5 and earlier. This parameter allows you to provide a unique service name to the WorkflowGen Directory Synchronization service should you have multiple instances of WorkflowGen installed on a single server.
Add the following parameter to DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config:
A new configuration parameter is required when upgrading from version 5.1.5 or earlier. This parameter allows you to provide a unique service name to the WorkflowGen Engine service should you have multiple instances of WorkflowGen installed on a single server.
Add the following parameter to DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config:
If you're upgrading from version 5.7.4 or earlier, copy the Transactions.xml file from \wfgen\WfApps\WebServices\XmlToDatabase\App_Data to \wfgen\App_Data\Files\XmlToDatabase.
web.config file (located in \wfgen\graphql, \wfgen\hooks, \wfgen\scim, and \wfgen\auth):Change the iisnode handler path from server.js to dist/server.js.
Change the rewrite rule url property from server.js to dist/server.js.
It should look as follows:
Add targetFramework="4.8" to the three web apps' httpRuntime nodes:
Add the following to the <configuration> node in \Inetpub\wwwroot\wfgen\ws\web.config:
Add the following to <configuration> node in \Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config:
Add the following to the <configuration> node in \Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config:
<location path="." inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.8" />
</system.web>
</location>
<location path="wfapps/webforms" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.8" />
<pages clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</location>
<location path="ws" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.8" />
</system.web>
</location><runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime><system.diagnostics configSource="WfgDirectoriesSyncService.exe.trace.config" /><system.diagnostics configSource="WfgWorkflowEngineService.exe.trace.config" />
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime><add key="EngineEnableSelfServiceDataAssignException" value="N" />
<add key="EngineNotificationDefaultReplyTo" value="" />
<add key="EngineNotificationMaxFileAttSize" value="10" />
<add key="EngineNotificationTextDetection" value="Y" />
<add key="EngineNotificationServerTimeout" value="3" />
<add key="ApplicationDistributedDatabaseSourceMode" value="0" />
<add key="ApplicationEnableDistributedDatabaseSource" value="N" />
<add key="ApplicationEnableArchiveSiteRedirectConfirmation" value="Y" />
<add key="ApplicationArchiveSiteUrl" value="" />
<add key="ApplicationShowAssociatedDataWithEmptyValue" value="Y" />
<add key="ApplicationSecurityEnableWebAppsSecureMode" value="N" /><add key="PortalEnableComments" value="Y" />
<add key="PortalCommentsRefreshFrequency" value="30000" />
<add key="PortalCommentsPopUpWidth" value="376" />
<add key="PortalCommentsPopUpHeight" value="545" />
<add key="PortalCommentsSortBy" value="DATE_POST" />
<add key="PortalCommentsSortOrder" value="ASC" />
<add key="PortalCommentsExpandView" value="N" />
<add key="PortalCommentsListSize" value="25" />
<add key="PortalDisplayCodeNames" value="N" />
<add key="PortalMaxListSize" value="1000" />
<add key="PortalQuickViewEnabled" value="Y" />
<add key="PortalQuickViewDataName" value="FORM_ARCHIVE" />
<add key="PortalQuickViewDisplayOnMouseEvent" value="CLICK" />
<add key="PortalTextDetection" value="Y" />
<add key="PortalActivityCompleteInBackground" value="N" />
<add key="PortalEnableSearchResultAutoRedirect" value="Y" />
<add key="PortalCommonProcessDataNameList" value="" />
<add key="PortalReportEnableCustomColumns" value="Y" />
<add key="PortalReportAllowUserToCreateCustomColumns" value="Y" />
<add key="ReportsTextDetection" value="Y" />
<add key="AdministrationFormDataProviderName" value="System.Data.SqlClient, System.Data.OleDb, System.Data.Odbc, System.Data.OracleClient" />
<add key="AdministrationEnableDeletionRulesCheck" value="Y" />
<add key="AdministrationRestrictManagerToModifyGlobalParticipant" value="N" />
<add key="AdministrationFormDesignUndoLimit" value="30" />
<add key="DirectorySynchronizationMaxUserDeletionCount" value="0" />
<add key="DirectorySynchronizationSyncGroupMembersUsedInParticipantOnly" value="N" />
<add key="PortalFrameSetHeight" value="0,68,*,0" /><add key="PortalEnableCallingCard" value="Y" />
<add key="PortalReportAdvancedViewDefault" value="Y" />
<add key="PortalReportEnableCustomCharts" value="Y" />
<add key="PortalReportEnableQuickMassApproval" value="N" />
<add key="PortalReportAllowUserToCreateCustomCharts" value="Y" />
<add key="PortalDefaultWorkflowGraphicalMode" value="HTML5" />
<add key="ProcessesRuntimeWebServiceAllowedUsers" value="wfgen_admin" /><add key="EFormAspxPreviousFilesCleanUp" value="Y" /><add key="GetUsersFromDirMaxResultNb" value="100" /><add key="XmlToDatabaseTestMode" value="N" />
<add key="XmlToDatabaseEnableTrace" value="N" /><add key="XmlTransPreviousFilesCleanUp" value="Y" />
<add key="XmlTransEnableTrace" value="N" />PortalFollowUpRelevantDataListNumber
PortalPopupRelevantDataListNumber
PortalEnableRequestDataListPopUp<location path="." inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" />
</system.web>
</location>
<location path="wfapps/webforms" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" />
<pages clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</location>
<location path="ws" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" />
</system.web>
</location><pages validateRequest="false" enableSessionState="false" /><add key="AdministrationDefaultWorkflowGraphicalMode" value="HTML5" />
<add key="EngineNotificationLogLevel" value="1" />
<add key="RemoteApprovalLogTraceLevel" value="3" />
<add key="RemoteApprovalMailServerSecurity" value="none" />
<add key="RemoteApprovalRefreshInterval" value="180000" />
<add key="RemoteApprovalMailServerType" value="POP" />
<add key="RemoteApprovalLifeSpan" value="0" />
<add key="RemoteApprovalMailServerPort" value="110" />
<add key="ApplicationSecurityPasswordManagementMode" value="V5" />
<add key="ApplicationSecurityMaxLoginAttempts" value="5" />
<add key="ApplicationSecurityMinimumPasswordLength" value="8" />
<add key="ApplicationSmtpPickupDirectory" value="DRIVE:\inetpub\mailroot\Pickup" /><add key="ApplicationSmtpServerTimeout" value="3000" />
<add key="ApplicationSmtpDeliveryMethod" value="SmtpServer" /><add key="AdministrationAssociatedActivitiesToSwimlane" value="Y" /><add key="AdministrationFormDataProviderName" value="System.Data.SqlClient,System.Data.OleDb,System.Data.Odbc,System.Data.OracleClient,Oracle.DataAccess.Client" /><add key="ApplicationWebFormsPath" value="" />
<add key="EngineNotificationDefaultSenderName" value="" />
<add key="PortalDashboardAutoRefreshInterval" value="0" />
<add key="PortalActivityOnCompleteRedirectToView" value="N" /><add key="SendMessageProvider" value="TWILIO" />
<add key="SendMessageAccountSID" value="" />
<add key="SendMessageAuthToken" value="" />
<add key="SendMessageFrom" value="" />
<add key="SendMessageApiUrl" value="https://api.twilio.com/2010-04-01/Accounts/" />
<add key="SendMessageEnableLogs" value="Y" /><add key="SendHttpPostLogLevel" value="n" />ApplicationImpersonificationUsername
ApplicationImpersonificationPassword
PortalDefaultWorkflowGraphicalMode
ApplicationEnableFlashDetection<add key="GraphqlQueryTimeout" value="90000" />
<add key="GraphqlOperationTimeout" value="30000" />
<add key="GraphqlMaxOperationCount" value="10000" />
<add key="GraphqlMaxInputFileSize" value="10240" />
<add key="GraphqlInputFileDownloadTimeout" value="100000" />
<add key="HooksMaxInputFileDownloadTimeout" value="100000" />
<add key="HooksOperationTimeout" value="30000" />
<add key="HooksMaxInputFileSize" value="10240" />
<add key="EngineServiceTempApiFilesLifespan" value="2" /><add key="AdministrationDefaultConditionLanguage" value="JS" /><add key="ApplicationSmtpEnableSsl" value="N" />
<add key="ApplicationSmtpPort" value="" />
<add key="ApplicationSmtpUsername" value="" />
<add key="ApplicationSmtpPassword" value="" /><add key="GraphqlMaxInputFileContentSize" value="0" />
<add key="HooksMaxInputFileContentSize" value="0" />
<add key="GraphqlInputFileAllowedFolders" value="" />
<add key="HooksInputFileAllowedFolders" value="" /><add key="ApplicationSecurityAuthSessionRefreshEnableIFrame" value="Y" /><add key="EngineServiceInactiveRequestLifespanUnit" value="d" />
<add key="EFormAspxAcceptEmptyInputTextParam" value="Y" />
<add key="SendHttpPostMaxResponseLength" value="4194304" />
<add key="RestApiClientLogLevel" value="0"/>
<add key="RestApiClientRequestTimeout" value="3000" />
<add key="RestApiClientMaxResponseLength" value="4194304" />
<add key="RestApiClientEnableFilesCleanUp" value="Y" />
<add key="GetUsersFromDirLogLevel" value="0" />
<add key="XmlTransEnableFilesCleanUp" value="Y" />
<add key="MergeFormEnableFilesCleanUp" value="Y" />
<add key="GraphqlInputFileAllowedHttpUrls" value="" />
<add key="HooksInputFileAllowedHttpUrls" value="" />XmlTransPreviousFilesCleanUp
MergeFormTempFilesLifeSpan<location path="auth" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location>
<location path="hooks" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location>
<location path="scim" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules><add key="PortalRedirectAllowedHttpUrls" value="" /><location path="graphql" inheritInChildApplications="false">
<system.webServer>
<httpProtocol>
<customHeaders>
<add name="Access-Control-Allow-Origin" value="*" />
<add name="Access-Control-Allow-Methods" value="GET, POST, OPTIONS, HEAD" />
<add name="Access-Control-Allow-Headers" value="Accept, Origin, Authorization, Content-Type, x-wfgen-impersonate-username, x-iisnode-auth_user" />
</customHeaders>
</httpProtocol>
</system.webServer>
</location><add key="AdministrationMaxHelpTextSize" value="10000" />
<add key="ApplicationSecurityAuthAdditionalScopes" value="" /><add key="ReportsTopProcessesNumber" value="10" /><add key="ValidationSettings:UnobtrusiveValidationMode" value="None" /><add key="ApplicationSecurityAuthResponseMode" value="" />
<add key="ApplicationSecurityAuthDecodeAccessToken" value="" /><add key="ExecSqlLogLevel" value="0" /><add key="GetUsersFromDirLogLevel" value="" />
<add key="MergeFormLogLevel" value="" />
<add key="SendHttpPostLogLevel" value="" />
<add key="RestApiClientLogLevel" value="" /><location path="graphql" inheritInChildApplications="false">
<system.webServer>
<httpProtocol>
<customHeaders>
<add name="Access-Control-Allow-Origin" value="*" />
<add name="Access-Control-Allow-Methods" value="GET, POST, OPTIONS, HEAD" />
<add name="Access-Control-Allow-Headers" value="Accept, Origin, Authorization, Content-Type, x-wfgen-impersonate-username, x-iisnode-auth_user" />
</customHeaders>
</httpProtocol>
</system.webServer>
</location><add key="AdministrationProcessQuickListSize" value="0" />
<add key="EngineServiceNotificationFrequency" value="60000" />
<add key="EngineServiceCancellationFrequency" value="120000" />
<add key="EngineServiceSynchroActionFrequency" value="15000" />
<add key="EngineServiceScheduledSystemActionFrequency" value="15000" />
<add key="EngineServiceTimeoutSystemActionFrequency" value="15000" />
<add key="EngineServiceCleanupFrequency" value="180000" />
<add key="EngineServiceMaxScheduledSystemActions" value="25" />
<add key="EngineServiceMaxTimeoutSystemActions" value="25" />
<add key="ApplicationSecurityAuthExposeAccessTokenInCookies" value="N" />
<add key="DocuSignUserGuid" value="" />
<add key="DocuSignAuthServer" value="" />
<add key="DocuSignClientId" value="" />
<add key="DocuSignHostServer" value="" />
<add key="DocuSignSendLogLevel" value="0" />
<add key="DocuSignCheckLogLevel" value="0" />
<add key="JsonToDataLogLevel" value="0" /><add key="DirectoryApplicationAssemblyQualifiedName" value="Advantys.Workflow.Directories.WorkflowDirectoryUserManager, Advantys.Workflow.Directories" />
<add key="DirectoryDeletionRulesAssemblyQualifiedName" value="Advantys.Workflow.Directories.WorkflowDirectoryDeletionRules, Advantys.Workflow.Directories" />
<add key="DirectoryMaxMapToUsers" value="100" />
<add key="DirectoryTruncateValue" value="50" /><add key="ServiceName" value="WorkflowGenDirSyncService" /><add key="ServiceName" value="WorkflowGenEngineService" /><handlers>
<add name="iisnode" path="dist/server.js" verb="*" modules="iisnode"/>
</handlers>
<rewrite>
<rules>
<rule name="DynamicContent">
<conditions>
<add input="{{REQUEST_FILENAME}}" matchType="IsFile" negate="True"/>
</conditions>
<action type="Rewrite" url="dist/server.js"/>
</rule>
</rules>
</rewrite> <runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
<system.diagnostics configSource="trace.config" />WorkflowGen 9.2.5 requires .NET Framework 4.8, so you must install it before proceeding with this upgrade.
web.config file's URL rewrite rulesAs of WorkflowGen 9.2.0, you MUST update your site's root web.config file with the new URL rewrite rules, based on how your WorkflowGen URL is configured. For instructions on how to do this, see the section.
BACKURL_SUBMIT and BACKURL_CANCEL parameters in custom WorkflowGen URLsAs of version 7.15.5, the optional BACKURL_SUBMIT and BACKURL_CANCEL HTTP parameters used in custom WorkflowGen URLs (for example, ) now ONLY support absolute URLs (starting with http:// or https://), relative URLs (starting with /), or URLs defined in the PortalRedirectAllowedHttpUrls configuration parameter (e.g. value='blank.htm, myPage.htm').
As of version 7.15.0, the SMTP server account and Remote Approval incoming server account passwords are no longer encrypted in the web.config file.
Before upgrading an existing WorkflowGen server, you must manually reset the passwords in cleartext for the ApplicationSmtpPassword and RemoteApprovalIncomingServerPassword parameters in the web.config. Alternatively, you can use the provided convert-web-config-pwd.ps1 PowerShell script in \wfgen to decrypt and convert the passwords in the web.config.
Microsoft SQL Server 2008, 2012, and 2014 are no longer supported. While these versions will still be compatible with WorkflowGen, support for any performance issues or bugs resulting from using SQL Server 2008, 2012, or 2014 will no longer be provided.
For clients currently hosting WorkflowGen on a database server older than MS SQL Server 2016, we highly recommend upgrading to the latest MS SQL Server version for the best performance.
This database compatibility upgrade is mandatory before migrating the WorkflowGen database from MS SQL Server 2005/2008 to 2016 and above.
It's not required if your WorkflowGen database is already running in MS SQL Server 2012 or 2014.
To do this, launch the Update\Databases\MsSQLServer\Update_WFG-V7-0_SQL_Triggers_2012.sql database update script in your SQL Server Management Studio tool.
Oracle database is no longer supported as of WorkflowGen 7.16.0.
The Node.js modules include the GraphQL API, webhooks, SCIM, and Auth. For instructions on how to enable them, see the section.
Upgrade Node.js to version 18.20.7 LTS (see ).
As of WorkflowGen version 7.10.0, if you're using incoming webhooks or GraphQL to upload files when starting a new request or completing an action, you must set the GraphqlFileInputAllowedFolders, HooksFileInputAllowedFolders, GraphqlMaxInputFileContentSize, and HooksMaxInputFileContentSize configuration parameters with the appropriate values (see the section).
GraphqlFileInputAllowedFolders and HooksFileInputAllowedFolders: These parameters should contain the physical paths of folders that contain files used in uploads.
GraphqlMaxInputFileContentSize and HooksMaxInputFileContentSize: These parameters should contain the maximum file size in kilobytes when uploading files using the file content method.
✏️ Note: We recommend limiting the file content size to small files under 1 megabyte.
The following dependencies have been updated as of WorkflowGen version 8:
jQuery v1.7.2 or 1.10.12 → 3.5.1
jQuery UI v1.8.20 or 1.10.3 → 1.12.1
jQuery Colorbox v1.4.33 → 1.6.4
jQuery Validation v1.11.1 → 1.19.3
Some .js, .css, and .png files have been moved to the \wfgen\js\common and \wfgen\App_Themes\Default\common folders, respectively. If you're using the previous versions of the files listed above in your forms, you must re-save the forms in order to use the correct paths and files.
If you're using custom web forms configured in .NET 2.0, you can keep using them in .NET 2.0 or migrate them to .NET 4.
Use WorkflowGen.My.dll in version 2.x.
Use a .NET 2.0 application pool.
Disable Web apps secure mode in the Security section on the General tab in the Configuration Panel.
Use WorkflowGen.My.dll in version 8.x.x or later.
Use a .NET 4 application pool.
Define or update the following nodes in the web form’s web.config:
These instructions apply only to configuring web forms to run properly without configuration errors. They do not cover potential migration or compatibility issues that may arise due to changes in the latest version of WorkflowGen.My. You must fully retest all of your web forms before production.
After an upgrade or migration to WorkflowGen 8 or later, custom web forms that use a version 8 or later WorkflowGen.My.dll in their custom \bin
The WorkflowGen.My and Workflow Web Controls assemblies are no longer strong-named in order to allow non-specific version dependency when referenced by other applications such as custom assembly SDK Workflow applications in WorkflowGen.
This simplifies the deployment procedure of an assembly SDK Workflow application to WorkflowGen 6.2.0 and later, and allows upgrading WorkflowGen to a newer version without having to rebuild the application's assembly that was referencing an older version of WorkflowGen.My.
There are some considerations when deploying a custom assembly SDK workflow application in WorkflowGen, namely the assembly location, the reference to WorkflowGen.My, and the reference to other software libraries.
There are two ways of deploying an assembly file in WorkflowGen.
The assembly file must be copied to the three \bin folders containing the WorkflowGen executable files: \wfgen\bin, \wfgen\ws\bin, and DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin.
The assembly file can be copied to a custom folder such as DRIVE:\MyWorkflowApps\Assembly.dll, and then use that specific path in the workflow application's definition.
WorkflowGen.My versions 3.1.0 and earlier are strong-named, which means your assembly must be built with and use the same version as your target WorkflowGen. This requires recompiling your assembly whenever you upgrade WorkflowGen to a newer version.
You can use one of the following workarounds to overcome this requirement:
Install the required WorkflowGen.My version in the system's Global Assembly Cache (GAC). For instructions on how to do this, see .
OR
Add a delegate to handle the assembly resolve event in order to load the current WorkflowGen.My version. For instructions on how to do this, see the WorkflowGen Knowledge Base article.
OR
As of version 3.2.0, WorkflowGen.My is no longer strong-named in order to allow non-specific version dependency when referenced by your assembly. You can simply deploy your assembly file using one of the two methods in the section above in WorkflowGen version 6.2.0 and later.
If your assembly uses third-party libraries, then these must also be deployed into the three WorkflowGen executable \bin folders. Alternatively, they can be installed into the system's Global Assembly Cache (GAC) if they are strong-named assemblies.
WorkflowGen is FIPS compliant as of version 7.10.0. If you want to enable FIPS compliance in your Windows environment, you have to configure the configuration password management and user password management modes beforehand.
In the Security section on the Configuration Panel General tab, set Configuration password management mode to AES (FIPS Compliant) and enter a 32-character encryption key. When you click Save, the application passwords will automatically be converted to the new symmetric encryption mode.
In the Authentication section on the Configuration Panel General tab, set Password management mode to One-way Hashing (SHA256 FIPS Compliant) mode.
If you're using Applicative authentication in Version 5 (Legacy) password management mode, users' passwords will automatically be converted into One-way Hashing (SHA256 FIPS Compliant) the next time they log into WorkflowGen.
If you're using Applicative authentication in One-way Hashing (SHA256) password management mode:
Select IIS authentication mode.
WorkflowGen no longer supports Internet Explorer, Windows XP, Windows 7, Windows 8, or Windows Server 2003 or 2008.
MS SQL Server 2005 is no longer supported as of WorkflowGen version 6.2.0, MS SQL Server 2008 is no longer supported as of WorkflowGen version 7.10.0, and MS SQL Server 2012 is no longer supported as of WorkflowGen version 8.2.0.
Oracle database is no longer supported as of WorkflowGen 7.16.0.
The following applications are deprecated and are no longer provided as of WorkflowGen version 6:
EFORMPDF
DOCAPPROVAL
DOCUPLOAD
FDFTOXML
However, if any of your processes still use these workflow applications, you can keep them declared under the WorkflowGen website as in version 5.
The following software is distributed with WorkflowGen (Apache 2.0, BSD, MIT, and other compatible licenses):
bluebird (see )
busboy (see )
body-parser (see )
change-case (see )
Define or update the following nodes in the web form’s web.config:
If your web form’s authentication is configured to use the built-in WorkflowGen authentication mode, then the new password hashing mode (One-way Hashing) introduced in version 6.1 will not be compatible with your web form. There are two solutions:
Use Version 5 password management mode instead. Make sure to use the Advantys.My.dll and Advantys.Security.dll files from version 5.x in the web form’s \bin folder.
OR
Migrate your web form to .NET 4. Make sure to use the Advantys.My.dll and Advantys.Security.dll files from WorkflowGen version 8.x in the in the web form’s \bin folder. For instructions on how to do this, see the next section.
If your web form’s authentication mode is configured with the built-in WorkflowGen authentication, then make sure to use the Advantys.My.dll and Advantys.Security.dll files from version 8.x.x or later in the web form’s \bin folder.
WorkflowGenMy.*.resxApp_GlobalResourcesSelect One-way Hashing (SHA256 FIPS Compliant) password management mode, then click Save.
Re-enter all user passwords.
Reset the authentication mode to Applicative.
PDFTODATABASE
chart.js (MIT License)
cookie-parser (see https://github.com/expressjs/cookie-parser/blob/master/LICENSE)
dataloader (see https://github.com/facebook/dataloader/blob/master/LICENSE)
edge-js (see https://github.com/agracio/edge-js/blob/master/LICENSE)
eml-format (see https://github.com/papnkukn/eml-format/blob/master/LICENSE)
express (see https://github.com/expressjs/express/blob/master/LICENSE)
express-graphql (see https://github.com/graphql/express-graphql/blob/master/LICENSE)
file-uri-to-path (see https://github.com/TooTallNate/file-uri-to-path/blob/master/LICENSE)
file-url (see https://github.com/sindresorhus/file-url/blob/master/license)
format (see https://sjs.mit-license.org)
graphql-js (see https://github.com/graphql/graphql-js/blob/master/LICENSE)
graphql-relay-js (see https://github.com/graphql/graphql-relay-js/blob/master/LICENSE)
graphql-tools (see https://github.com/apollographql/graphql-tools/blob/master/LICENSE)
graphql-upload (see https://github.com/jaydenseric/graphql-upload/blob/master/LICENSE)
htmx.org (see https://github.com/bigskysoftware/htmx/blob/master/LICENSE)
iisnode (see https://github.com/Azure/iisnode/blob/master/LICENSE.txt)
jquery (see https://jquery.com/license/)
jquery-colorbox (see https://plugins.jquery.com/colorbox/)
jquery-ui (see https://github.com/jquery/jquery-ui/blob/main/LICENSE.txt)
jquery-validation (see https://github.com/jquery-validation/jquery-validation/blob/master/LICENSE.md)
jsonwebtoken (see https://github.com/auth0/node-jsonwebtoken/blob/master/LICENSE)
jwks-rsa (see https://github.com/auth0/node-jwks-rsa/blob/master/LICENSE)
lodash (see https://github.com/lodash/lodash/blob/master/LICENSE)
mockery (see https://github.com/mfncooper/mockery/blob/master/LICENSE)
Node.js (see https://github.com/nodejs/node/blob/master/LICENSE)
proper-lockfile (see https://github.com/moxystudio/node-proper-lockfile/blob/master/LICENSE)
pug (MIT License)
request-promise-native (see https://github.com/request/request-promise-native/blob/master/LICENSE)
rimraf (see https://github.com/isaacs/rimraf/blob/master/LICENSE)
samlify (see https://github.com/tngan/samlify/blob/master/LICENSE)
supertest (see https://github.com/visionmedia/supertest/blob/master/LICENSE)
valid-url (see https://github.com/ogt/valid-url/blob/master/LICENSE)
<configuration>
<system.web>
<pages validateRequest="false" enableSessionState="true" />
</system.web>
</configuration><configuration>
<system.web>
<httpRuntime requestValidationMode="2.0" targetFramework="4.8" />
<pages validateRequest="false" enableSessionState="true" clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</configuration>The following procedures apply to the WorkflowGen 9.2.5 upgrade pack, available at https://github.com/advantys/workflowgen-releases/releases.
The upgrade pack is distributed as a compressed file containing the following folders:
Inetpub: WorkflowGen web application files
Program Files: WorkflowGen Windows Services files
Databases: WorkflowGen database update and creation files
Stop the IIS server (or at least your WorkflowGen web applications) if other websites are using the same IIS server.
Stop the WorkflowGen Directory Sync and Engine services in the Windows Services Management Console.
Back up the following folders:
DRIVE:\Inetpub\wwwroot\wfgen
DRIVE:\Program Files\Advantys\WorkflowGen
If the file storage path isn't the standard DRIVE:\Inetpub\wwwroot\wfgen\App_Data path, then you have to back up the corresponding folder.
Perform a standard database backup using your DBMS tools.
Verify if the following deprecated files and folders used by Node.js-based applications still exist in your \wfgen folder, and delete them if they do.
Delete the following files and folders from the \wfgen\graphql folder:
\controllers
\models
Delete the following deprecated assembly .dll files from the \wfgen\bin, \wfgen\ws\bin, and \Program Files\Advantys\WorkflowGen\services\bin folders:
Advantys.Directories
Advantys.Directories.Web.UI.Administration
Advantys.Web.UI.Charting
Copy and overwrite the upgrade content from Update\Inetpub\wwwroot\wfgen to your WorkflowGen web application folder. By default, the suggested physical path is DRIVE:\Inetpub\wwwroot\wfgen.
Domain users and the Windows accounts used to run the WorkflowGen IIS application pool and Engine service must have read and write permissions for the \wfgen\App_Data folder.
Do NOT copy and overwrite your existing DRIVE:\Inetpub\wwwroot\wfgen\web.config file if you want to keep your current WorkflowGen configuration settings and database connection information.
Delete the deprecated DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\EAGetMail40.dll file.
Overwrite the contents of your WorkflowGen Windows Services folder with the contents of Update\Program Files\Advantys\WorkflowGen. By default, the suggested physical path is DRIVE:\Program Files\Advantys\WorkflowGen.
Do NOT copy and overwrite your existing DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\*.config files.
Copy node.exe.config and trace.config (located in Update\Program Files\nodejs) to DRIVE:\Program Files\nodejs.
If there's already a node.exe.config file in the DRIVE:\Program Files\nodejs folder, do not overwrite it. Instead, add the following to the existing file's <configuration> node:
This section contains configuration parameter changes you need to apply, based on the version of WorkflowGen from which you're upgrading.
This section has been divided to provide a quicker reference for clients upgrading from versions 8.0.0 and later. If you're upgrading from version 7.22.15 or earlier, see the section and perform the required modifications to the configuration files based on the version from which you're upgrading, then return to this section and continue with the rest of the required modifications.
When upgrading to version 9.2.5 from version 9.0.1 Beta, apply the changes in the When upgrading from version 9.0.1 Beta (v9 Beta 2) and earlier, When upgrading from version 9.0.2 Beta (v9 Beta 3), When upgrading from version 9.0.7 and earlier, and When upgrading from version 9.1.0 and earlier sections.
When upgrading to version 9.2.5 from version 9.2.0 Beta 1, 9.2.1 Beta 2, 9.2.2 Beta 3, or 9.2.3 Beta 4, there are no changes to make to the web configuration file.
You must remove the xmlns attribute from the web configuration file regardless of the version from which you're upgrading. See for instructions on how to do this.
Add the following new parameters to <appSettings>:
Remove the following deprecated parameter from <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings> :
Update the value of the EngineServiceTimeoutSystemActionFrequency parameter to 120000 as follows:
Add the following new parameter to <appSettings> :
Update the value of the following parameter in <appSettings>:
Remove the following parameters from <appSettings> from version 8.1.0 Beta only:
Add the following new parameters to <appSettings> :
Add the following new parameters to <appSettings>:
Update the bindingRedirect node in all of the affected configuration files (listed below) from <bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" /> to <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />:
Add the following new parameter to <appSettings>:
Update the value of the following parameter in <appSettings>:
Remove the following deprecated parameters from <appSettings>
Add the following new parameters to <appSettings>:
Add the following new parameters to <appSettings>:
Add the following new parameter to <appSettings>:
Rename the following parameters in <appSettings>:
as
Add the following new parameter to <appSettings>:
If you want to enable default HTTP error handling by WorkflowGen, replace the following parameter in <appSettings>:
with the following:
xmlns attributeAs of WorkflowGen version 7, you must remove the xmlns attribute from these configuration files:
To do this, change <configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0"> to <configuration>.
This step is mandatory when upgrading to version 9.2.2 (9.2 Beta 3) or later, including if you're upgrading from version 9.2.0 (9.2 Beta 1) or 9.2.1 (9.2 Beta 2) and previously updated the root web.config file when you upgraded to that version.
You must update your site's root web.config file with the new URL Rewrite rules.
First, make sure the tool is installed on your WorkflowGen server.
There are two sample files provided in the installation pack.
If your WorkflowGen site uses the /wfgen path in its URL (e.g. https://yoursite/wfgen), refer to the Inetpub\wwwroot\web.config (in the manual installation pack) or Inetpub\wwwroot\web.config.sample sample file (in the update pack) for the new rules.
If your WorkflowGen site does NOT use the /wfgen path in its URL (e.g. https://yoursite), refer to the Inetpub\wwwroot\web.config.without-wfgen sample file for the new rules.
login.aspx sample file (custom authentication only)As of WorkflowGen 9.2.0, If you're using custom form authentication with a login page created based on the provided /wfgen/login.aspx sample template, you need to update the login page file. To do this:
Open your WorkflowGen site's /wfgen/login.aspx file (which might have been renamed).
Replace the redirectToUrl = "/wfgen/show.aspx?QUERY=WELCOME"; line with redirectToUrl = "/wfgen/dashboard";.
As of WorkflowGen version 8, the WorkflowGen.My.Web.UI.WebControls.dll assembly has been merged into WorkflowGen.My.dll. This breaking change impacts webforms created in the Form Designer and the webforms' \bin folders, so you must perform one of the following procedures:
Run the \update\configuration\update-webforms-wfg-my-assembly.ps1 script in PowerShell inside the \wfgen\wfapps\webforms\ folder. This will automatically update your ASPX webforms and delete deprecated files and folders.
This script requires PowerShell version 7.0 or later.
It will update all .aspx files located in the \webforms folder, including those not managed by the Form Designer. If you have custom webforms in this folder that use another version of WorkflowGen.My.dll, then you should skip the changes to these .aspx files. You can do this by moving these files to a temporary folder before running the script, and then copying them back to the original folder.
Delete the following files and folders from the\wfgen\wfapps\webforms\bin\ folder:
WorkflowGen.My.Web.UI.WebControls.dll
WorkflowGen.My.Web.Handlers.dll
In the \wfgen\graphql\web.config and \wfgen\hooks\web.config files, add the following to <system.webServer>:
Run the SQL scripts listed below in order, starting with your current version of WorkflowGen.
This section has been divided to provide a quicker reference for clients upgrading from version 8.0.0 and later. If you're upgrading from version 7.22.15 or earlier, see the section and run the required database update scripts based on the version from which you're upgrading, then return to this section and continue with the rest of the required scripts.
Launch the Update\Databases\MsSQLServer\Update_WFG-V8-0-2.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V8-0-3.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V8-1-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V8-2-0.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V9-0-1.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V9-0-2.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V9-0-3.sql database update script in your SQL Server Management Studio tool.
Launch the Update\Databases\MsSQLServer\Update_WFG-V9-1-0.sql database update script in your SQL Server Management Studio tool.
There is no database update script to run.
Domain users and the Windows accounts used to run the WorkflowGen IIS application pool and Engine service must have read and write permissions for the \wfgen\app_data folder.
The WorkflowGen website and web applications must now use an application pool in .NET 4. If this hasn't already been configured, do the following:
Install .NET Framework 4 on the server, if it's not already installed.
Update the existing application pool or create a new application pool using .NET Framework 4 for:
the WorkflowGen website
To use the GraphQL, incoming webhooks, OpenID Connect Auth, and SCIM APIs, you must first install the following requirements:
✏️ Note: This library is required if you encounter the error
In IIS, convert /wfgen/graphql to an application with a .NET 4 application pool (integrated pipeline).
Configure the GraphQL application authentication mode:
For Basic authentication: Enable Basic authentication.
Update the WorkflowGen web.config file with the following parameters used by incoming webhooks:
In IIS, convert /wfgen/hooks to an application with a .NET 4 application pool (integrated pipeline), and configure the hook application in Anonymous authentication mode.
In IIS, convert /wfgen/scim to an application with a .NET 4 application pool (integrated pipeline), and configure the application in Anonymous authentication mode.
In IIS, convert /wfgen/auth to an application with a .NET 4 application pool (integrated pipeline), and configure the application in Anonymous authentication mode.
Reboot your WorkflowGen web server.
The following workflow applications store their files in these new locations:
EFORMASPX: \wfgen\App_Data\Files\EFormAspx
XMLTODATABASE: \wfgen\App_Data\LogFiles\XmlToDatabase
XMLTRANS: \wfgen\App_Data\Files\XmlTrans and \wfgen\App_Data\LogFiles\XmlTrans
\node_modules
\services
\utils
config.js
config.production.js
server.js
Delete the following files and folders from the \wfgen\hooks folder:
\controllers
\models
\node_modules
\services
\test
\utils
config.js
config.production.js
server.js
upload.js
Delete the following files and folders from the \wfgen\auth folder:
\controllers
\models
\node_modules
\static
\utils
config.js
config.production.js
server.js
Delete the following files and folders from the \wfgen\scim folder:
\controllers
\models
\node_modules
\services
\utils
config.js
config.production.js
server.js
Advantys.Workflow.Applications.ExecSql
Advantys.Workflow.Applications.GetUsersFromDir
Advantys.Workflow.Applications.MergeForm
Advantys.Workflow.Applications.RestApiClient
Advantys.Workflow.Applications.SendMessage
Advantys.Workflow.Applications.XmlToDatabase
Advantys.Workflow.Applications.XmlTrans
Advantys.Workflow.Reports
Advantys.Workflow.Web.UI.Reports
It’s possible that the following default CSS files have been updated in this release and could overwrite any changes you had made in your existing installation:
\wfgen\App_Themes\Default\portal\css\Default.css
\wfgen\App_Themes\Default\admin\css\Default.css
If you've made changes to any of the default files in the following folders (e.g. *.aspx, *.css, *.resx files), make a backup of the existing files prior to the upgrade and manually re-apply these changes to the corresponding version 9.x.x files:
\wfgen
\wfgen\App_Themes
\wfgen\App_Data\Templates\Emails
\wfgen\App_Data\Templates\Forms
\wfgen\App_Data\Templates\Processes
\wfgen\web.config
\wfgen\ws\web.config
\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config
\Program Files\nodejs\node.exe.config
\de
\fr
\hu
\pl
Upgrade each of your webforms created in the Form Designer, either by re-saving them or by manually replacing the <%@ Register Assembly="WorkflowGen.My.Web.UI.WebControls" ... %> tag with <%@ Register Assembly="WorkflowGen.My" ... %> inside each of your .aspx files.
\wfgen\wfgen\wfapps\webforms (create this IIS web application if it isn’t already created)
\wfgen\ws
If your application pool is set to use Classic Managed Pipeline Mode, make sure ASP.NET v4.0.30319 is set to Allowed in the IIS manager ISAPI and CGI Restrictions list.
The specified module could not be foundedgeedge-js/wfgen/graphql/wfgen/hooks/wfgen/scimAfter enabling GraphQL, incoming webhooks, OpenID Connect Auth, or SCIM, the WorkflowGen DLLs will be in use by Node.js, so they'll be locked from being updated. In order to update the DLLs, it's necessary to stop IIS.
For WorkflowGen Applicative authentication:
Make sure the /wfgen web application already has WorkflowGen Applicative authentication enabled.
Enable Anonymous authentication.
Update the WorkflowGen web.config file with the following parameters used by GraphQL:
<add key="GraphqlMaxPageSize" value="100" />
<add key="GraphqlMaxBatchSize" value="1000" />
<add key="GraphqlDefaultPageNumber" value="1" />
<add key="GraphqlDefaultPageSize" value="30" />
<add key="GraphqlGraphiqlEnabled" value="N" />
<add key="GraphqlLoadersCacheEnabled" value="Y" />
<add key="GraphqlDebugEnabled" value="N" />
<add key="GraphqlQueryTimeout" value="90000" />
<add key="GraphqlOperationTimeout" value="30000" />
<add key="GraphqlMaxOperationCount" value="10000" />
<add key="GraphqlMaxInputFileSize" value="10240" />
<add key="GraphqlMaxInputFileContentSize" value="0" />
<add key="GraphqlInputFileDownloadTimeout" value="100000" />
<add key="GraphqlInputFileAllowedFolders" value="" />
<add key="GraphqlInputFileAllowedHttpUrls" value="" /><runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
<system.diagnostics configSource="trace.config" /><add key="RemoteApprovalAuthClientId" value="" />
<add key="RemoteApprovalAuthClientSecret" value="" />
<add key="RemoteApprovalAuthScope" value="" />
<add key="RemoteApprovalAuthAccessTokenUri" value="" />EngineTraceMode<!-- AdobeSign -->
<add key="AdobeSignClientId" value="" />
<add key="AdobeSignClientSecret" value="" />
<add key="AdobeSignHostServer" value="" />
<add key="AdobeSignRefreshToken" value="" />
<add key="AdobeSignSendLogLevel" value="0" />
<add key="AdobeSignCheckLogLevel" value="0" /><add key="EngineNotificationNotifyDelegator" value="Y" />
<add key="EnginePushNotificationSendExpoApiUrl" value="https://exp.host/--/api/v2/push/send" />
<!-- Docaposte -->
<add key="DocaposteUsername" value="" />
<add key="DocapostePassword" value="" />
<add key="DocaposteHostServer" value="" />
<add key="DocaposteOfferCode" value="" />
<add key="DocaposteOrganizationalUnitCode" value="" />
<add key="DocaposteSendLogLevel" value="0" />
<add key="DocaposteCheckLogLevel" value="0" /><add key="EngineServiceMaxPausedSynchroActions" value="25" /><add key="EngineServiceTimeoutSystemActionFrequency" value="120000" /><add key="PortalReportAdvancedViewPaging" value="N" /><add key="PortalListPageSize" value="25" /><add key="PortalReportAdvancedViewPageSize" value="25" />
<add key="PortalReportAdvancedViewPageSizeOptions" value="10,25,50,100,250" /><add key="GraphqlApiKeyEnabled" value="N" />
<add key="GraphqlApiKey" value="" /><add key="PortalDisplayAssignedTeamAction" value="N" />
<add key="HooksAllowImpersonateUser" value="N" />
<add key="HooksApiKeyEnabled" value="N" />
<add key="HooksApiKey" value="" /><add key="ApplicationDefaultFullWidth" value="N" /><add key="PortalCommentsPopUpHeight" value="600" /><!-- Auth: Gardian -->
<add key="ApplicationSecurityAuthAcrValues" value="" />
<add key="AdobeSignRefreshUrl" value="/oauth/v2/refresh" />
<!-- Yousign -->
<add key="YousignApiKey" value="" />
<add key="YousignHostServer" value="" />
<add key="YousignSendLogLevel" value="0" />
<add key="YousignCheckLogLevel" value="0" /><add key="PortalDisplayRequestListWithActionsFollowUp" value="N" />
<!-- OpenAi -->
<add key="OpenAiApiKey" value="" />
<add key="OpenAiTranscriptionLogLevel" value="0" /><add key="OpenAiChatLogLevel" value="0" /><!-- OpenAI -->
OpenAiApiKey
OpenAiTranscriptionLogLevel
OpenAiChatLogLevel<!-- OpenAI -->
OpenAIApiKey
OpenAITranscriptionLogLevel
OpenAIChatLogLevel<!-- OpenAI -->
<add key="OpenAIChatApiUrl" value="" /><customErrors mode="Off"/><customErrors mode="On" defaultRedirect="default_error_page.htm">
<error statusCode="401" redirect="401.htm" />
<error statusCode="404" redirect="404.htm" />
<error statusCode="500" redirect="500.htm" />
</customErrors>\wfgen\web.config
\wfgen\ws\web.config
\wfgen\WfApps\WebForms\web.config
DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineServer.exe.config
DRIVE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config.\update-webforms-wfg-my-assembly.ps1 -Path "c:\inetpub\wwwroot\wfgen\wfapps\webforms" -Verbose<httpErrors existingResponse="PassThrough" errorMode="Detailed"></httpErrors><add key="HooksDebugEnabled" value="N" />
<add key="HooksOperationTimeout" value="30000" />
<add key="HooksMaxInputFileSize" value="10240" />
<add key="HooksMaxInputFileContentSize" value="0" />
<add key="HooksInputFileDownloadTimeout" value="100000" />
<add key="HooksInputFileAllowedFolders" value="" />
<add key="HooksInputFileAllowedHttpUrls" value="" /><location path="hooks" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><location path="hooks" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>
</location><location path="scim" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><location path="scim" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>
</location><location path="auth" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><location path="auth" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>
</location>ChartServiceAvoidColorCollision
ChartServiceMaxSliceInPie
ReportsChartServiceUrl
ReportsChartTemplatePath
ReportsChartTemplateExtension