Description:

The BoxDeleteFolder step is used to delete a folder from Box as part of a FlowWright workflow.

The step provides True and False return paths, allowing subsequent workflow processing to respond to the result of the folder deletion operation.

Usage:

The BoxDeleteFolder step can be used whenever a workflow needs to remove a folder from Box as part of automated processing.

A typical workflow pattern is:

Identify Box Folder → Delete Folder → Continue Processing

The workflow specifies the target folder using its path or Folder ID and uses the selected OAuth provider to access Box.

For example, a workflow can remove a temporary folder after processing its contents.

To use this step, you must first configure Dropbox in FlowWright. Then, go to the Integrate > Connections > OAuth page to create a new OAuth source. 

A sample OAuth configuration is provided for reference. 

Typical Workflow Suggestions:

Delete Temporary Folders After Processing

Use BoxDeleteFolder after a workflow has completed processing the contents of a temporary Box folder.

For example:

Process Folder Contents → Delete Temporary Folder → Complete

This can be useful when the folder is only required during an intermediate stage of a workflow.

Clean Up Completed Project Folders

Use this step when a project-related Box folder is no longer required after the associated workflow has completed.

For example:

Complete Project Processing → Identify Folder → Delete Folder → Close Process

The folder path or Folder ID can be supplied dynamically from workflow data.

Remove Obsolete Folders

Use BoxDeleteFolder as part of an automated cleanup workflow for folders that are no longer needed.

For example:

Identify Obsolete Folder → Delete Folder → Continue Cleanup

The workflow can determine the target folder and then pass its path or Folder ID to the step.

Delete a Folder After Archiving

Use the step when a workflow archives or otherwise processes folder contents and the original Box folder is no longer required.

For example:

Process/Archive Folder Contents → Delete Original Folder → Complete

You can use the True output to continue after the deletion operation succeeds.

Clean Up Folders After a Replacement Structure Is Created

Use BoxDeleteFolder when a workflow creates a replacement folder structure and the previous folder is no longer required.

For example:

Create Replacement Structure → Process Required Content → Delete Previous Folder → Complete

The previous folder can be identified using its Box path or Folder ID.

Example:

Let’s build and execute the “BoxDeleteFolderDef” example.  

• Create a new process definition named “BoxDeleteFolderDef” and open it in designer mode.
• Drag a “BoxDeleteFolder” step to the canvas.
• Connect the dots between the “Start” and “BoxDeleteFolder” step.
• Select the line between the steps to configure the “Connection Properties”. The default property values are “None, True, False, Error, and Evaluate”. Depending on the step’s purpose, you can configure additional values.
• Define a variable or a global to store the result.
• Click the "BoxDeleteFolder" step to configure its "Required" properties. Provide a name for the step. Select the “Box” OAuth connection provider. Specify the path of the folder to delete. Provide a variable or global reference to store the result after execution. Click the Save button. Note: Click the "AI Predict" button to have the Copilot add new process steps that match your process description. 
   

• The “Logging” configuration is necessary for documentation and also measures workflow progress and percent complete. Configure the step state and percent fields individually, as shown below. Configure the “Logging” using the following properties.

• Save the process definition, create a new instance, and execute it. Render the process instance. When the workflow reaches the BoxDeleteFolder step, FlowWright uses the selected OAuth provider to access Box and identifies the target folder using the supplied Path/FolderID to delete the folder. The operation result is stored in the Variable/Global specified by Variable/Global to store the result. The workflow then follows the True or False return path based on the result of the folder deletion operation. Click the process step to view its properties. The step should delete the folder in Box.

Tips:

• Select the correct OAuth provider: Ensure that the selected provider has access to the Box folder being deleted.
• Verify the target folder: Use the correct Box path or Folder ID to avoid targeting the wrong folder.
• Consider folder contents before deletion: Ensure that required processing involving the folder has completed before executing the delete operation.
• Use Variables/Globals for dynamic folder identification: This allows the target folder to be determined during workflow execution.
• Store the operation result: The result Variable/Global can be referenced by subsequent workflow logic.
• Use both return paths: Connect the True and False outputs to appropriate workflow handling.
• Use the step as part of cleanup processing: Folder deletion can be placed at the end of temporary-folder or completed-process workflows.

Definition Sample:

You may download the sample definition(s) from the link provided and later import them (drag-and-drop) into your FlowWright Process Definition (XML file) or Form Definition (HTML file) page. 

Note: After the import, verify and complete any missing configurations, such as file path references and database connections. Then, save the definition to confirm the changes. 

Click here to download the sample file.