PowerClerk Support Center

Project Pages
Project Admin Page
Locating the Project Admin Page
How to Use the Project Admin page
Project View/Edit Page
Locating the Project View/Edit Page
How to use the Project View/Edit Page
Program Design
Automations
Questions to Ask
Locating the Automations feature
How to create an Automation
Automation Triggers
Automation Action Rules
Validation Rules
Scheduled Triggers
Troubleshooting Automations
FAQs
Channels
Questions to ask yourself
Locating the Channels feature
What are Channels?
Types of Channels
Channel Type: Mark as Child
Channel Type: Make Successor
Channel Type: Create Related Project
Channel Type: Submit Related Project
Channel Type: Project Lookup
How to create a Channel
Channel Signals and Automations
Using Channels in Test Environments
FAQs
Communications
Questions to ask yourself
Locating the Communications feature
Creating Communication templates
Finding Data Tags
Images in Communications
Sending Mass Communications
Project Attachments and Content Library Items
Smart Templates
Upgrading to Smart Templates
Upgrading when a Test Environment Exists
Broken Template Tags
Examples of Broken Template Tags
PowerClerk Mass Communication Policy
FAQs
Connections
Questions to ask yourself
Locating the Connections feature
What are Connections
How to Create a Web Connector
Define the Web Connector
Connecting, Testing, and Enabling the Web Connector
Creating a Standard Web Connector Configuration
Utilizing Connections on PowerClerk
Maintaining and Editing the Web Connector
Web Connector Payload Type Format
Supported Message Versions
Error Handling
Custom List Lookup
Create a Custom List Lookup
Utilizing Custom List Lookup
FAQs
Content Library
Questions to ask yourself
Locating the Content Library feature
Uploading content to the Content Library
Use with Communication Templates
Use for Front Page content
FAQs
Custom API IDs
Questions to Ask
Locating the Custom API IDs feature
How to edit a Custom API ID
FAQs
Data Fields
Questions to ask yourself
Locating the Data Fields feature
How to work with Data Fields
Custom Lists and Data Field Groups
Table form element
PV System + batteries element
FAQs
Deadlines
Questions to ask yourself
Locating the Deadlines feature
What are Deadlines
How to Create a Deadline
Deadline Automation Action Rules
Utilizing Project Admin Page for Deadlines
Communication Templates for Deadlines
Deadline Set/Satisfy Options
Program-Wide Deadline Actions
Reporting on Deadlines
Deadlines in Project List Columns
FAQs
Document Templates
Questions to ask yourself
Locating the Document Templates feature
How to define a new Template
How to define a new Merged Document
eSignatures
DocuSign template tags
Mapping eSignature tags
Smart Templates
FAQs
eSignature Envelopes
Questions to Ask
Locating the eSignature Feature
What are eSignature Envelopes?
eSignature Checklist: The Prerequisites to create a new Envelope
How to set up Advanced eSignature Envelopes Step-by-Step
How to add an eSignature Envelope to a form
eSignature Automation Trigger
Viewing Completed eSignature Envelopes
Resending eSignature Notifications
Canceling eSignatures
FAQs
Forms
Questions to ask yourself
Locating the Forms feature
How to create and edit Forms
Adding data fields
Configuring Forms
VersaForms
Sensitive Data Fields
FAQs
Formulas and Calculated Fields
Questions to ask yourself
Locating the Formulas feature
How to work with Formulas and Calculated Fields
Formula Data Dictionary
Dynamic Formula References
Rules of Formula References
Advanced Visibility Rules
Video Guides: Formulas
FAQs
Front Page
Questions to ask yourself
Locating the Front Page feature
How to edit the Front Page
FAQs
Incentive Design
Questions to ask yourself
Locating the Incentive Design feature
How to create and edit Incentive Designs
Incentive Options for One-Time Incentive Type
Incentive Design Options
FAQs
Milestones
Questions to ask yourself
Locating the Milestones feature
How to define a Milestone
FAQs
Project List Columns
Questions to ask yourself
Locating the Project List Columns feature
How to use Project List Columns
FAQs
Project Summary
Questions to ask yourself
Locating the Project Summary feature
How to edit the Project Summary
FAQs
Project Views
Questions to ask yourself
Locating the Project Views feature
How to edit Project Views
FAQs
Roles
Questions to ask yourself
Locating the Roles feature
How to create and edit a Role
Access Groups
Access Groups and Automations
Access Groups and Data Imports
Access Groups and Reports
FAQs
Workflow
Questions to ask yourself
Locating the Workflow feature
How to create and edit the Workflow
Transitions
Workflow Example Overview
FAQs
Administration
Announcements
Locating the Announcements feature
Creating an Announcement
Triggering an Announcement
Managing Announcements Topic List
Managing Announcement Topic Enrollment Via User Account
Prerequisites for Using Announcements
Business Days
Questions to ask yourself
Locating the Business Days feature
Setting up Business Days
FAQs
Dashboards
Questions to ask yourself
Locating the Dashboards feature
How to create widgets in your Dashboard
Other Dashboard Actions
Data Import
Questions to ask yourself
Locating the Data Import feature
Steps to Complete a Data Import
Data Import Configurations
Column Header Types
Automatic Data Imports via SFTP
Revert Data Imports
FAQs
Duplicate Check
Questions to ask yourself
Locating the Duplicate Check feature
How to use Duplicate Checks
FAQs
Import Projects
Questions to ask yourself
Locating the Import Projects feature
How to Import From V2
FAQs
Operation Status
Questions to ask yourself
Locating the Operation Status feature
How to use the Operation Status feature
FAQs
Program Info
Project Inquiry
Locating the Project Inquiry feature
How to edit the Project Inquiry Settings
Automating Communications for Project Inquires
Inquiry Summary
Questions to ask yourself
Locating the Program Info feature
How to edit the Program Info menu
Notification Banners
Usage Info
FAQs
Program Statistics
Questions to ask yourself
Locating the Program Statistics feature
How to use Program Statistics
FAQs
Reports
Questions to ask yourself
Locating the Reports feature
How to setup Reports
Multi-instance reports
Sharing Reports
Integrate scheduled Reports
Cross-Program Reports
FAQs
User Administration
Questions to ask yourself
Locating the User Administration feature
How to work with User Administration
FAQs
Test Environment
FAQs
Questions to ask yourself
Locating the Test Environment feature
How to setup a Test Environment
Tools Menu
My Account
Questions to Ask
Locating the My Account feature
How to use the My Account feature
Setting up Multi-Factor Authentication
Missing, lost, or stolen mobile devices: resetting Multi-Factor Authentication
Disabling Multi-Factor Authentication
Recovery Guidelines for MFA Administrators
FAQs
FormSense
Questions to Ask
Locating the FormSense feature
How to use the FormSense feature
FAQs
Grant Access
Questions to Ask
Project Grants vs Broad Grants (i.e. "Grant Access")
Locating the Project Grant feature
Locating the Grant Access feature
How to use the Grant Access feature
FAQs
Integration Guides & API
ePayments
Questions to ask yourself
Locating the ePayments History feature
How to add ePayments
FAQ
PowerClerk API
Questions to Ask
What is the PowerClerk API?
What can the PowerClerk API do?
Integrating with the PowerClerk API
API Documentation for Developers
Single Sign On (SSO)
Questions to Ask
PowerClerk SSO Configuration
Azure AD Configuration (SAML)
Azure AD Configuration (OIDC)
Okta IDP Configuration (SAML)
SP Configuration
SSO for multiple programs
IDP Configuration Troubleshooting
FAQs
Integration Guide 001: How to configure an ArcGIS Connector – ArcGIS Implementation
Integration Guide 002: How to configure Electric Power Research Institute’s (EPRI) DRIVE Connect software with PowerClerk
PowerClerk Video Guides
Setting up Roll-up Reports
New User Video Guide
Configuring Forms
Roles and User Administration
Setting up Business Days
Formulas and Advanced Visibility Rules
Visualize Workflows
Dashboards
ArcGIS
FormSense
API
Edit Forms - Tutorial #1
SFTP Automatic Data Import
Calculated Fields
Web Connector Setup
Build A Formula
Milestones
Edit Forms - Tutorial #2
Project Summary
Automation with Formulas in Action Rules
PowerClerk Program Launch
PowerClerk User Group Sessions (UGS)
Learning Management System (LMS)
Join us for Reflow!
NEW: PowerClerk Certifications

Communications

Engage and inform your applicants with powerful Communication Templates.

Communications feature


Questions to ask yourself about Communications:

Who needs to be notified with this email? An individual or a group?
When should they be notified?
What information should this email contain?
Does this email need to contain any attachments?

Locating the Communications feature

Anyone in a Role with the Edit Communications privilege can navigate to the Communications screen by opening the PROGRAM DESIGN menu and clicking on Communications:

 

Locating the Roles feature

Figure 1: PROGRAM DESIGN >> Communications

 

How to create a Communications Template

Create a new Communication Template by clicking the New Template button:

 

New Template

Figure 2: New Template

 

The Communication Editor is a fairly straightforward, rich HTML editor. It allows a user to enter and format text, insert hyperlinks, insert images (referenced by an image-URL), and more:

Communication Editor

Figure 3: Communication Editor


 

Finding Data Tags

For this Communication Template, we want to send a confirmation email to the applicant to verify that their project application has been submitted successfully. We want to include their Project Number using a Data Field Tag and send it to their email address, which will also be populated using the Data Field Tag for their email-address.

By navigating to PROGRAM DESIGN >> Data Fields you can search all available Data Field references for your program.

 

Available Data Fields

Figure 4: Available Data Fields


The Data Fields page lists all available Data Fields in your PowerClerk program. See below the Data Field reference for Applicant Email. The actual Data Field Tag is embedded as “{data: Applicant Email}” within the Communications Template. PowerClerk will automatically populate the actual email address value when this template is sent. Note that some Data Fields types, like User types, will require that the embedded tag references the email field (“{email: User Selector}“), not the full name or other attribute.

To reference the Project Number, which is one of PowerClerk’s Built-in Fields, embed “{ProjectNumber}” into the Communication Template. Your Communication Template should now look like this:

 

Communication Template with Data Field references

Figure 5: Communication Template with Data Field references


Please note: Upon sending this Communication Template, these two Data Field references will resolve to their actual values:

 

Communication Template showing actual reference values

Figure 6: Communication Template showing actual reference values


When you are done editing your Communication Template for use, uncheck at the bottom of the template Mark Template as Draft and click the Save button. Leaving Mark Template as Draft checked will still save your template for later editing but will not yet be available for use.

 

Saving the Communications Template

Figure 7: Saving the Communications Template


 
 

Mass Communications via Data Import

Please follow this link to learn more about sending mass communications to notify applicants of notable events through the Announcements feature.
 
Please review our policy on mass communications here prior to performing a data import.
 

Images in Communications

Any images that need to be embedded in the email body of a Communication Template must have an image URL to properly populate. To embed images in a Communication Template (e.g. Company Logo) select the Insert/Edit Image icon and insert the image URL. It is recommended that Communication Template Images be uploaded to the Public Folder of PowerClerk’s Content Library, where an Access URL will be automatically generated for use within Communication Templates.
 

Image Access URL from Content Library

Figure 9: Image Access URL from Content Library

 
 

Using Access URL to Embed Image in Communication Template

Figure 10: Using Access URL to Embed Image in Communication Template


 

Project Attachments and Content Library Items

Attachments can also be included in your communication templates. There are two options for incorporating attachments to Communications Templates: Project Attachments and Content Library Items.
 
Project Attachments:

  • Project Attachments allow you to choose an Attachment Data Field embedded on a PowerClerk form.
  • Project Attachments will be project specific. If an Attachment Data Field included on a Communication Template is populated on a form for a project, that attachment will then be included when the Communication is sent out.

Content Library Items:

  • Content Library Items allow you to choose from uploads in the Public and Private Libraries.
  • Content Library Items used as attachments will include the same item as an attachment for every project when the Communication is sent.


Please Note: The maximum cumulative attachment size for a given Communication is limited to approximately 7 MB. If the attachment(s) exceeds this limit, the Communication may fail to send.
 

Smart Templates

With the introduction of Smart Templates, PowerClerk has made it easier for Program Designers to create and maintain Document Templates and Communication Templates. Once you upgrade your templates to Smart Templates, PowerClerk will track all the Data Fields, Data Field Groups, and Attachments that your templates reference via Template Tags. Smart Templates will behave the same as the current templates when used, so the change will be invisible to your users.
 
Smart Templates simplify the Program Designer’s job in the following ways:

  1. Early Error Detection:
    • PowerClerk will alert you to common errors in your templates as soon as you upload a new Document Template or save a Communication Template.
  2. Automatically Update Templates when Renaming Fields:
    • If you change the name of a Data Field referenced by a Smart Template, the Smart Template will automatically update to reflect the new name.
  3. Improved Data Field Reference Tracking:
    • Once all your templates are upgraded, the Data Field List Page will display new columns showing the Communication Templates and Document Templates referencing each Data Field, Data Field Group, or Attachment.
    • These new columns will appear once all templates of the respective type have been upgraded.
    • PowerClerk will block you from archiving fields that are referenced by a Smart Template.

Upgrading to Smart Templates

In order to take advantage of Smart Templates, you need to upgrade your existing Document Templates and Communication Templates. You will start the process by going to either the Document Templates page or Communications page under the Program Design menu. You can choose to have PowerClerk try to upgrade all your templates automatically by clicking the “Upgrade All Templates” button, or you can upgrade templates one-at-a-time by clicking any un-upgraded template in the table and clicking the new “Upgrade” button. You must upgrade your Communication Templates and your Document Templates separately.
 
You must upgrade all templates of a given type to see which templates of that type reference a given Data Field on the Data Field List Page. Once you begin upgrading templates, it is recommended to finish upgrading all templates as quickly as possible to avoid confusion that could arise when some templates are upgraded but others are not. For instance, if you rename a field, the upgraded templates that reference the field will automatically update to reflect the new field name, but the un-upgraded ones will not. If you have old templates that are no longer in use, you can choose to delete them rather than upgrade them.

 

Upgrading when a Test Environment Exists

If your program has an active Test Environment, it is recommended that you upgrade your templates to Smart Templates in the Test Environment. When you commit the Test Environment, the upgraded templates will be transferred to your production program. You do not need to upgrade every template in the Test Environment in order to commit it. If you expect to keep your Test Environment active for a long time, you can upgrade your templates in your production program, but you will need to repeat the same upgrades in the Test Environment before committing it.

 

Broken Template Tags

In most cases, your templates can be upgraded automatically with no manual intervention once you initiate the upgrade. However, during the upgrade process, PowerClerk may detect broken template tags. Any tags detected in this way are currently being ignored by PowerClerk when using the template, so this will alert you to existing errors in your templates. A tag can be identified as broken for any of the following reasons:

  1. Invalid Tags:
    • The tag contains a typo and PowerClerk cannot read it.
    • This may arise if there is a typo in the prefix of a template tag (ie. before the “:”), or if there is another typo or formatting error.
    • This can also arise in Communication Templates if there is HTML formatting applied to a portion of the tag but not the entire thing.
  2. Tags whose Reference cannot be found:
    • The tag attempts to reference a field or group that does not exist.
    • This situation may arise from a typo in the field name.
    • It may also arise if the field was renamed after the template was created.
  3. Tags whose Reference is archived:
    • The tag attempts to reference a field that has been archived.


You will need to manually correct any errors in a template to finish upgrading it. Once all the errors have been corrected, PowerClerk will automatically upgrade the template to a Smart Template.
 

Examples of Broken Tags
  1. {data: Customer Naame First}:
    • Assume a field called “Customer Name First” exists.
    • This template tag is broken because it contains a simple typo in the name of the Data Field it is trying to reference.
    • This can be resolved by fixing the typo in the field name
  2. {data: Payment Amt}:
    • This tag does not contain an obvious typo, but it may still be invalid if there is no field named “Payment Amt.” This could arise if the field has been renamed or archived. For example, perhaps a designer later renamed the field “Payment Amount.”
    • This can be resolved by ensuring the tag text matches the current field name or unarchiving the “Payment Amt” field if applicable.
  3. {Project Number}:
    • This is a template tag for the built-in ProjectNumber field, but it contains a subtle typo. The correct tag is {ProjectNumber} (no space). You can view all supported template tags for built-in fields in the Built-In Fields Tab of the Data Field List Page.
    • This can be resolved by fixing the typo (removing the space).
  4. {fullname: Customer}:
    • Assume a contact Data Field Group called “Customer” exists.
    • This tag is invalid because of a typo in the tag prefix. The correct prefix is “full_name” (underscore, not hyphen), so the correct tag is {full_name: Customer}.
    • This can be resolved by correcting the typo in the tag prefix.
  5. {{data: <b>Applicant Email</b>}:
    • Assume a field called “Applicant Email” exists.
    • This may arise in Communication Templates due to HTML formatting interfering with PowerClerk’s ability to read a template. This is tricky to understand because it may appear correct when the template is inspected visually. The issue is that the <b> pieces are invisible when the template is viewed in the browser because they convey the information that the text “Applicant Email” appears in bold. In this case, the tag will appear as the following to the user: {data: Applicant Email}. However, when PowerClerk processes the template, the <b> text gets in the way of finding the correct “Applicant Email” field. This kind of error may look different depending on the specific text formatting in the template, but any case where you see text enclosed in angle brackets (“<”, “>”) showing up in the template errors but not visible in the template is probably an example of this.
    • This can be resolved by clearing existing text formatting from the template tags in your Communication Template and ensuring that any formatting applies to the entire tag, including the outer brackets.

To remedy Template Tag formatting errors, there are several ways to alleviate these issues:

  1. With the whole tag selected, click the “Clear formatting” button as sometimes tag formatting is completely invisible to the viewer:
     

    Clear Formatting

    Figure 8: Clear Formatting

     

  2. Alternatively, delete the tag and re-type it from scratch. That will also remove any invisible formatting.


 

 
 

PowerClerk Mass Communication Policy

Purpose

This policy aims to provide clear guidelines for mass communications within PowerClerk services. It defines the difference between spam/marketing emails and transactional emails, ensuring compliance with CAN-SPAM Act (United States) and CASL (Canada) regulations, and email service provider requirements.
 
Communications are no longer permitted to be triggered via the legacy Bulk Communications request. PowerClerk now has an Announcements feature; announcements are a type of email communication to be sent to many recipients in a mass communication event falling outside of the normal project workflow.
 
Learn more about the new Announcements feature by clicking here.

 

Definitions

Transactional Emails: These are messages directly related to a transaction or an existing business relationship. Transactional messages contain content that:

  • Facilitates, completes, or confirms a commercial transaction that the recipient already has agreed to;
  • Gives warranty, recall, safety, or security information about a product or service the recipient bought;
  • Notifies the recipient about a change in the terms or features of a membership, subscription, account, loan or other ongoing commercial relationship; notifies the recipient of a change in their standing with respect to that ongoing commercial relationship; or provides regular, periodic account balance information to the recipient;
  • Delivers goods or services as part of a transaction that the recipient already has agreed to.

Spam/Marketing Emails: These are promotional messages sent to recipients with the primary purpose of advertising or promoting a commercial product or service. They are not transaction-related.
 

Guidelines

PowerClerk is a workflow automation software solution that helps utilities manage their energy programs. It offers a wide range of features and support for handling utility transactions efficiently. Sending spam/marketing emails through PowerClerk is not permitted. Some transactional emails, (i.e. those sent via our announcements feature), may be interpreted as marketing emails by email service providers. To protect our customers’ as well as our own sending reputations, PowerClerk will apply format and functional controls to these emails that ensure functional compliance with email services. The content of all messages should remain transactional in nature.
 

1. Spam Marketing Emails

Sending Spam/Marketing emails, as defined in this document, through PowerClerk is strictly disallowed. The following list provides further examples and characteristics of Spam/Marketing Emails. This is not an exhaustive list of examples nor characteristics.
 
Examples of spam/marketing emails:

    Promotional Emails Focused on:

  1. Promoting program enrollment and/or rebate opportunities
  2. Promoting utility products or marketplaces via email
  3. Promoting utility services and/or events.
2. Transactional Emails

PowerClerk permits the sending of Transactional Emails, as defined in this document.
 
The following list provides further examples and characteristics of Transactional Emails. This is not an exhaustive list of examples or characteristics:

    Examples of Transactional Emails:

  • Application confirmation and follow-up requests
  • Service confirmations or delays
  • Password reset notifications
  • Account statements and billing transaction notifications
3. Mass Communication Emails

Clean Power Research permits the sending of announcements via PowerClerk, so long as they meet the definition of Transactional Emails, as defined in this document.
 
Although Transactional Emails are exempt from email service provider requirements for mass marketing emails, emails sent via PowerClerk’s announcements feature could increase the risk of these emails being treated as mass marketing emails. To reduce the risk of these emails being treated as spam PowerClerk will add additional unsubscribe links to these emails, including a “one click” unsubscribe.
 
Please, note that Clean Power Research reserves the right to remove access to PowerClerk’s announcement mail feature to any customer using it to send spam/marketing emails or as necessary to protect PowerClerk’s ability to reliably deliver email and maintain a positive sender reputation.
 

4. Prerequisites for Using Announcements

In order for customers to send emails using the Announcements feature, the following requirements must be met:
 
For self-service access to this feature, utilities must use their own sending domain. For assistance with this, please reach out to support@powerclerk.com.
 
To trigger an Announcement, the user account processing the data import must have Multi Factor Authentication (MFA) enabled or authenticated via Single Sign On (SSO).

Video Guides

Would a video guide help to better explain Communications? Contact us and let us know.
 
A full list of all Video Guides can also be found here.

FAQs

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.