Workflow

Locating the Workflow feature

Anyone in a Role with the Edit Workflow privilege can navigate to the Workflow by opening the PROGRAM DESIGN menu and clicking on the Workflow button.

How to create and edit the Workflow

The Workflow is the backbone of operations – the process defined in this tool will support many other aspects of the Program, including user behavior, Form Configuration, Automations, Communications, Deadlines, and more.
 

To create a new status within the Workflow scratchpad, click the Create New Status button in the upper left section of the Workflow screen. You will be asked to name your new status as shown below:

 
At any point, you can click on a Status and choose to rename it by clicking ‘Edit’.
 

Transitions

Status transitions are important because they dictate where PowerClerk can move projects via Automations and Deadlines.
 
Status transitions are easily configured by dragging and dropping. To create a new Status transition, double click the area within a Status rectangle, a green dotted border will appear. Then, left-click and hold while dragging to any other Status. When the second Status’s rectangle turns green, you can release your left mouse button, and a new Status Transition will appear. Note that orange Always Available statuses can be entered from any other status, therefore transition lines to them are unnecessary and therefore prevented.
 

 
Statuses can be rearranged by clicking and dragging, and the view can be zoomed in and zoomed out using the buttons in the top-right of the screen or using the mouse scroll wheel. Combining these two actions can help make the Workflow more visually appealing.
 

Figure 6: Arranging Statuses

 
To select and move a specific set of statuses (not necessarily close in proximity) hold the shift key and click the statuses one at a time. To move a collective group of statuses (within the same proximity) hold the shift key and define the area for selection.

 
To delete a Status or Status transition, click the Status Name then click the Delete button. After you are done making changes, click the save button to commit the updated Workflow to the program.
 

 
The Statuses that comprise the Workflow will be externally visible to users with View-access to a Project, so Status naming should intuitively imply what action is required. PowerClerk automatically saves a date-time stamp each time a project enters a Status, making it straightforward for the administrator to report on time spent in each Status or Workflow segment.
 

Workflow Example Overview

See below a complex example of a Workflow that can build within PowerClerk to reflect the requirements of your utility program:
 

Figure 10: Complex Workflow example

The above Workflow is composed of statuses and status transitions. Each status is represented by a rectangle. The text inside the rectangle is the status name, which can be changed at any time by selecting the status and clicking the Edit button (1).

The status’s color can represent one of two things (2): if the status is blue, the status is considered conditionally available, and any project that needs to enter that status must follow the available paths in the Workflow to get there. If the status is orange, that status is always available, which means any project can enter this green status from any other status, even if there is no status transition between the two.

The lines with arrows between statuses represent status transitions. These form the rules of the Workflow, which will be translated into PowerClerk’s code anytime the Workflow is saved. As can be seen in the screenshot above (3), if there is no transition between the Awaiting Documentation and Set Meter Request Pending, an application reviewer cannot skip over the Inspection Pending status – they must follow the allowable paths represented by status transitions. To create a new status, use the Create New Status button (4) and type a new status name. Note that each status must have a unique name.

Video Guides

Edit Workflow

This video guide will show you how to edit your PowerClerk program’s Workflow.

 
 
A full list of all Video Guides can also be found here.

FAQs

Q: I am running out of space designing my Workflows, what can I do?

A: statuses can be rearranged by clicking and dragging, and the view can be zoomed in and zoomed out using the buttons in the top-right of the screen. Combining these two actions can help make the Workflow more visually appealing. To delete a Status or status transition, simply select the object and click the Delete button(found near the bottom of the screen). After you are done making changes, click the Save button to commit the updated Workflow to the program.

Workflow Zoom

Q: Can I set the length of an incentive program to something other than 5 years?

A: Within PowerClerk please click on Program Design and choose menu option Incentive Design.
If you click Edit Design for an editable existing incentive or create a new Incentive Design, you will see that the Incentive Length field is editable and can have any value from 1 to 30 years.
In this same dialog you can also set other fields, such as Annual System Degradation. As the note on the page explains, that is a value indicating the percent by which the system production calculation should be reduced each year in calculating the estimated incentive amount. The default for this input is 0.0% -- no reduction. Note that it is a measure of the amount of reduction each year; so a value such as 0.5% would be typical.

Q: I am done setting up our program in the sandbox environment - how can I release our program to production?

A: Clean Power Research will take a snapshot of the program you want to move and then set that up on the production environment. We normally reserve 5 days just to give us some leeway in case there’s a problem and a hard deadline. You can keep using the sandbox environment during that time, but any changes you make there will not be reflected in the snapshot we took and hence any changes will need to be repeated in the production server.
Outside of that, the production server is just like the sandbox – nothing is set in stone, or needs to be final-final before going to the production server, you can make changes before and after you open it to the public.

Q: I added, enhanced, or improved an existing application Workflow, but have several unsubmitted applications. Is it possible to do a mass promotion on the Interconnection Request Application form?

A: We recommend not to utilize mass promotions for customer-facing forms, for the following reasons:

1. If an application isn’t yet submitted and you’ve added fields, those pop up towards the person filling out the form out of the blue, potentially on pages that were considered completed and now are not
2. Applications that have been submitted and got new required fields added now make an admin go “how did this get submitted without the field being filled out? It’s required after all!”
3. Applications that have been submitted and are being viewed by the user that filled it out now have fields, conceivably with values that an admin filled in later, that the user never submitted.

To help out utility customers that have a form that’s effectively faulty, we can target certain form versions and promote those. That is typically used for utility-internal forms (usually those that guide the admins through the process – if there’s a mistake on that, the form needs to change for all projects). If we used that, yes it would apply to the Unsubmitted applications.

Q: Is it possible for an Applicant to be in more than one status at a time?

A: A project can only be in one status at a time. An applicant (typically an installer/contractor) may have more than one project open in PowerClerk at the same time and these projects can be in different statuses.

Q: If a status in our Workflow leads to multiple other status options, can I manually select which status to move the Applicant to next?

A: Admins with access to the Admin View can manually select which status to move an applicant (see screenshot below).

Screenshot: Change status dialog

Formulas and Automations may also be utilized so this occurs automatically. For example: If Applicant A, should be placed in Status B because their system size is greater than 5 kW you would create a formula (system size is > 5 kW) which would then be combined with an Automation triggered by the submission of a form and an Action Rule that puts the project in Status B when the formula is true.

Have additional questions? Contact us to nominate your FAQ and help others find answers to your own questions concerning this feature.

Create A Support Ticket

Not finding your answer here?  Submit a question to our support team at the PowerClerk Ticket System and leverage the PowerClerk team’s expertise.