Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 start started developing your own workflows and connectors right away. This topic walks you through the steps.

Info

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

How to install Workflow Studio

...

Navigate your browser to https://empowerid.visualstudio.com/EmpowerID/_git/EID-Tooling?path=%2FPSScripts%2FWorkflowStudioInstaller&version=GBmaster.

...

Authenticate using the credentials given to you by your organization.

...

Download the Install-WorkflowStudio_EID-Release.ps1 and Uninstall-WorkflowStudio_EID-Release.ps1 PowerShell scripts.

...

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.

...

  1. Image Added

...

Enter the EmpowerID Version Number for which you are installing Workflow Studio and press ENTER.

...

  1. During the installation process, when requested to designate the EmpowerID Install Directory,

...

...

Wait for the script to download and install any dependencies that you may not have on your workstation.

...

...

When prompted to enter a file for the public/private rsa key pair, press ENTER to accept the default or enter another location as desired.

...

...

Enter a passphrase for your personal key and then enter it again.

...

...

You should see notepad open with the key. Copy the key.

...

...

Log in to Azure, click the User Settings icon and select SSH Public Keys.

...

...

Click New Key.

...

...

Enter a Name for the key and then paste the key you copied earlier into the Public Key Data field.

...

Click Add.

...

...

Back in PowerShell, enter y when asked if the SSH public key is added to Azure DevOps and then press ENTER.

...

...

Enter your passphrase and then press ENTER.

...

Wait for Workflow Studio to be installed.

...

...

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

...

...

  1. 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.

    Image Added

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

  3. 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'.

    Image Added

  4. Create a shortcut for the exe as needed.

  5. Open Workflow Studio.

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

    Image Added

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

  8. Authenticate and close your browser.

    Image Added

Info

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.

    Image Added

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

Tip

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.

    Image Added

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.

Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue