Install Workflow Studio

Owned by Phillip Hanegan
Last updated: Nov 09, 2023
3 min read

Workflow Studio is the process designer and developer application used by EmpowerID to create workflows, connectors, and other design items. As a developer, you can install Workflow Studio on your Windows workstation and get started developing your own workflows and connectors right away.

Installing Workflow Studio involves executing PowerShell scripts. Before executing the scripts, please ensure that there is no interference from your execution policy.

Procedure

  1. Utilize 7-Zip or an alternate file extraction tool to unzip the Workflow Studio ZIP file directly into the root of your chosen drive (e.g., C:\) to manage long file names effectively. The EmpowerID team recommends this approach to handle long file names effectively. Afterward, you have the option to relocate the files to a directory of your preference.

  2. Open Windows PowerShell in Admin mode and navigate to the folder where you downloaded the PowerShell scripts.

  3. Run the Install-WorkflowStudio_EID-Release.ps1 script.

     

  4. During the installation process, when requested to designate the EmpowerID Install Directory, enter the path leading to the primary folder that will contain the EmpowerID application. If, for example, the intended location of EmpowerID is C:\TheDotNetFactory\EmpowerID, then C:\TheDotNetFactory should be specified as the Install directory.

     

  5. You should see that Workflow Studio has been successfully installed. You can close PowerShell.

  6. Navigate to the programs folder and find the file named "EmpowerID.BPM.Studio.exe.” Perform a right-click on this file, and from the dropdown menu, choose ‘Properties.’ This will open a new window where you should select the 'Compatibility' tab. In this tab, look for the option that says "Run this program as an administrator" and check the box next to it to enable this setting. To finalize and apply these changes, click 'OK'.

     

  7. Create a shortcut for the exe as needed.

  8. Open Workflow Studio.

  9. If prompted, enter the Web URL for your EmpowerID environment and click OK.

     

  10. Your browser will open and direct you to the EmpowerID login page for your organization.

  11. Authenticate and close your browser.

     

Workflow Studio is designed to retain your login information, eliminating the need for repeated authentication each time the application is launched. Should you decide to modify this behavior, you can erase your stored credentials by following these steps:

  1. Right-click on the root node of your workspace within the application.

  2. Choose App Settings from the context menu.

  3. In the settings menu, locate and deselect the Remember my Login option.

This action will prevent Workflow Studio from automatically logging you in during subsequent sessions, prompting you to enter your credentials manually.

For custom application development that requires Workflow Studio to interface with a repository different from the default, you may alter the path of the local repository as follows:

  1. Right-click on the workspace root node within Workflow Studio.

  2. Choose App Settings from the context menu.

  3. Within the settings, click Set Local Repository Path.

Performing this action will close Workflow Studio and initiate a restart. Upon restarting, Workflow Studio will prompt you to choose the new repository path. Select the desired path to continue working with the new repository configuration.