Using Power Shapes

What are power shapes? 

Power shapes are custom applications that you can build for ProcedureFlow using JavaScript and React. Once you have configured, built, and uploaded your power shape, it can be embedded in any of your flows as a new shape.

By using power shapes, you can add functionality to your flows to meet specific use cases. Power shapes can integrate with external systems to enable custom workflows, such as pulling data from third-party APIs, or function as self-contained solutions for simpler use cases, such as a calculator. 

Please refer to our developer guide details on building power shape applications. We can also provide test files that demonstrate how to build power shapes using ProcedureFlow’s component library. 

Installing your app 

Once your power shape has been built and uploaded using the Personal Access Token and App ID, an Org Admin can install the power shape and associate it to the appropriate entry points.  

  1. Log in to ProcedureFlow as Org Admin 
  2. Click Administration at the top of the page, then click Developers > Apps and select your app. 

  3. Click Installation in the left menu and then click Install app on this organization.

  4. Choose the entry points that you want this power shape to be available in, and then click Install.

You can now embed this power shape in any flow in any of the entry points it has been installed on.  

Adding the power shape to a flow

A power shape can be added to a flow the same as any other shape, provided the app has been installed on the entry point. This can be done by any users with Contributer role or higher.

  1. Open or create a change request and navigate to the flow you want to add the power shape to.
  2. Add a new action shape to the canvas.
  3. In the Add Shape dialog box, select the App tab.

  4. Select your app from the dropdown, enter your Text and click Add. 

  5. Save and close the flow. The shape is added to the flow and can be identified as a power shape by the lightning bolt icon in the top right corner:

Tip In the change request, you can click on your power shape within the flow to test it.

Limitations

If an app providing a power shape is uninstalled or loses access to the flow's entry point, the power shape in the flow will no longer function correctly. ProcedureFlow will display appropriate UI cues, such as errors or icons, to indicate that the power shape is no longer available. 

This applies to loss of connectivity as well; power shape will not work with offline backups.