--- title: "Using Process Folders" slug: "using-process-folders" updated: 2025-06-24T19:39:02Z published: 2025-06-24T19:39:02Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Using Process Folders ## Overview Process Folders are one of the core functions of maintaining audits trails for state-driven processes. They can keep track of a folder's state and any user comments within them. Users can add a comment to a newly created Process Folder in a Flow or retrieve a pre-existing Process Folder and add a comment to that record. ## Adding a Comment 1. Navigate to a Designer Project folder. Right-click the folder and select **Create Folder**. Click CREATE and name the new folder "Process Folder Data". Click CREATE. **![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_10h36_29.png)** 2. In the Designer Project folder, click CREATE FLOW. Select **Flow**, name the Flow, and click CREATE. 3. In the Flow Designer, click the **Done**path on the **Start**step. Navigate to **All Steps [Catalog[ > Process** and select the **Setup Process Folder** step. Click ADD.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750772805172.png) 4. On the **Properties**panel, click PICK under the **Parent Folder**field**.** Select **Process Folder Data**and click PICK.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750772894717.png) 5. On the Properties panel, enter **Constant**values for **Folder Description** and **Folder Name**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750773064170.png) 6. Click the Done path and navigate to **All Steps [Catalog > Process**. Select the **Add Comment**step and click ADD.This Add Comment step is meant to be used after the 'Setup Process Folder' step. The Add Comment step must be used in tandem with the 'Setup Process Folder' step. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750773164721.png) 7. On the Properties panel under the INPUTS category, enter "This is a comment" for the **Comment**field and "Comment 1" in the **Name**field. Connect the Done path to the **End**step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750773265143.png) 8. Click **Save**to save changes. Click **Debug**on the top action bar, then click START DEBUGGING to create a record in the Process Data Folder. 9. Navigate to the Process Folder Data and click on the newly created Process Folder. The PROCESS VIEW page will display the created comment. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_10h48_48.png) ### Adding a Comment via Internal Services This example will use the Add Comment step from the Internal Services category to add another comment to the previously created Process Folder. 1. In the Designer Project folder, click CREATE FLOW and create another Flow. 2. Click the Done path of the Start step. Select the **Fetch Entities** step and click ADD. 3. On the Properties panel, enter "folder" in the **Type Name** field under the ENTITY FETCH DEFINITION category and select **Folder [DecisionsFramework...]**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750773407023.png) 4. Set the Parent Folder Id to a constant and pick the Process Folder Data folder.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750773484887.png) 5. Click the **Results**outcome path. Navigate to **Integrations > All Integrations > Internal Services > Comment**and select the **AddComment**step. Click ADD. 6. Under the INPUTS category, click **Unknown**next to the **entityid**field and select **Select From Flow**. Click **EntityResults**, select **First**, and select **Folder ID**. Click DONE. For the **comment**field, set the mapping from Unknown to **Build Data.**![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750775498955.png) 7. Scroll down and configure the Comment Name and Comment Description fields with constant string values. The Comment Name is the Data member which stores the title of the comment. The Comment Description, stores the comment text. Declare constant string values for those inputs.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750775581347.png) 8. Connect the Done path of the Add Comment step and the No Results path of the Fetch Entities step to the End step. Click Save to save changes. 9. Debug the Flow to have the comment created and applied to the Process Folder. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750775773582.png) 10. Navigate back to the Process Folder Data and click on the Process Folder. 11. On the PROCESS VIEW page, the second comment can be found underneath the first comment. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-20_12h18_52.png) --- ## Saving a Document to a Process Folder Process Folders can also have documents stored within them. This example will demonstrate how to configure a Flow to store a document in a Process Folder. 1. Right-click on the Designer Project and select Create Folder. Under Create Folder, click CREATE. 2. In the Designer Project, click CREATE FLOW and select Flow. Name the Flow and click CREATE. 3. In the Flow Designer, select the **Start**step. On the Properties panel under **Flow Input Data**, click SHOW EDITOR.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750776008498.png) 4. Under NAME enter "Input File" and change the TYPE to **FileDate**. Click **Save**and close the window. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750776070808.png) 5. Add the Setup Process Folder step to the Start step from the PROCESS category on the **Toolbox**panel. 6. Set the Parent Folder to the created folder. Set the Folder Name to "Saved Folder" and the Folder Description to "Saved Description".![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793043238.png) 7. Click the Done path. Navigate to **All Steps [Catalog] > Process** and select the **Add File** step. Click ADD.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793110692.png) 8. Map **InputFile.Contents** to the **Data** input field. Enter "Test File" in the **Name**field.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793191097.png) 9. Connect the Done path to the end step. Click Save to save changes to the Flow. 10. Debug the Flow to create the Process Folder and add a file. 11. Navigate to the Process Folder Data and select the folder. The file should be found in that folder on the Folder Activity Panel and in the Document Header. Depending on the file type there will be actions to Download, Update, and more for the file. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-20_12h29_53.png) --- ## Setting a Process's State and Reason Process folders can be assigned a state and state reason by using the **Set State Reason** or the **Set State And Reason**step. It can be found in the **Steps** tab, under the **Process**category. This Flow step merely writes the user-defined reason string value in the Extension Data of the Process Folder. By default, it is not displayed on Process Folder when it is created. The reason value can be displayed in the Report Designer by displaying the 'State Reason' data member when reporting on the FlowTrackingFolderData data source. The **Set State and Reason**step must be used in tandem with the **Setup Process Folder**step. To set a reason on a Process Folder, configure a Flow that contains a Setup Process Folder and a Set State and Reason after it. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793263902.png) After configuring the Setup Process Folder step and debugging the Flow, a Process Folder will be created. It stores the **Status Reason** value in the FlowTrackingFolderData data source. This allows users to be able to report on it. To do this, create a Report that is sourced from FlowTrackingFolderData. Pick the Status Reason data field. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_11h51_57.png) --- ## Set State Color A folder states color can be changed by utilizing the **Set State Color** step. This changes the color of the state on the Process View Page's Folder Activity Panel. This step also needs to be used in tandem with the Setup Process Folder step. 1. In a Designer Project, click CREATE FLOW and select Flow. Name the Flow and click CREATE. 2. On the workspace navigate to the PROCESS category from the Toolbox panel. Add a Setup Process Folder step, a Set State step, and a Set State Color step to the workspace. 3. Configure the **Set State** to a constant value and make a note of that value.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793353483.png) 4. On the **Set State Color** step map the **Color**input to Constant, select a color and click PICK.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793429487.png) 5. On the **State**input, set it to Constant and make sure it matches the state value configured on the Set State step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793500856.png) 6. Debug the Flow to create a Process Folder and navigate to it. --- ## Downloading a Completed Form From a Process Folder 1. In a Designer Project, create a new Flow. 2. In the Flow Designer, navigate to the **Toolbox > PROCESS**category and drag and connect a Setup Process Folder step to the Start step. 3. In the Properties panel, locate **Parent Folder** and select PICK. Select the Folder [Process Folder Data]. 4. Navigate to the**Folder Description** and **Folder Name**fields and set the input mappings to Constant. Enter "This is the description" and "Folder Name."![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793631444.png) 5. Add a **Show Form** step from the FAVORITE STEPS section and connect it to the Done path of the Setup Process Folder step.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793692947.png) 6. In the Properties panel of the **Show Form** step, click PICK OR CREATE FORM. Click CREATE. In the **Create New** window, select Form, name it, and click CREATE. 7. In the Form Designer, add a**Button** (Done), a **Check Box** (Can You See Me?), and an **Image** component. Click Save and close the Form Designer. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_12h19_23.png) 8. In the Flow Designer, set the **Assignment Type**to **Assigned**. 9. Assign the Form and add an **Assignment Name**and assign a name for the action to be taken on the Assignment. 10. Set the fields in INPUTS to **Ignore**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1750793912755.png) 11. Connect the Done outcome of the Show Form step to the End step. 12. Select Debug from the top action panel. 13. Complete the Form after the debugger runs. Navigate to **Process Folder Data** and select the process data. 14. On the PROCESS VIEW page, select VIEW COMPLETED FORM to see the Form. 15. In the**View Completed Form** window, click **Download.** **![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_12h24_44.png)** --- Related Information Training Video: [Handling Comments](https://www.youtube.com/watch?v=SVEmD2cWF6E) For further information on Flows, visit the [Decisions Forum](https://community.decisions.com/categories/Flows).