Registering a Flow in the Service/Workflow Catalog

Last Updated: 02/01/2016 Introduced in Verision: 2.0

Flows that are registered in the service catalog can be executed by users outside of the portal, but still be controlled with the same access rules and permissions.

To add a flow to the service catalog, navigate to your Service Catalog folder, or Service Catalog category sub-folder, and select Create Flow Service Catalog Item from the Actions menu.

Note: Service Catalog was renamed in Decisions 3.5 to Workflow Catalog.

Example

Our example flow service will allow the user to create a new root-level folder and create a comment within that folder. Our example assumes that the flow to be registered has already been designed, and is called Add Comment To Folder.

result

 

In the example we will:

  1. Create a Flow Service Catalog Item.
  2. Define the name, logo, and flow to be associated with the item.
  3. Click the new item in the Service Catalog to run the flow, which displays two forms.
  4. Complete the first form to add a root folder.
  5. Complete the second form to add a comment to the folder.

We’ll begin our example by navigating to the General category of our service catalog at Service Catalog > General.

service catalog general

 
 
In the General folder’s Action menu, we will select Create Flow Service Catalog Item.
 create service catalog item
 

In the resulting Add Flow Service Catalog Item window, we will define the properties of our new flow service. Under the Service Catalog Item Information heading, in the Name field, we will type “Execute my flow”. In the Description field, we will type “This action will execute the selected flow”. To give our example flow service an icon, we will open the Icon selector.

add flow

 

In the resulting Explorer pop-up, we will select the image file branch_element.png and click the Open button.

05.-brand_element.png

Under the Flow Item Information heading, we will define the flow to be registered as a service. If we wanted to create a new flow to be registered as a service, we could select the Create Flow checkbox and create the new flow. To select an existing flow, we leave the Create Flow checkbox cleared and type text into the Select Flow drop-down list. We will enter “add” in the Select Flow drop-down list and select Add Comment To Folder.

pick element

 

This completes our flow service definition, so we will click Save.

save

 

Back in Service Catalog > General, we will find our new flow service – Execute my flow – labeled with the icon we defined. We will test our new service by clicking the entity.

execute my flow

 

In the resulting pop-up, we see the first of two forms. In the Folder ID, we will type “1234”. In the Folder Name field, we will type “My Root Folder”, and then click Done.

execute flow

 

In the second form, we will select the Comment Title field and type “Comment under root folder”. In the Comment Description field, we will type “This comment gets added under root folder” and click Done.

comment

 

Back in the portal, we will see a new root-level folder called My Root Folder. When we navigate to this folder, we see that it contains the comment we defined – Comment under root folder.

result

 

Additional Resources