Configuration Panel
The Configuration Panel is used to configure the main settings for the WorkflowGen application. It can be accessed from the home page of the Administration Module or from the URL http://[servername]/wfgen/admin/Config.aspx.
Access to the Configuration Panel can be set in the WorkflowGen web.config configuration file located in the \wfgen directory of your site. To add administrators, add their user names (separated by commas) to the ApplicationConfigAllowedUsersLogin parameter. (The users must first have administrator profiles.)
The Configuration Panel is divided into the following tabs:
General: General WorkflowGen settings (e.g. database connection string)
Portal: User Portal settings (e.g. behavior, banner settings, etc.)
Administration: Administration Module settings (e.g. language settings)
Directory synchronization: Directory synchronization settings (e.g. logs, schedules)
Integration: Integration settings (e.g. GraphQL, webhooks)
Remote Approval: Remote Approval settings (e.g. log file trace level, mail server)
Diagnostic: File size usage and request-related errors
Product information: Product installation information page
This is the type of database that WorkflowGen is using (Microsoft SQL Server).
The database scaling feature allows for the addition of database servers to significantly improve server performance and response times. The additional read-only replica database server can be used as a dedicated read-only server (SELECT SQL queries). The read-only database server is replicated from the existing master.
To test if the master database connection string entered is valid, click the Test button.
Data Source=DB_SERVER_1;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=admin123!;
The read-only replica database connection string. To test if the connection string entered is valid, click the Test button.
Data Source=DB_SERVER_2;Initial Catalog=WFGEN;User ID=WFGEN_USER;Password=admin123!;
Select the Enable checkbox to activate the database scaling feature.
If the multi-database option is enabled, the checkboxes of the different Portal components will be activated. If checked, the different components will use the read-only replica database. Otherwise, if left unchecked, it will use the primary database.
If the multi-database option is enabled, the different Portal modules will be activated. If checked, the different modules will use the read-only replica database. Otherwise, if left unchecked, it will use the primary database.
The base URL of the web application. You can specify the protocol to use (HTTP or HTTPS), the IP or DNS name of the web server, and/or the TCP port of the website. To test if the value entered is valid, click the Test button.
📌 URL example: http://www.mycompany.com/
You can choose between two delivery methods: Server, which will use your SMTP server to send email notifications, and Pickup directory, which will save email notifications in a pickup folder.
Server:
Host name: The SMTP server address
Port: The SMTP server port; if not set, the SMTP connection will use the default SMTP port (
25)Use SSL/TLS: Check to enable SSL/TLS
Username: The username used for the SMTP connection
Password: The password used for the SMTP connection
Connection timeout (seconds): The time in seconds allowed before server connection timeout (default:
3)
Pickup directory: Specify the path of the pickup folder. This option requires that you set up an SMTP gateway or external SMTP service to retrieve and send email notifications.
To test the SMTP configuration, click the Test button and enter sender and recipient email addresses. An email will be sent to the address you entered.
See the SENDMESSAGE workflow application section for information on how to configure instant messaging in WorkflowGen.
The SMS provider (Twilio).
The Twilio API URL.
The Twilio account security identifier.
The Twilio authorization token.
The telephone number of the instant message sender to display.
Enables instant messaging logs.
Select the authentication mode used to log in to WorkflowGen:
IIS: Users are authenticated by IIS.
Windows: Authentication and user passwords are managed in Windows.
WorkflowGen: Authentication and user passwords are managed in WorkflowGen.
Custom: Authentication and user passwords are managed using your own custom .NET HTTP module.
Microsoft Identity Platform: OIDC-compliant Microsoft Identity Platform v2.0 authentication.
Azure v1: OIDC-compliant Azure authentication.
Auth0: OIDC-compliant Auth0 authentication.
ADFS: OIDC-compliant Active Directory Federation Services 2016 authentication.
Okta: OIDC-compliant Okta authentication.
Version 5 (Legacy) uses the same password management mode as earlier versions of WorkflowGen.
One-way Hashing (SHA256) stores hashed account passwords in the WorkflowGen database.
One-way Hashing (SHA256 FIPS compliant) stores hashed account passwords in the WorkflowGen database, compatible with Windows FIPS enabled mode.
Sets the maximum number of user login attempts before the account is locked. Enter 0 for unlimited attempts.
Sets the minimum length of user passwords.
You can specify a domain to remove from users' usernames when they log in to WorkflowGen. If this value is set to All, any domain name will be removed from the value.
The password management mode for directories, applications, SMTP server, and the Remote Approval incoming mail server. AES (FIPS Compliant) mode uses symmetric password encryption, compatible with Windows FIPS enabled mode. Version 5 (Legacy) uses the legacy symmetric password management mode.
Enables data encryption in the communication between WorkflowGen and the web form. This feature has been available since version 5.6.1 for the built-in form designer, as well as any web forms using the WorkflowGen.My and WorkflowFileUpload libraries (versions 2.3.3 and above).
To use this security feature, all web forms created with Visual Studio must be upgraded to use WorkflowGen.My and WorkflowFileUpload versions 2.3.3 or above before enabling this option.
The Windows Service identity to use in order to run the WorkflowGen services.
Usernames (separated by commas) of users who have permissions to perform system or sensitive administration operations through the API, such as process management and deployment, participant management, user management, group management, raise exception, complete activity instance, or other regular API operations through impersonation.
Sets what time zone is selected by default on the user’s home page on the Portal module. This is used when creating a new user account, whether manually or by directory synchronization. Since it is used only for account creation, it will not override the current user’s selected time zone.
Specifies which weekdays are normally off. This is used by WorkflowGen to calculate process and action deadlines.
📌 Example: Selecting Saturday, Sunday will exclude these days from deadline calculations.
Specifies at which hour the workday begins (based on the current server time zone). This value is used by WorkflowGen to calculate the process and action deadlines. It will be converted to GMT for calculations.
📌 Example: 8 specifies that deadlines are to start being calculated at 8:00 a.m. every day.
Specifies at which hour the workday ends (based on the current server time zone). This value is used by WorkflowGen to calculate the process and action deadlines. It will be converted to GMT for calculations.
📌 Example: 19 specifies that deadlines are to stop being calculated at 7:00 p.m. every day.
Specifies the time zone in which working hours begin and end.
Selects the country to be used to calculate the legal public holidays. This value is used by WorkflowGen to calculate the process and action deadlines, based on one of the DaysOff.*.resx files located in \wfgen\App_GlobalResources. These files can be updated and new ones can be created based on their regional settings. By default, it uses the DaysOff.en-US.resx resource file, which is based on the value of the EngineCountryDaysOff configuration setting in the WorkflowGen web.config file.
📌 Example: United States (English)
This value allows you to specify your custom days off.
📌 Example: 2/1, 11/1 specifies January 2nd and January 11th as holidays.
Defines the look and feel of the UI, including colors, margins, etc. The administrator can use the default skin or manually edit the CSS files to create a different look.
Customizes the WorkflowGen word that is displayed in the User Portal.
📌 Example: Acme Flow
Defines the Portal language. Selecting User preference allows the user to choose their language, but you can impose one by selecting it in the list, in which case the language selection option will be hidden in the Portal User settings panel.
Uncheck this to display process and action descriptions instead of code names.
Number of records displayed in different lists of the User Portal. Default: 10
Number of pages displayed in different lists of the User Portal. Default: 10
Limits the number of records displayed in a search or statistics (data) result list. Default: 1000
You can specify the maximum limit before a filter appears in user lists. Default: 100
Display mode of the New request link on the User Portal home page. You can choose between:
Display requests
Display requests grouped by category
Display categories and hide processes
When a new request is launched, you can choose how WorkflowGen behaves from the following:
Display the request follow-up form
Start the first action
Display the follow-up form of the first action
If this parameter is checked, the user has to confirm the launch of the new request.
Display the follow-up form of the action
Launch the action
Display the follow-up form of the request
Display the follow-up form of the request or the next action
Display the follow-up form of the request (except if action to assign)
Display the follow-up form of the request (except if action to do)
Display the list of actions to do
Display the list of actions to do or the next action
Display the list of actions to do (except if action to assign)
Display the list of actions to do (except if action to do)
Display the homepage
Display the homepage or the next action
Display the homepage (except if action to assign)
Display the homepage (except if action to do)
Display the homepage and expand the actions to do
Display the homepage and expand the actions to do or the next action
Display the homepage and expand the actions to do (except if action to assign)
Display the homepage and expand the actions to do (except if action to do)
Display the homepage and expand my requests in progress
Specifies if the action completion treatment is processed in the background (threading). This option can sometimes improve the response time to the end user or prevent timeout issues, especially if there are large amounts of processing after a web form submission.
Maximum number of records in lists on the User Portal home page before showing pages.
URL of the banner displayed at the top of the User Portal.
📌 Example: http://www.mycompany.com/welcome.htm
Height of the banner (in pixels) displayed at the top of the User Portal.
📌 Example: 50
Specifies if the search result is redirected to the follow-up form when there is only one item found.
Display the result as a customizable report by default
Enable Quick approval by default: Enables the Display Quick approval buttons option in the Search form by default.
Enable custom column editing for process managers and supervisors
Enable custom column editing for standard users
Enable custom chart editing for process managers and supervisors
Enable custom chart editing for standard users
Displays URLs and email addresses as clickable links.
Specifies if the processes are grouped by category in the drop-down list box used to switch to the single process view.
Specifies the default width (in pixels) of the columns that display the associated data when the end-user UI is switched to the single-process view. Default: 150
Allows you to enable or disable the Quick View functionality in the User Portal.
Specifies the process data value to display within the Quick View dialog box.
📌 Example: FORM_ARCHIVE
You can choose between two different events to trigger the Quick View dialog box to open: Click (Default) or Hover.
This parameter allows you to enter the same names and data types, which can then be used in a multi-process view.
For example, if you have a process data called CUSTOMER (TEXT) that is used in most of your processes, you can define it as Portal common process data by entering it in the Common process data name list field.
When entering multiple data types in this parameter, each data type must be separated by a comma.
User calling cards are enabled by default. Uncheck this to disable calling cards.
Specifies the maximum number of days, hours, or minutes before deleting requests in progress that contain only one action that is not yet completed and assigned to the requester only. Defaults: 3 and days
The maximum number of simultaneous launches of the same process action. This parameter allows you to avoid simple loops at runtime.
📌 Example: 100
When this is selected, managers and supervisors can delete requests even if the process status is set to Active.
Uncheck this to hide data with empty values in the follow-up form.
Request data will be locked during the time period specified in order to avoid "competition" for access to the same data.
📌 Example: 5
Activate email notification: This parameter allows you to enable or disable email notifications. This will affect all processes regardless of their status.
Notify the user when they are both the sender and recipient of the notification: If this parameter is enabled, email notifications are sent even if the sender and recipient email addresses are the same.
Sets the default sender name for email notifications. If not set, the default sender email address will be displayed as the sender name.
Sets the default email sender for email notifications. This is only used if a notification is sent by the system.
📌 Example: [email protected]
Default email address for replies to email notifications.
Maximum number of users to send email notifications to per notification.
📌 Example: 100
Maximum size of attachments to requests in megabytes.
If the user has no default or preferred language selected, this parameter is used to specify which language to use for the email notification texts.
Displays URLs and email addresses as clickable links.
This sets the type of information stored in the notification log file.
0 – Disabled: No log file will be created.
1 – Errors only: The log file will display only information pertaining to errors.
2 – All notifications: The log file will contain information pertaining to errors and notifications, such as the time stamp and the recipient’s email address.
If this parameter is checked, end-users can delegate their tasks to other WorkflowGen users. Otherwise, only administrators are able to manage the delegation rules from the Administration Module.
This is used to specify the URL of the host application. For example, in SharePoint, you can create a webpart to display and use the WorkflowGen User Portal or Administration Module in the same way as a stand-alone web browser. This way, a user can remain in the SharePoint portal and use WorkflowGen at the same time without having to work in separate windows.
In this case, you have to specify the host URL in order for WorkflowGen to function properly inside the SharePoint webpart.
This option will force WorkflowGen to throw an assignment exception error when a self service action is assigned to an invalid user. You should design your process to handle assignment exceptions, otherwise it will halt your workflow.
Number of processes displayed in statistic reports.
📌 Example: 10
Number of users displayed in statistic reports.
📌 Example: 10
Number of actors displayed in statistic reports.
📌 Example: 10
Number of requesters displayed in statistic reports.
📌 Example: 10
Displays URLs and email addresses as clickable links.
You can choose between two different formats when exporting the results generated from a data statistics report. The available formats are:
CSV (comma-separated values): This format does not support Unicode characters. ✏️ Note: You can configure different separators for certain languages and/or cultures by modifying the
CSVFieldDelimitervalue in the language's\wfgen\App_GlobalResources\Advantys.Workflow.Web.UI.Portal.*.resxfile.
Unicode text (tab separator): The values are separated by tab characters but the Unicode character range is supported.
Enables or disables User Portal comments.
Sets the total number of comments that can be displayed on the home page.
Sets the follow-up form comments list auto-refresh rate in milliseconds. Use the value 0 to disable the auto-refresh feature. Default: 300000 (5 minutes)
Sets the action runtime menu comments list window pop-up width size in pixels. Default: 380
The following corresponding style widths must be updated separately in the Portal’s Cascading Style Sheet (\App_Themes\Default\portal\css\Default.css) when the pop-up width is changed:
div.CommentsViewOpenedRightAlign
div.CommentsViewSubOpenedRightAligndiv.CommentsViewOpenedPopUpRightAlign
div.CommentsViewSubOpenedPopUpRightAlign.CommentsListHeader .ListRow .CellOpenedRightAlign.CommentsList .ListRow .ListCell .Comment .Row .CellHeader.CommentsListInput .ListRow .ListCell .NewComment .Row .Cell .TextArea
Sets the action runtime menu comments list window pop-up height size in pixels. Default: 550
The following corresponding style heights must be updated separately in the Portal’s Cascading Style Sheet (\App_Themes\Default\portal\css\Default.css) when the pop-up height is changed.
div.CommentsListBodyPopUpdiv.CommentsListBodyPopUpHiddendiv.CommentsListBodyPopUpReadOnlydiv.CommentsListBodyPopUpReadOnlyHidden
Sets the default comment list sort by field. Default: date
Sets the default comment list sort order. Default: ascending
Expand the comments view displays the comment list the first time the follow-up form is displayed. Default: unchecked (hidden)
Allows you to define the application language for the Administration Module. Selecting User preference allows users to choose their own language, but you can impose one by selecting a language from the list.
Number of records displayed in lists of the Administration Module. Default: 100
Number of pages displayed in lists of the Administration Module. Default: 10
You can specify a maximum limit before a filter appears in the users’ lists. Default: 100
If Restrict name encoding to ANSI character set is checked, only ANSI characters are permitted in the "Name" fields. If this parameter is not checked, only special characters (', ", tab, space, %, /, \, *) are discarded.
Enable this option to keep actions in their respective participants' swim lanes in the workflow designer.
Sets the default language for conditions: JavaScript or VBScript.
The databind data providers, separated by commas (,).
Sets the maximum number of undo operations in the form designer. Default: 30
When a new user is created, the language selected here will be applied to their profile as their default language.
Enables the deletion rules check for users, groups, and directories. Disable this option to improve list and form response times.
Disables process managers’ permissions to modify a global participant’s information (either via the process participants or while importing a process) such as name, description, and user/group/directory associations.
Even if this option is enabled, process managers cannot create new global participants.
If this option is enabled, the directory synchronization will synchronize the group’s members only if the group is associated to at least one participant. This option is useful to reduce synchronization run time by skipping a group’s member synchronization when the group is not used in a participant.
Defines the maximum number of account deletions per synchronization run. This option is useful for batch account deletion in order to optimize synchronization performance. The default is 0 (unlimited).
If Automatically delete old log files is selected, the temporary XML files created by WorkflowGen are removed once the synchronization is complete.
If Display Update entries in logs is selected, the synchronization logs each action performed on the directory data.
Number of days before deleting the log files.
📌 Example: 31
If this is selected, warnings will be displayed in the log files.
Day of the week to perform the automatic weekly synchronization.
📌 Example: Monday
Date of the month to perform the automatic monthly synchronization.
📌 Example: 1 for the 1st of the month
Hour of the day to perform the automatic monthly synchronization (in 24-hour format).
Maximum page size for page number based pagination (default: 30; maximum: 100).
Default page number for page number based pagination (default: 1).
Default page size for page number based pagination (default: 30).
Enable GraphiQL (default: disabled).
Enable data caching.
Enable debug mode.
The query execution timeout in milliseconds.
The operation execution timeout in milliseconds.
The maximum number of operations per query.
The maximum file size to send in FILE type parameter URLs in kilobytes.
The maximum content size of FILE type parameters encoded in base64 (only recommended for small files, e.g. under 1 MB).
The local or remote folders where files used by FILE type parameters are stored.
When using file uploads, you don't need to add the original file folder to this setting.
You can disallow input file allowed folders by leaving this field empty, or allow certain folders only by entering comma-separated values according to the table below:
Value | Description |
Empty | No folders allowed |
| All folders allowed |
| All folders on drive |
| All subfolders in a specific folder |
| All
|
| Specific folder only |
You can disallow file uploads using HTTP and/or HTTPS URLs by leaving this field empty, or allow certain URLs only by entering comma-separated values according to the table below:
Value | Description |
Empty | No HTTP or HTTPS URLs allowed |
| All HTTP and HTTPS URLs allowed |
| HTTPS URLs only |
| HTTP URLs only |
| HTTP from a specific domain only |
| HTTP from a specific folder only |
| All files and folders whose names start with
|
| Specific file only |
Enable debug mode.
The operation execution timeout in milliseconds.
The maximum file size limit for FILE type parameters.
The maximum content size of FILE type parameters encoded in base64 (only recommended for small files, e.g. under 1 MB).
The local or remote folders where files used by FILE type parameters are stored.
When using file uploads, you don't need to add the original file folder to this setting.
You can disallow input file allowed folders by leaving this field empty, or allow certain folders only by entering comma-separated values according to the table below:
Value | Description |
Empty | No folders allowed |
| All folders allowed |
| All folders on drive |
| All subfolders in a specific folder |
| All
|
| Specific folder only |
You can disallow file uploads using HTTP and/or HTTPS URLs by leaving this field empty, or allow certain URLs only by entering comma-separated values according to the table below:
Value | Description |
Empty | No HTTP or HTTPS URLs allowed |
| All HTTP and HTTPS URLs allowed |
| HTTPS URLs only |
| HTTP URLs only |
| HTTP from a specific domain only |
| HTTP from a specific folder only |
| All files and folders whose names start with
|
| Specific file only |
Usernames (separated by commas) of users who have permissions to perform system or sensitive administration operations through the API, such as process management and deployment, participant management, user management, group management, raise exception, complete activity instance, or other regular API operations through impersonation.
See the Remote Approval section for information on setting up Remote Approval, such as approval emails, actions, and questions.
Enable Remote Approval.
Refresh interval for Remote Approval email (in seconds). Default: 180
Enables Quick mode, which lets the user reply to approval emails on one line, without any other formatting necessary (the user can still leave an optional comment on the second line). Default: disabled
Enable this mode to use the action reference code in the subject line for validation. Default: disabled (recommended for greater security)
Enable this to enforce case sensitivity on email answers. Default: disabled
Sets the amount and type of information stored in the notification log file:
0 – Disabled: None (no log file will be created)
1 – General messages: Execution summary messages only
2 – Error messages: Exception error messages only
3 – General and error messages: Execution summary messages and exception error messages
4 – Full details for debugging (including Event Viewer): Execution summary messages and full detail exception messages (including Event Viewer information logs)
Sets the life span for temporary log files. Default: 1 day
Type of email server: POP, IMAP, Exchange 2007, Exchange 2010 and later (Exchange 2013, 2016, and 2019 are supported), or Exchange Online - Modern Authentication.
Exchange Online - Modern Authentication is supported as of WorkflowGen version 7.22.5
This email server type supports authorization via the industry-standard OAuth 2.0 protocol for Exchange Online EWS servers. For the setup procedure, see the Exchange Online: Modern Authentication for Remote Approval chapter in the WorkflowGen for Azure guide.
The address (or, if using Exchange 2007+, the name) of the server to receive emails. For Exchange Online, use outlook.office365.com or your own Exchange Online domain name.
The port number for an IMAP or POP connection (not required for Exchange 2007+ or Exchange Online).
Enables SSL (use SSL for Exchange 2007+). Default: SSL
Email address for Remote Approval to send and receive approval emails. For Exchange Online, use the email address of the Remote Approval Office user.
The username used to log in to the POP, IMAP, or Exchange 2007+ server. For Exchange Online, use the username of the Remote Approval Office user.
Password used to log in to the POP, IMAP, or Exchange 2007+ server.
Domain name of the incoming Exchange 2007+ account.
Application (client) ID from the Azure Portal.
A secret string that the application uses to prove its identity when requesting a token; can also be referred to as an application password.
Scope of the application, e.g. https://outlook.office365.com/.default&grant_type=client_credentials. Replace outlook.office365.com with your own Exchange Online domain name if needed.
Endpoint where the access token is provided, e.g. https://login.microsoftonline.com/{directory_tenant_ID}/oauth2/v2.0/token. Replace {directory_tenant_ID} with your own directory (tenant) ID from the Azure Portal.
The total size refers to the combined size of all the files on the server. The average size refers to the average size of the files on the server. The maximum size refers to the largest filerev on the server.
This refers to a request that is open, but with no follow-up action associated with it. It is an irregular request.
Displays a list of actions that have timed out.
Displays a list of errors that are not timeout errors.
The current version of the WorkflowGen installation.
The activation serial number of the WorkflowGen installation, and copyright information.
The various library versions used by the WorkflowGen application.
