Interacting With Folders Via Flow

Overview 

To add an additional layer of flexibility, the Flow Designer offers users the ability to interact with and alter various Properties of a Folder/Designer Project from a Flow via the steps in the FOLDERS Toolbox category.

Such steps provide abilities to alter the Folder Name, Delete a Folder, or pass in a List of information associated with a Folder into a Flow. The following document demonstrates explains the function and proper configuration of these steps.

Create Sub Folder 

The Create Sub Folder step is used to create a Sub Folder within a desired Folder or Sub Folder (regular Folder, not a Designer Project) in the Decisions Studio.

1. From the Flow Designer, navigate to Toolbox > SYSTEM > FOLDERS and add a Create Sub Folder step to the Flow. 
2. From the newly added step's Properties tab and under INPUTS, Constant map the desired value for New Folder Name.
   
   Under Properties > INPUTS > Parent Folder Id, change the mapping to Constant, then PICK the desired Parent Folder Id

3. Save the Flow, select the Debug link from the top Action bar, then click START DEBUGGING.

4. After the Flow runs, navigate to the Parent Folder and confirm that it now contains the configured Sub Folder. 

Delete Folder 

The Delete Folder step is used to delete a designated Folder based upon a designated Folder Id.

Get All Items In Folder 

The Get All Items In Folder step is used to pass in information regarding the contents of a designated Folder or Designer Project Id, in the form of List of EntityHeaderData.

Get Folder By Path

The Get Folder By Path step outputs data for a single designated Folder based upon a mapped in Folder Path. The resulting Output provides a look at each individual Property for the Folder.

Get Folder States

The Get Folder States step retrieves a List of each FolderState within a designated Folder. This can be used to pass in State information pertaining to Case Entities and Process Folders. 

---

List Sub Folders

The List Sub Folders step provides a List of Folder Data that details information on any Sub Folders contained within the designated Parent Folder.

Set Name and Description 

The Set Name And Description step can be used within a Flow to adjust the Name and Description values for a desired Folder.

To use the step:

1. Right-click the desired Folder/Designer Project and select Manage > Get Folder ID. Then, select Copy Text and DONE.
2. Create a new Flow; from the Flow Designer, attach a Set Name and Description step from Toolbox > SYSTEM > FOLDERS to the Start and End steps. 
3. From the Properties of the newly added step, Constant map the copied Folder Id to its respective Input. Then Constant map a value for  New Folder Description and New Folder Name. 
4. Save then Debug the Flow.
5. Navigate to, right-click the Folder, and select Manage > Set Name and Description; verify that the Title and Description have been updated with the configured values.