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.

Qflow Admin's main screen

Fig. 739 Qflow Admin’s main screen

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.

License viewer

Fig. 740 License viewer

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).

Statistics

Fig. 747 Statistics

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.

Q-points total usage statistics

Fig. 748 Q-points total usage statistics

Q-points usage by template statistic

Fig. 749 Q-points usage by template statistic

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.

Chart data grouping buttons

Fig. 750 Chart data grouping buttons

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.

Responded tasks and started flows statistics

Fig. 751 Responded tasks and started flows statistics

Q-points and enabled users statistics

Fig. 752 Q-points and enabled users statistics

Used storage statistics

Fig. 753 Used storage statistics

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).

Filters

Fig. 754 Filters

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.

System parameter listing

Fig. 755 System parameter listing

Through the buttons found above the table, a system parameter can be edited, as well as have its history viewed.

System parameters buttons

Fig. 756 System parameters buttons

Some clarifications about the listing:

  • The “Source” column references whether the parameter was taken from a database (image4) or a file (image5).

  • 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 (image6), 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.

System parameter edit panel

Fig. 757 System parameter edit panel

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.

History of a system parameter

Fig. 758 History of a system parameter

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.

User extended properties listing

Fig. 759 User extended properties listing

Properties can be added, edited or removed through the buttons located above the table.

Extended property buttons

Fig. 760 Extended property buttons

If you click on the add button, a panel will open to create the new property.

Add user extended property

Fig. 761 Add user extended 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.

Item list

Fig. 762 Item list

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.

New property in the listing

Fig. 763 New property in the listing

If the property is selected, and you click on the Edit button, the edit panel will open.

User extended property edit panel

Fig. 764 User extended property edit panel

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.

Confirming extended properties deletion

Fig. 765 Confirming extended properties deletion

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.

Extended property history

Fig. 766 Extended property history

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.

Group extended properties listing

Fig. 767 Group extended properties listing

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.

Node extended properties listing

Fig. 768 Node extended properties listing

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:

    • image9The license is valid

    • image7The license has expired

    • image8The license does not apply to the organization

    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.

Cloud licenses listing

Fig. 769 Cloud licenses listing

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.

Notification services listing

Fig. 770 Notification services listing

Using the buttons located above the table, you can view, configure, enable and disable a service.

Notification services listing options

Fig. 771 Notification services listing options

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.

Configure a notification service

Fig. 772 Configure a notification service

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.

SMTP notification service

Fig. 773 SMTP notification service

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.

Extended MAPI notification service

Fig. 774 Extended MAPI notification service

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.

Exchange web service configuration

Fig. 775 Exchange web service configuration

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.

Firebase general configuration

Fig. 776 Firebase general configuration

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.

Firebase application configuration

Fig. 777 Firebase application configuration

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

Firebase notification service

Fig. 778 Firebase notification service

Manage permissions

When you select the “Manage tool settings” option in the configuration menu, a panel will open as shown in Fig. 779.

Manage Qflow Admin permissions

Fig. 779 Manage Qflow Admin permissions

To add a user, group or security role to the set of entities that have permissions on the node:

  1. 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.

  2. 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.

Select permissions

Fig. 780 Select permissions

To edit permissions of a user, group or role:

  1. 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.

  2. 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:

  1. Select the item from which you want to remove permissions, and then click on the “Delete” button.

  2. 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.

System parameter history

Fig. 781 System parameter history

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.

Licenses history

Fig. 782 Licenses history

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.

Extended properties history

Fig. 783 Extended properties history

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.