Qflow Admin
Introduction
This manual describes the web tool that allows you to manage and monitor different aspects of the system, such as sites and services, extended properties, licenses, notification services, workspaces and system parameters.
General user interface description
Fig. 739 shows the system administrator’s main screen. The interface’s main elements are:
Main screen: where shortcuts and a quick view of every license can be found.
Upper menu: gives access to the configuration screen, auditing the tool’s elements, changing the preferred time zone and logging out.
Sidebar: it allows you to navigate to the home page and displayservices, system parameters, license usage, user, group and node extended properties, licenses, notification services and workspaces. Each one of these options is described in detail in their corresponding sections.
License viewer
The licenses viewer can always be seen in the main screen and shows the usage of the current license. This viewer is divided in 3 indicators:
Used storage: it indicates the current license’s amount of used storage in gigabytes. For more information about license storage, please see the Licenses section.
Used Q-points: it indicates the number of Q-points spent by the current license’s flow. For more information about Q-points, please see the Licenses section.
Current enabled users: it indicates the number of currently enabled users within the organization.
Statistics
Qflow has a functionality that indicates the usage of the current workspace’s license. It is comprised of two reports, one for the license usage in the current month (see License usage) and another one for the usage record of previous licenses (see License usage record). Each report contains various graphs for the analysis of the license’s different elements. In order to access the statistics, select the corresponding option in the sidebar (see Fig. 746).
License usage
There are two graphs displayed in this report, both of them relate to the Q-points usage in the current month. The first chart shows the Q-points’ usage throughout the current month. The second chart indicates the same as the previous one, but grouping Q-points by flow template. Within this last graph, if the system cannot get the template’s name (as a result of it being deleted), its identifier will be shown.
There are two buttons in the upper left corner with which the graphs’ data grouping can be changed (see Fig. 750). With these buttons, data can be shown for the current day, or for the whole month.
A button can be found in the window’s upper right corner in order to access the license usage record report, which is detailed within the following section.
License usage record
When this option is selected, five graphs will be displayed. The first two indicate the amount of responded tasks and started flows in a given period of time. The remaining graphs show the records of Q-points usage, enabled users and storage usage in the last year, grouped by month.
The first two graphs have filters, and among them is the option of grouping data by month or by day (by default they are grouped by day), as well as the option to establish a custom time period (by default it is the current month).
System parameters
System parameters are predefined parameters that control various aspects of the product’s functionality. They can be of numeric type, true/false (boolean), text or image. They have a value, and a default value, which is what is used when they have no set value. To see the full list, see the System parameter listing section.
To access the list of system parameters, select the corresponding option in the sidebar (see Fig. 746). When selecting said option, a list with all of the system parameters will be displayed.
Through the buttons found above the table, a system parameter can be edited, as well as have its history viewed.
Some clarifications about the listing:
The “Source” column references whether the parameter was taken from a database () or a file ().
If the row with the parameter’s information is in grey color, it means that the parameter is read-only and cannot be edited.
If the value is displayed in bold and gray color, it means it is the default value.
When clicking on the information icon (), a description of the parameter’s goal will be displayed. Click anywhere on the listing to close it.
To edit any parameter that allows it, click on it and then on the edit button. A panel will open as shown in Fig. 757. If you click the View button, the same panel will open, but in read-only mode.
You can select “Use the default value”, or enter a custom value. This value can be empty. When you modify a parameter, it is necessary to reset the service in order to see the change.
When you click on the “View history” button, a right panel will open with the changes history for the selected system parameter. This panel shows the name of the action, the new value selected for the system parameter, the user that made the action and the time of said action.
Extended properties
Extended properties are defined by the organization and are shown in the properties panel of each member of the organizational model (user, group and node), in the administrator of said model. To see their use, see the Qflow Team manual.
An extended property has a key and a text value. It can also have one of the following types: text, number, date, true/false (boolean), member, or item list. This last value is comprised of a list of elements which have a key and value, both of type text.
User extended properties
You can add, view, edit and delete a user’s extended properties from the corresponding option in the sidebar (see Fig. 746). When you select said option, a list will be displayed with the defined extended properties.
Properties can be added, edited or removed through the buttons located above the table.
If you click on the add button, a panel will open to create the new property.
You must enter a key and text value. Keep in mind that once an extended property has been created, its key cannot be changed. If you wish for the property to have a type other than text, clicking on the arrow button in the Type field will display a list of the types mentioned in the Extended properties section. In the case that Item list is selected, a table like the one shown in Fig. 762 will be shown. You can add or remove items, move them and edit the text’s or key’s value.
It is mandatory that at least one item exists in the list. Also, there cannot be any repeated keys, nor any empty values (key or text).
When you click on the save button (tick icon on the upper right corner), the panel will be closed and the new property will appear in the listing.
If the property is selected, and you click on the Edit button, the edit panel will open.
Note that the key is disabled for editing, and only the other fields can be changed.
In order to delete them, you can also select as many properties as you wish from the listing. If you click on the Delete button, a warning sign will be displayed.
Select Yes to confirm.
When you click on the “View history” button, a right panel will open with the changes’ history in the selected extended property. This panel shows the action name, the user that did the action and the time of said action. If you click on the “+” button, it will display details about the extended property such as type and tag. It will also show information about the IP and MAC address of the user that made the changes.
Group extended properties
You can add, edit, and delete the extended properties of a group from the corresponding option in the sidebar (see Fig. 746). When you select said option, a list will be displayed with the defined extended properties.
The operations on the elements of this listing are analogous to the ones explained in the User extended properties section.
Node extended properties
If you are unfamiliar with the concept of a node, refer to the Qflow Team manual.
You can add, edit and remove a node extended property from the corresponding option in the side menu (see Fig. 746). When you select said option, a list will be displayed with the defined extended properties.
The operations on the elements of this listing are analogous to the ones explained in the User extended properties section.
Licenses
In this section we can see all the licenses that exist in the system. To access the listing select the corresponding option in the sidebar (see Fig. 746).
A list will be displayed showing all the licenses that are loaded in the system. Also, above the listing, it shows the product for which the licenses are being viewed, as well as the current organization.
The license listing will contain different fields depending on the version that is being used (OnPremise or Cloud). The common fields between the two versions are detailed below:
Type: it indicates the type of license.
Organization name: it indicates the organization for which that license was issued. If it does not match with the organization name that was configured, it will not be considered valid.
Number of users: it indicates the number of users that are enabled with that license.
Expiration date
Status: it shows an icon that indicates whether the license is valid or if there is any problem. The possible status are:
In any case, when you hover the mouse over the icon, a pop-up will appear with the status description.
A new license can be loaded, by clicking on the “+” button above the listing. A new dialogue box will open for you to select the license file stored in your computer. Supported file types are xml and qlic. Once loaded, the license will show up on the listing.
License model
Qflow Cloud’s licensing model consists of a model of points usage called Q-points.
Q-points are points that are used by executing flows. As such, each step of a flow has an assigned number of Q-points. There are steps (for example a start event) that have a fixed quantity of Q-points as the tool’s effort to process it is always the same. Secondly, some steps can have a dynamic number (for example, a code step), this means that while the step is running, it will consume a number of Q-points. Thus, the effort to process it can vary depending on the operations that occur within the step.
The following page defines the quantity of Q-points that each step available in Qflow uses: Q-points usage.
Apart from Q-points, the license must have a specified amount of storage available in the workspace, a number of users that are able to use the tool, and a validity period.
The information that can be seen in the listing is the following:
Maximum available storage: it indicates the maximum amount of storage in Gigabytes that the license has available.
Maximum execution points: it indicates the maximum number of Q-points that the license has available.
Notification services
Notification services are Qflow’s email services and push notifications. In order to view them, select the corresponding option in the sidebar (see Fig. 746). When you select said option, a list of the notification services will be displayed.
Using the buttons located above the table, you can view, configure, enable and disable a service.
Configure notification services
The “Configure” option opens a new panel in which you can decide to use the configuration from the main workspace or to customize it. If a custom configuration is used, the changes will only impact the current workspace, the different secondary workspaces will keep using their own configurations.
Notification service configuration
There are 4 types of notification services: SMTP, Extended MAPI, Exchange web service, and Firebase cloud messaging. The necessary configuration for the correct functioning of the services is detailed below.
SMTP
SMTP type services have the following properties:
Host: SMTP server name
Port (Optional): if the server does not use the default port, this property allows you to specify another one.
Time out (Optional): it allows you to specify a time out value in seconds.
SMTP User: it allows you to specify a user for the service.
SSL: it allows you to enable or disable SSL (secure connection). If the option is not checked, SSL remains disabled.
Sender user: system user’s name. It is the name that will appear as sender in the messages sent by Qflow.
System email: system email address. It is the address from which the messages from Qflow are sent.
Extended MAPI
Extended MAPI type services have the following properties:
Service: Exchange server name.
Mailbox: mail box to be used by Qflow.
Message class: message class. By default, IPM.Note.Qflow.
Profile (Optional): name of the profile to be used by Qflow.
Password (Optional): profile password.
Exchange web service
Exchange type services have the following properties:
Url: Url of the Exchange web services.
Exchange version: Exchange version installed in the server that will be used.
Message class: message class. By default, IPM.Note.Qflow.
User (Optional): user account that must be used.
Password (Optional): password for the user account indicated in the User property.
System email: system email box.
Firebase Cloud Messaging
Firebase type services, unlike those described previously, are about push notifications. As such, it is not necessary to configure mail formats. To configure the Firebase service, you must access the following console and create a project: https://console.firebase.google.com/
Within the Firebase project configuration, you can take all the necessary data to configure the notification service in Qflow Admin.
Fig. 776 shows the general configuration of the project from where the project’s ID and Web API key can be taken. In the case that you do not see the web API key, you must enable the Firebase authentication service from the project’s console.
The remaining data corresponds to the web application you want to use, the data can be extracted from the “Your applications” section by selecting the configuration option as shown in Fig. 777. For more information about how to create an application, go to the following guide: https://firebase.google.com/docs/web/setup#register-app.
Finally, the “Server configuration” field must have a JSON that corresponds to the Firebase Admin SDK, which can be obtained by following the next guide: https://firebase.google.com/docs/admin/setup#initialize-sdk.
In Fig. 778 you can see the Firebase configuration panel, for more details about the configuration of a Firebase server, refer to this manual: https://firebase.google.com/docs/web/setup
Manage permissions
When you select the “Manage tool settings” option in the configuration menu, a panel will open as shown in Fig. 779.
To add a user, group or security role to the set of entities that have permissions on the node:
Click on the “Add” button. This will cause a text to appear above said button, that reads “Start typing…”. Type part of the name of the desired user, group or role.
When the drop down list is displayed, select it.
Once the users, roles and groups are added, it is possible to define which permissions each of them have. This is done by marking the checkboxes “Allowed” or “Denied” next to each permission, as shown in Fig. 780.
The possible permissions are:
Manage security: it allows you to add and modify the permissions of the tool.
Access tool: it allows access to Qflow Admin.
Manage configuration: it allows to edit those elements of the tool that are editable (system parameters and extended properties).
Audit: it allows access to the audits of the different elements of Qflow Admin.
For a detailed explanation about how Qflow permissions work, refer to the “Permissions handling in Qlow” section in the Qflow Team manual.
To edit permissions of a user, group or role:
Select the item for which you want to edit the permissions and click on the “Edit” button, or click on the “+” symbol found next to the item.
The “Permissions configuration” form will display again. Select the actions that you wish to allow or deny in the new permission.
To remove permissions from a user, group or role:
Select the item from which you want to remove permissions, and then click on the “Delete” button.
A warning message will be shown. Click on the “Yes” button and all the permissions for the selected element will be deleted.
Audit
If audit permissions are enabled in Qflow Admin, you can see in the upper right menu the audit option. If you click it, it will display a list of options. This functionality allows you to verify changes in extended properties, licenses and system parameters, indicating their new values, the user that made the change, and the date and time.
System parameter history
This audit indicates the changes made on all of the system parameters. If you wish to know the changes made on one system parameter in particular, you must use the search bar or access the “View history” option on the system parameter listing.
Licenses history
This audit keeps a record of all added licenses. The listing shows the license’s identifier and the user that added it, along with the corresponding date and time.
Extended properties history
This audit lists all the changes made in all extended properties, no matter their type. Each table entry contains a logo that corresponds to the given type of property, and it can be expanded to show additional details about its modifications. If you want to filter by a particular property, you can use the search function or go to the extended properties listing and access one in particular.
System parameter listing
Technical name |
Name |
Description |
---|---|---|
ActionLink |
Action link |
It is the URL that links to actions used in the messages sent by email. |
DefaultDomainNetbiosName |
Default domain netbios name |
It specifies a default domain name when logging in to applications or to the websites. |
EnableAIAssistant * |
Enable AI assistant |
If the value of this parameter is “true”, access to the AI assistant will be enabled. Administrators may restrict access in the event of malicious use being detected. If you think there has been an error, please contact technical support. |
EncryptAttachments |
Encrypt attachment |
If the value of this parameter is “true”, Qflow will encrypt the attached files’ content so that the only way to access it is by means of Qflow permissions. If this parameter is activated, it will not be possible to do full-text searches using the attached files’ content. |
EnforceIntegratedLogon |
Enforce integrated authentication |
If this parameter’s value is “true”, users can only enter the application through integrated authentication. |
FlowDetailsLink |
Flow details link |
It is the url sent by email, which redirects to the details of a flow. |
FlowEditFormLink |
Flow edit form link |
It is the url sent by email, which redirects to the flow edit panel. |
GuestResponseLink |
Guest response link |
This URL is used in notification emails, allowing access to response forms as a guest. |
HtmlLinkTemplate |
HTML link type email template |
It indicates the file path corresponding to the html email template. |
IsGoogleAndMicrosoft
RememberSessionEnabled
|
Enable remember user session when logging in with Google and Microsoft |
If this parameter’s value is “true”, sessions created with Google or Microsoft will remain logged in between browser sessions. If it is “false”, the session will end once the browser is closed. Make sure you have configured your browser to remember cookies, otherwise this will not work. |
IsGoogleSignInEnabled |
Enable Sign-In with Google |
If this parameter’s value is “true”, Qflow will allow users to authenticate with their Google account in the different sites. Otherwise, this option will not be displayed. |
IsMicrosoftSignInEnabled |
Enable Sign-In with Microsoft |
If this parameter’s value is “true”, Qflow will allow users to authenticate with their Microsoft account in the different sites. Otherwise, this option will not be displayed. |
LicenseExpiration
AlertThreshold
|
License expiration alert |
It is an integer that indicates how many days before the expiration of the licenses, users will be notified that they are about to expire. By default, it has a value of 7, that is, it warns the users a week before expiration. |
Logo |
Logo |
It’s the image of the logo that will be used in the different login views. The aspect ratio has to be 4:1 for the image to show up properly. |
LogoLightVersion |
Light version logo |
Light version of the Qflow logo. The aspect ratio has to be 4:1 for the image display properly. |
MailLogo |
Mail logo |
It is the url of the logo image that will be displayed in the different emails sent by Qflow. The image must be in png, jpg or jpeg format for it to be displayed correctly. |
MiniLogo |
Mini logo |
Image for the website’s collapsed sidebar logo. The aspect ratio has to be 1:1 for the image to be displayed properly. |
NotifyUserOnCreation |
Notify the user on creation |
If this parameter’s value is “true”, a notification will be sent to each user that is added to the workspace |
OrganizationName |
Organization name |
It indicates the organization’s name. This name is used by Qflow to control product licenses. |
RenewSessionAutomatically |
Renew session automatically |
It indicates whether Qflow tools, both desktop and website versions, must automatically renew the user’s session when it expires. |
ResponseLink |
Response link |
It is the URL used in response forms’ links of each message sent by email. |
SessionLeaseTime |
Session lease time |
The duration in minutes of a Qflow user’s session. If there is no activity during this time, the session expires, and the user must authenticate again. |
StageLink |
Stage link |
It is the url used in the monitoring of stages’ links in the messages sent by email. |
StartFlowAsGuestLink |
Guest response link |
It is the URL used to start a flow as a guest. If workspaces are identified by base URL, ‘{tenantName}’ is replaced by the workspace base URL, otherwise ‘{tenantId}’ is replaced by the workspace identifier |
StrongWindowsSinchronization |
Strict Windows user synchronization |
If this parameter’s value is “true”, removing a user from Active Directory will change the Qflow login to allow another user to use the original login. |
TaskLogo |
Task logo |
Task site logo image. The aspect ratio has to be 4:1 for the image display properly. |
TaskMiniLogo |
Task mini logo |
Image for the Task logo used in the site’s collapsed sidebar. The aspect ratio has to be 1:1 for the image to display properly. |
Theme |
Theme |
It indicates which theme to use in Qflow Task. |
UndoChangesOnStepBack |
Reverse changes on step back |
It indicates whether, by reversing a thread in a process, changes made to application data, roles and attachments must be undone in the steps whose execution is being undone. |
UseGravatarForProfilePicture |
Use gravatar for profile picture |
If this parameter’s value is “true”, the gravatar service will be used to obtain the profile picture of the users. Otherwise, an image with the user’s initials will be displayed as a profile picture. |
- *
Parameter only available on Cloud.