Introduction

Learn to use process collections

Last published at: July 27th, 2024

This function allows shareable process collections based on the User's access role. These collections are built using filters and saved within the application.  The process instances are filtered using the following criteria and conditions
•    Based on process definition or definitions
•    Based on status, single, multiple or all
•    Based on a date range, last week, this month, custom dates, our standard UI date filter

You can navigate to the Run - Process Collections menu option. 

 

The Process Collections page is rendered as follows. 

 

Create a process collection.

On the Manage Process Collection page, navigate to the Actions - Create menu option. 

 

A popup window appears for configuration as below. 

 

You must provide the collection name and description text here. 

 

Next, you must select the application role(s) from the drop-down list for access. 

 

You may select more than one application role from the list below. In this example, the users of these application roles (All Users, Development, and Finance) can access the MyCollections. 

 

Next, you must select the process definitions from the drop-down list below. As FlowWright administrator, you can fetch the names of all process definitions in the application. The process instances of these definitions shall be grouped in MyCollections. 

 

You must select one or more process definitions from the list below. In this example, three process definitions are selected for MyCollections. 

 

Next, you must select the process instance's status from the list below. By selecting the checkbox, you may choose all instance statuses (Aborted, Error, ErrorWait, Executing, Completed, Not Started, Reset, Sleeping) or the necessary ones. 

 

In this example, three process instance statuses are selected for the above process definitions for MyCollections. 

 

Next, you must select the date filter from the list below. The process instances that are generated around the date filter value are considered. 

 

In this example, the process instances generated this month are selected for MyCollections. The owner can mark this process collection as Private by clicking the Shared checkbox. Click on the Create button to confirm the configuration. 

 

The process collection is created, and a confirmation message is displayed in the top right-end corner. 

 

Once collections are created for the Administrator, they are shown below with all Actions enabled. You can use the filter designed to view the collections you, the Owner, made. Using the Collection Link, you can view the process collection instances on a new page.  Note: For non-admin users, collections are shown based on two categories, “Created” and “Shared,” and a switch is provided to toggle.

 

You may use the filter Shared to view the collections you shared as the Owner.

 

View the process collection and its filter criteria.

Select the collection from the Manage Process Collection page list and navigate to the Actions - View menu option.

 

The table below displays the process collection of instances belonging to the configured process definitions, with the created date matching the date filter and accessible as per the User's application role. The process instances can be selected from the list to perform other operations like Rendering, Exporting, Importing, Viewing, etc. Any new instances created from this page are defaulted to the process collections group. 

 

Click on the View Filter icon marked in red to view the criteria. 

 

The collection filter criteria are displayed in the popup window for you to refer to below. 

 

Export and Import the process collections.

You may move the process collections between the FlowWright environments using the Export and Import function. 

Select the collection from the Manage Process Collection list and navigate to the Export menu option. You may choose the XML option; the file is downloaded to the local folder after export.  

 

Select the collection from the Manage Process Collection list and navigate to the Export menu option. You may choose the SQL option; the file is downloaded to the local folder after export.  

 

To understand the file contents, edit the downloaded SQL file using Notepad. The text contains an SQL insert statement to create the process collection and its configurations when executed. 

 

On the Manage Process Collection page, navigate to the Import - XML menu option. 

 

You must choose an XML file from the local folder and click the Update Collection XML button to confirm.

 

After import, the process collection is made available to privileged Users, and a confirmation message is displayed in the top right-hand corner. This import function overwrites any existing process collection by the same name. 

 

Edit the process collections.

You may modify the process collection configuration to accommodate changes like new process definitions or application roles. 

Select the collection from the Manage Process Collection list and navigate to the Action - Edit menu option. 

 

The popup window is displayed for configuration. You may change the collection name or description, add/remove user roles, add/remove process definitions, etc. Click on the Update button to confirm the changes. 

 

Copy the process collections.

You may make a copy of the process collection configuration using this function. 

Select the collection from the Manage Process Collection list and navigate to the Action - Copy menu option. 

 

A popup window is displayed for configuration as below. You must provide a new process collection name and click the Copy button to confirm. 

 

A copy of the selected process collection is created, and a confirmation message is displayed in the top right-end corner. Click on the Collection Link of the new process collection from the list, and the process instance page will be rendered on a new tab. 

 

Next, click the View Criteria link in the popup window to verify the filter configuration. 

 

 

Remove the process collections.

You may remove the process collection configuration if it`s unnecessary. 

Select the collection from the Manage Process Collection list and navigate to the Action - Remove menu option. 

 

 

A popup window is displayed for confirmation. Click the Remove button to confirm. 

 

The process collection configuration is removed from the list, and a confirmation message is displayed in the top right-end corner.