Repository Action Flows
  • 07 Dec 2020
  • 2 Minutes to read
  • Dark
    Light
  This documentation version is deprecated, please click here for the latest version.

Repository Action Flows

  • Dark
    Light

Article summary

Overview

A Repository Action Flow is a Flow built with the intent of performing a specific action either before or after the project creation or project check-in. Repository Action Flows can be accessed from a Decisions Repository environment by navigating to System > Administrator > Repository Actions Flows. Select the FLOW option from the bottom Action Bar and choose which type of Action Flow to create. This will not trigger the normal "Create Flow" window, this button will go directly to a Flow Designer where the actual logic for the selected type must be created.

Action Flow Types

Before Project Creation Flow

This Flow executes before a project is created on the repository and contains two Endpoints (End steps); Allowed and Not Allowed. With two separate End steps, two different paths of Flow logic can be created to assure that the appropriate criteria are met before the project can be created. This Flow only allows steps that are synchronous with the Flow, meaning elements like Tasks, Forms, and Assignments cannot be used.

After Project Creation Flow

This Flow executes after a project is created on the repository and contains just one End step. This Flow logic can be built to perform Flow functions for Repository actions, which include the use of synchronous and asynchronous Flow steps. 

Before Checkin Flow

This Flow executes before a project is checked into the repository and contains two Endpoints (End steps); Allowed and Not Allowed. With two separate End steps, two different paths of Flow logic can be created to assure that the appropriate criteria are met before the project can be checked into the Repository. This Flow only allows steps that are synchronous with the Flow, meaning elements like Tasks, Forms, and Assignments cannot be used.

After Checkin Flow

This Flow executes after a project is checked into the repository and contains just one End step. This Flow logic can be built to perform Flow functions for Repository actions, which include the use of synchronous and asynchronous Flow steps.


Once an Action Flow is selected in the Designer Repository Settings, it will be available for all projects associated with the Repository. Since these Flows are specific to the Repository, they will automatically contain Branch Name and Project Name as Flow Data. This can be accessed from the Data Explorer tab in the Flow Designer or by using the Select From Flow input mapping type when defining an input value. This is an example of a basic "Before Checkin" Action Flow use case.


Using the provided Flow data, Rules can be created and implemented into the Flow that can check against the Branch or Project data, which could determine whether the action passes to Allowed or Not Allowed.


After the Action Flow is created, it must be applied to the Repository environment by navigating to System > Settings > Designer Repository Settings. In the Repository Settings window, select the newly created Action Flow under the Repository Server Action Handlers section. Locate the Action type that corresponds with what was created, then select the Pick button to choose a Flow. Select SAVE SETTINGS once the configurations are complete; the chosen Flow will execute when the corresponding event happens in the Repository.

reposettings.png




Was this article helpful?